Package org.eclipse.sisu.osgi
Class ServiceBindings
- java.lang.Object
-
- org.eclipse.sisu.osgi.ServiceBindings
-
- All Implemented Interfaces:
BindingPublisher
public final class ServiceBindings extends java.lang.Object implements BindingPublisher
On-demand publisher ofBinding
s from the OSGi service registry.
-
-
Constructor Summary
Constructors Constructor Description ServiceBindings(org.osgi.framework.BundleContext context)
Creates new publisher of service bindings, using the given OSGiBundleContext
to track services.
Uses default allow/ignore settings and assigns any published services the lowest possible ranking.ServiceBindings(org.osgi.framework.BundleContext context, java.lang.String allow, java.lang.String ignore, int maxRank)
Creates new publisher of service bindings, using the given OSGiBundleContext
to track services.
The globbed patterns control whether tracking requests for particular types are allowed or ignored.
Any published bindings are ranked according to their service ranking (up to the given maximum).
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description <T> T
adapt(java.lang.Class<T> type)
Attempts to adapt this publisher to the given type.static java.lang.String
defaultAllow()
Configured byorg.eclipse.sisu.osgi.ServiceBindings.allow
system property.static java.lang.String
defaultIgnore()
Configured byorg.eclipse.sisu.osgi.ServiceBindings.ignore
system property.int
maxBindingRank()
Estimates the maximum rank this publisher may assign to aBinding
.<T> void
subscribe(BindingSubscriber<T> subscriber)
Subscribes the givenBindingSubscriber
to receiveBinding
s.<T> void
unsubscribe(BindingSubscriber<T> subscriber)
Stops the givenBindingSubscriber
from receivingBinding
s.
-
-
-
Constructor Detail
-
ServiceBindings
public ServiceBindings(org.osgi.framework.BundleContext context, java.lang.String allow, java.lang.String ignore, int maxRank)
Creates new publisher of service bindings, using the given OSGiBundleContext
to track services.
The globbed patterns control whether tracking requests for particular types are allowed or ignored.
Any published bindings are ranked according to their service ranking (up to the given maximum).- Parameters:
context
- The tracking contextallow
- Globbed pattern of packages/types to allowignore
- Globbed pattern of packages/types to ignoremaxRank
- Maximum binding rank
-
ServiceBindings
public ServiceBindings(org.osgi.framework.BundleContext context)
Creates new publisher of service bindings, using the given OSGiBundleContext
to track services.
Uses default allow/ignore settings and assigns any published services the lowest possible ranking.- Parameters:
context
- The tracking context
-
-
Method Detail
-
defaultAllow
public static java.lang.String defaultAllow()
Configured byorg.eclipse.sisu.osgi.ServiceBindings.allow
system property.- Returns:
- Globbed pattern of types to allow
-
defaultIgnore
public static java.lang.String defaultIgnore()
Configured byorg.eclipse.sisu.osgi.ServiceBindings.ignore
system property.- Returns:
- Globbed pattern of types to ignore
-
subscribe
public <T> void subscribe(BindingSubscriber<T> subscriber)
Description copied from interface:BindingPublisher
Subscribes the givenBindingSubscriber
to receiveBinding
s.- Specified by:
subscribe
in interfaceBindingPublisher
- Parameters:
subscriber
- The subscriber
-
unsubscribe
public <T> void unsubscribe(BindingSubscriber<T> subscriber)
Description copied from interface:BindingPublisher
Stops the givenBindingSubscriber
from receivingBinding
s.- Specified by:
unsubscribe
in interfaceBindingPublisher
- Parameters:
subscriber
- The subscriber
-
maxBindingRank
public int maxBindingRank()
Description copied from interface:BindingPublisher
Estimates the maximum rank this publisher may assign to aBinding
.- Specified by:
maxBindingRank
in interfaceBindingPublisher
- Returns:
- Maximum binding rank
-
adapt
public <T> T adapt(java.lang.Class<T> type)
Description copied from interface:BindingPublisher
Attempts to adapt this publisher to the given type.- Specified by:
adapt
in interfaceBindingPublisher
- Parameters:
type
- The target type- Returns:
- Adapted instance;
null
if it couldn't be adapted
-
-