org.jboss.gravia.runtime

Interface ServiceRegistration<T>

Type Parameters:

T - Type of Service.

public interface ServiceRegistration<T>

A registered service.

The Runtime returns a ServiceRegistration object when a ModuleContext.registerService method invocation is successful. The ServiceRegistration object is for the private use of the registering module and should not be shared with other modules.

The ServiceRegistration object may be used to update the properties of the service or to unregister the service.

Since:

27-Sep-2013

Author:

thomas.diesler@jboss.com

See Also:

ModuleContext.registerService(String[],Object,Dictionary)

Thread Safety: Thread Safe

Method Summary

Methods

Modifier and Type	Method and Description
ServiceReference<T>	getReference() Returns a ServiceReference object for a service being registered.
void	setProperties(Dictionary<String,?> properties) Updates the properties associated with a service.
void	unregister() Unregisters a service.

Method Detail

getReference

ServiceReference<T> getReference()

Returns a ServiceReference object for a service being registered.

The ServiceReference object may be shared with other modules.

Returns:

ServiceReference object.

Throws:

IllegalStateException - If this ServiceRegistration object has already been unregistered.

setProperties

void setProperties(Dictionary<String,?> properties)

Updates the properties associated with a service.

The Constants.OBJECTCLASS and Constants.SERVICE_ID keys cannot be modified by this method. These values are set by the Runtime when the service is registered.

The following steps are required to modify service properties:

1. The service's properties are replaced with the provided properties.
2. A service event of type ServiceEvent.MODIFIED is fired.

Parameters:

properties - The properties for this service. See Constants for a list of standard service property keys. Changes should not be made to this object after calling this method. To update the service's properties this method should be called again.

Throws:

IllegalStateException - If this ServiceRegistration object has already been unregistered.

IllegalArgumentException - If properties contains case variants of the same key name.

unregister

void unregister()

Unregisters a service. Remove a ServiceRegistration object from the Runtime service registry. All ServiceReference objects associated with this ServiceRegistration object can no longer be used to interact with the service once unregistration is complete.

The following steps are required to unregister a service:

1. The service is removed from the Runtime service registry so that it can no longer be obtained.
2. A service event of type ServiceEvent.UNREGISTERING is fired so that modules using this service can release their use of the service. Once delivery of the service event is complete, the ServiceReference objects for the service may no longer be used to get a service object for the service.
3. For each module whose use count for this service is greater than zero:
   The module's use count for this service is set to zero.
   If the service was registered with a ServiceFactory object, the ServiceFactory.ungetService method is called to release the service object for the module.

Throws:

IllegalStateException - If this ServiceRegistration object has already been unregistered.

See Also:

ModuleContext.ungetService(ServiceReference), ServiceFactory.ungetService(Module, ServiceRegistration, Object)