使用 Blueprint Container 规范构建 OSGi 应用程序

服务引用管理器

服务引用管理器提供了对 OSGi 服务注册表中已注册服务的访问。Blueprint 规范定义了两种服务引用管理器：引用（reference）和引用列表（reference list）管理器。

引用管理器

引用管理器提供了一个对象，该对象充当在服务注册表中注册了的实际服务的代理。代理允许被注入的对象保持不变，同时后端服务可以变化或被其他服务取代。对不具备后端服务的代理的调用将被阻塞，直到服务变得可用或发生超时。

引用管理器由 reference 元素定义。代理用于等待后端服务变为可用的时间的长度将由 timeout 属性指定。如果 timeout 属性没有被指定，那么默认的超时值为 5 分钟。也可以为 Blueprint XML 文件中的所有引用管理器修改默认超时，只需要修改 blueprint 元素的 default-timeout 属性。所有超时值都以毫秒为单位指定；值为 0 则表示无限期超时。

清单 7 展示了一个简单的引用管理器示例。服务代理将拥有一个 30 秒的超时。

清单 7. 引用管理器示例
　　<reference　id=”serviceReferenceOne”　
　　　　　　　interface=”java.io.Serializable”　
　　　　　　　timeout=”30000”/>　　　　

引用列表管理器

引用列表管理器提供了一个 List 对象，其中包含服务代理对象或 ServiceReference 对象，具体取决于成员类型设置。提供的 List 对象是动态的，因为随着匹配服务被添加到服务注册表或从中移除，该对象可以增加或缩小。List 对象是只读的并且只支持一部分 List API。

引用列表管理器中的代理不同于引用管理器中的代理。它们使用固定的后端服务，不存在超时，并且如果后端服务变得不可用，将立即抛出 ServiceUnavailableException。