org.osgi.service.cdi.reference

Interface BindServiceReference<S>

Type Parameters:

S - the service argument type.

@ProviderType
public interface BindServiceReference<S>

A bean provided by CCR for binding actions to life cycle events of matching services.

See Also:

Reference

Method Summary

Modifier and Type	Method and Description
BindServiceReference<S>	adding(BiConsumer<ServiceReference<S>,S> action) Subscribe an action to the adding service event.
BindServiceReference<S>	adding(Consumer<ServiceReference<S>> action) Subscribe an action to the adding service event.
void	bind() The bind terminal operation is required to instruct CCR that all the bind actions have been specified, otherwise bind actions will never be called by CCR.
BindServiceReference<S>	modified(BiConsumer<ServiceReference<S>,S> action) Subscribe an action to the modified service event.
BindServiceReference<S>	modified(Consumer<ServiceReference<S>> action) Subscribe an action to the modified service event.
BindServiceReference<S>	removed(BiConsumer<ServiceReference<S>,S> action) Subscribe an action to the removed service event.
BindServiceReference<S>	removed(Consumer<ServiceReference<S>> action) Subscribe an action to the removed service event.

Method Detail

adding

BindServiceReference<S> adding(Consumer<ServiceReference<S>> action)

Subscribe an action to the adding service event.

Only the last adding action is used.

Parameters:

action - the action, whose argument is the service reference, to subscribe to the adding service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

adding

BindServiceReference<S> adding(BiConsumer<ServiceReference<S>,S> action)

Subscribe an action to the adding service event.

Only the last adding action is used.

Parameters:

action - the action, whose arguments are the service reference and the service object, to subscribe to the adding service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

modified

BindServiceReference<S> modified(Consumer<ServiceReference<S>> action)

Subscribe an action to the modified service event.

Only the last modified action is used.

Parameters:

action - the action, whose argument is the service reference, to subscribe to the modified service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

modified

BindServiceReference<S> modified(BiConsumer<ServiceReference<S>,S> action)

Subscribe an action to the modified service event.

Only the last modified action is used.

Parameters:

action - the action, whose arguments are the service reference and the service object, to subscribe to the modified service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

removed

BindServiceReference<S> removed(Consumer<ServiceReference<S>> action)

Subscribe an action to the removed service event.

Only the last removed action is used.

Parameters:

action - the action, whose argument is the service reference, to subscribe to the removed service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

removed

BindServiceReference<S> removed(BiConsumer<ServiceReference<S>,S> action)

Subscribe an action to the removed service event.

Only the last removed action is used.

Parameters:

action - the action, whose arguments are the service reference and the service object, to subscribe to the removed service event

Returns:

self

Throws:

IllegalStateException - when called after bind()

bind

void bind()

The bind terminal operation is required to instruct CCR that all the bind actions have been specified, otherwise bind actions will never be called by CCR.

Calling bind() again has no effect.