org.osgi.service.cdi.reference

Interface BeanServiceObjects<S>

Type Parameters:

S - Type of Service

@ProviderType
public interface BeanServiceObjects<S>

Allows multiple service objects for a service to be obtained.

A component instance can receive a BeanServiceObjects object via a reference that is typed BeanServiceObjects.

For services with prototype scope, multiple service objects for the service can be obtained. For services with singleton or bundle scope, only one, use-counted service object is available.

Any unreleased service objects obtained from this BeanServiceObjects object are automatically released by Service Component Runtime when the service becomes unbound.

See Also:

ServiceObjects

"ThreadSafe"

Method Summary

Modifier and Type	Method and Description
S	getService() Returns a service object for the associated service.
ServiceReference<S>	getServiceReference() Returns the ServiceReference for the service associated with this BeanServiceObjects object.
void	ungetService(S service) Releases a service object for the associated service.

Method Detail

getService

S getService()

Returns a service object for the associated service.

This method will always return null when the associated service has been become unbound.

Returns:

A service object for the associated service or null if the service is unbound, the customized service object returned by a ServiceFactory does not implement the classes under which it was registered or the ServiceFactory threw an exception.

Throws:

java.lang.IllegalStateException - If the component instance that received this BeanServiceObjects object has been deactivated.

See Also:

ungetService(Object)

ungetService

void ungetService(S service)

Releases a service object for the associated service.

The specified service object must no longer be used and all references to it should be destroyed after calling this method.

Parameters:

service - A service object previously provided by this ReferenceServiceObjects object.

Throws:

java.lang.IllegalStateException - If the component instance that received this ReferenceServiceObjects object has been deactivated.

java.lang.IllegalArgumentException - If the specified service object was not provided by this BeanServiceObjects object.

See Also:

getService()

getServiceReference

ServiceReference<S> getServiceReference()

Returns the ServiceReference for the service associated with this BeanServiceObjects object.

Returns:

The ServiceReference for the service associated with this BeanServiceObjects object.