spring dm
OSGi Service Registery你知多少
http://www.cnblogs.com/ygyinx/archive/2012/10/27/2742347.html
1. 发布服务可以关联一些属性。
<service ref="beanToBeExported" interface="com.xyz.MyServiceInterface">
<service-properties>
<beans:entry key="myOtherKey" value="aStringValue"/>
<beans:entry key="aThirdKey" value-ref="beanToExposeAsProperty"/>
</service-properties>
</service>2. 每个以Spring Bean发布成服务都会有一个属性名为org.springframework.osgi.bean.name，对应的值为目标Bean的name。
<service ref="beanToPublish" interface="com.xyz.MessageService"/>
这个服务就会有一个属性org.springframework.osgi.bean.name，值为beanToPublish。
3. Spring DM引入一种Bean的作用域，叫bundle scope。当导出服务的Bean加了这个作用域后，导入这个服务的Bundle会创建一个新的服务Bean实例。
<service ref="beanToBeExported" interface="com.xyz.MessageService"/> <bean id="beanToBeExported" scope="bundle" class="com.xyz.MessageServiceImpl"/>
4. Controlling The Set Of Advertised Service Interfaces For An Exported Service.
当有一个Bean服务存在多个接口时，需要将接口都导出：
<service ref="beanToBeExported"> <interfaces> <value>com.xyz.MessageService</value> <value>com.xyz.MarkerInterface</value> </interfaces> </osgi:service> or <service ref="beanToBeExported" auto-export="interfaces"/>
auto-export有四种值:
disabled :如果 auto-export 属性未被指定，则该选项为默认值。接口列表必须使用interface 属性或 interfaces 子元素指定。
interfaces :使用由服务类或其任何超类实现的所有公共接口注册服务。
class-hierarchy :使用服务类或其任何公共超类注册服务。
all-classes :结合 interfaces 和 class-hierarchy 选项。
注册服务的一些属性：
depends-on :
<service ref="beanToBeExported" interface="com.xyz.MyServiceInterface" depends-on="myOtherComponent"/>
配置beanToBeExported服务所依赖的组件myOtherComponent初始化。
context-class-loader :
用于配置使用第三方的classloader来加载服务。
ranking :
默放为0，如果存在多个可用的服务接口，那么返回具有最大的ranking值的服务。如果ranking值相同，刚返回service id小的那个。
<service ref="beanToBeExported" interface="com.xyz.MyServiceInterface" ranking="9"/>
5. 多接口服务引用
<reference id="importedOsgiService"> <interfaces> <value>com.xyz.MessageService</value> <value>com.xyz.MarkerInterface</value> </interfaces> </reference>
这个reference的Bean是实现了MessageService，MarkerInterface接口的。
引用服务的一些属性
filter属性
<reference id="asyncMessageService" interface="com.xyz.MessageService" filter="(asynchronous-delivery=true)"/>
过滤服务属性asynchronous-delivery为true的服务。
bean-name属性
<osgi:reference id="messageService" interface="com.xyz.MessageService" bean-name="messageServiceBean"/>
返回服务Bean的Id为messageServiceBean的服务。
cardinality属性
<osgi:reference id="messageService" interface="com.xyz.MessageService" cardinality="1..1"/>
默认值为1..1，说明总是有一个这样的服务存在。0..1说明不需要一直存在这样一个服务。
depends-on:
当depends-on属性Bean实例化后，这个服务才能查找该服务。
context-class-loader:
与上对应。如果两边都有，最后启作用的是exporter那端的。
timeout：
等待服务多少秒，默认300秒。
List，set引用服务支持属性
interface filter bean-name cardinality context-class-loader
cardinality取值为0..N，1..N，前面说明可以不存在，后面说明至少存在一个。
注意： 当一个Bundle暴露SubInterface接口服务，而另一个Bundle引入SuperInterface接口是不匹配的。
当注册的服务中有接口，类等，能通过greedy-proxying创建代理访问导入服务中的的所有包含在该Bundle中类。
<list id="services" interface="com.xyz.SomeService" greedy-proxying="true"/>
for (Iterator iterator = services.iterator(); iterator.hasNext();) {
SomeService service = (SomeService) iterator.next();
service.executeOperation();
// if the service implements an additional type
// do something extra
if (service instanceof MessageDispatcher) {
((MessageDispatcher)service).sendAckMessage();
}
}6. 服务监听Service Listener：
<service ref="beanToBeExported" interface="SomeInterface">
<registration-listener ref="myListener" registration-method="serviceRegistered" unregistration-method="serviceUnregistered"/>
<registration-listener registration-method="register">
<bean class="SomeListenerClass"/>
</registration-listener>
</service>
public void anyMethodName(ServiceType serviceInstance, Map serviceProperties);
public void anyMethodName(ServiceType serviceInstance, Dictionary serviceProperties);ServiceType为服务接口interface，serviceProperties保存着这个服务的所有属性，兼容性考虑的话，可以选Dictionary。
有另一种方法，不鼓励这样用，那就是实现Spring DM特定接口OsgiServiceRegistrationListener，这样做的好处是省去了声明registration-method，unregistration-method，坏处是你的类与Spring有引用关系，与JAVA简单POJO类编程。
Dealing With The Dynamics Of OSGi Imported Services
An example of declaring a listener that implements OsgiServiceLifecycleListener:
<reference id="someService" interface="com.xyz.MessageService">
<listener ref="aListenerBean"/>
</reference>An example of declaring an inline listener bean with custom bind and unbind methods:
<reference id="someService" interface="com.xyz.MessageService">
<listener bind-method="onBind" unbind-method="onUnbind">
<beans:bean class="MyCustomListener"/>
</listener>
</reference>Listener Attributes：
ref bind-method unbind-mehtod
Listener And Service Proxies:
Spring管理这个服务，但是调用这个服务的时候实质是一个代理。这样做的原因是防止Listener持有一个服务的强引用。Lisenter感兴趣的是监听服务而不是依赖对等实例，更加关注服务接口，而不是他的身份，服务属性和服务跟踪。
7. 服务引用可以排序
<set id="myServices" interface="com.xyz.MyService" comparator-ref="someComparator"/>
<list id="myOtherServices" interface="com.xyz.OtherService">
<comparator>
<beans:bean class="MyOtherServiceComparator"/>
</comparator>
</list>Comparator-ref是一个实现了java.util.Comparator接口的Bean。
<list id="myServices" interface="com.xyz.MyService"> <comparator><natural basis="services"/></comparator> </list> <set id="myOtherServices"interface="com.xyz.OtherService"> <comparator><natural basis="service-references"/></comparator> </set>
默认提供的一些排序，详细可以去了解下。
服务最佳实践
1. 在listener中不要执行太长的活动，因为这个方法是同步的，太长将会影响这个listener监听其他事件。
2. 创建自己的listener，不要引用Spring DM 的API。
3. 如果listener重复声明bind/unbind方法，可以考虑写一个通用的可重用的Bean。
4. 服务属性优先java.util.Map而不是java.util.Dictionary。
5. 重载方法要小心，因为当服务类型匹配方法服务类型的时候，该方法就会执行
public class MyListener {
void register(Object service, Map properties);
void register(Collection dataService, Map properties);
void register(SortedSet orderedDataService , Map properties);
}Object type - will match all services for which the listener is triggered. This method will be always called.
Collection type - if this method is called, the Object method is also called.
SortedSet type - if this method is called, then both the Object and Collection methods are called.
Service Importer Global Defaults
default-timeout
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:osgi="http://www.springframework.org/schema/osgi"
osgi:default-timeout="5000">
<reference id="someService" interface="com.xyz.AService"/>
<reference id="someOtherService" interface="com.xyz.BService" timeout="1000"/>
</beans:beans>
default-cardinality
<beans:beans
xmlns="http://www.springframework.org/schema/osgi"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:osgi="http://www.springframework.org/schema/osgi"
osgi:default-cardinality="0..X"
default-lazy-init="false">
<reference id="someService" interface="com.xyz.AService"/>
<set id="someSetOfService" interface="com.xyz.BService"/>
<list id="anotherListOfServices" interface="com.xyz.CService" cardinality="1..N"/>
</beans:beans>