org.eclipse.sisu.osgi

Class ServiceBindings

java.lang.Object

org.eclipse.sisu.osgi.ServiceBindings

All Implemented Interfaces:

BindingPublisher

public final class ServiceBindings
extends Object
implements BindingPublisher

On-demand publisher of Bindings from the OSGi service registry.

Constructor Summary

Constructors

Constructor and Description
ServiceBindings(org.osgi.framework.BundleContext context) Creates new publisher of service bindings, using the given OSGi BundleContext to track services. Uses default allow/ignore settings and assigns any published services the lowest possible ranking.
ServiceBindings(org.osgi.framework.BundleContext context, String allow, String ignore, int maxRank) Creates new publisher of service bindings, using the given OSGi BundleContext 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

Methods

Modifier and Type	Method and Description
static String	defaultAllow()
static String	defaultIgnore()
int	maxBindingRank() Estimates the maximum rank this publisher may assign to a Binding.
<T> void	subscribe(BindingSubscriber<T> subscriber) Subscribes the given BindingSubscriber to receive Bindings.
<T> void	unsubscribe(BindingSubscriber<T> subscriber) Stops the given BindingSubscriber from receiving Bindings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceBindings

public ServiceBindings(org.osgi.framework.BundleContext context,
               String allow,
               String ignore,
               int maxRank)

Creates new publisher of service bindings, using the given OSGi BundleContext 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 context

allow - Globbed pattern of packages/types to allow

ignore - Globbed pattern of packages/types to ignore

maxRank - Maximum binding rank

ServiceBindings

public ServiceBindings(org.osgi.framework.BundleContext context)

Creates new publisher of service bindings, using the given OSGi BundleContext 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 String defaultAllow()

Returns:

Globbed pattern of types to allow

See Also:

org.eclipse.sisu.osgi.ServiceBindings.allow} system property

defaultIgnore

public static String defaultIgnore()

Returns:

Globbed pattern of types to ignore

See Also:

org.eclipse.sisu.osgi.ServiceBindings.ignore} system property

subscribe

public <T> void subscribe(BindingSubscriber<T> subscriber)

Description copied from interface: BindingPublisher

Subscribes the given BindingSubscriber to receive Bindings.

Specified by:

subscribe in interface BindingPublisher

Parameters:

subscriber - The subscriber

unsubscribe

public <T> void unsubscribe(BindingSubscriber<T> subscriber)

Description copied from interface: BindingPublisher

Stops the given BindingSubscriber from receiving Bindings.

Specified by:

unsubscribe in interface BindingPublisher

Parameters:

subscriber - The subscriber

maxBindingRank

public int maxBindingRank()

Description copied from interface: BindingPublisher

Estimates the maximum rank this publisher may assign to a Binding.

Specified by:

maxBindingRank in interface BindingPublisher

Returns:

Maximum binding rank