Package 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.

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	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

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

GLOB_SYNTAX

private static final Pattern GLOB_SYNTAX

trackers

private final ConcurrentMap<String,BindingTracker<?>> trackers

context

private final org.osgi.framework.BundleContext context

allowed

private final Pattern[] allowed

ignored

private final Pattern[] ignored

maxRank

private final int maxRank

Constructor Details

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 Details

defaultAllow

public static String defaultAllow()

Returns:

Globbed pattern of types to allow

defaultIgnore

public static String defaultIgnore()

Returns:

Globbed pattern of types to ignore

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(String clazzName)

parseGlobs

private static Pattern[] parseGlobs(String globs)