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 of Bindings from the OSGi service registry.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.regex.Pattern[]	allowed
private org.osgi.framework.BundleContext	context
private static java.util.regex.Pattern	GLOB_SYNTAX
private java.util.regex.Pattern[]	ignored
private int	maxRank
private java.util.concurrent.ConcurrentMap<java.lang.String,BindingTracker<?>>	trackers

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, java.lang.String allow, java.lang.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

Modifier and Type	Method and Description
static java.lang.String	defaultAllow()
static java.lang.String	defaultIgnore()
int	maxBindingRank() Estimates the maximum rank this publisher may assign to a Binding.
private static java.util.regex.Pattern[]	parseGlobs(java.lang.String globs)
private boolean	shouldTrack(java.lang.String clazzName)
<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

Field Detail

GLOB_SYNTAX

private static final java.util.regex.Pattern GLOB_SYNTAX

trackers

private final java.util.concurrent.ConcurrentMap<java.lang.String,BindingTracker<?>> trackers

context

private final org.osgi.framework.BundleContext context

allowed

private final java.util.regex.Pattern[] allowed

ignored

private final java.util.regex.Pattern[] ignored

maxRank

private final int maxRank

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 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 java.lang.String defaultAllow()

Returns:

Globbed pattern of types to allow

See Also:

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

defaultIgnore

public static java.lang.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

shouldTrack

private boolean shouldTrack(java.lang.String clazzName)

parseGlobs

private static java.util.regex.Pattern[] parseGlobs(java.lang.String globs)