org.glassfish.hk2.api

Interface ServiceHandle<T>

Type Parameters:

T - The type of the service that can be returned

public interface ServiceHandle<T>

This service handle can be used to get a specific instance of a service, and can be used to destroy that service as well

Author:

jwells

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Will destroy this object and all PerLookup instances created because of this service
ActiveDescriptor<T>	getActiveDescriptor() Returns the ActiveDescriptor associated with this service handle
T	getService() Gets the underlying service object
Object	getServiceData() Service data can be set on a service handle.
boolean	isActive() This returns true if the underlying service has already been created
void	setServiceData(Object serviceData) Service data can be set on a service handle.

Method Detail

getService

T getService()

Gets the underlying service object

Returns:

May return null (if the backing ActiveDescriptor returned null)

Throws:

MultiException - if there was an error creating the service

IllegalStateException - if the handle was previously destroyed

getActiveDescriptor

ActiveDescriptor<T> getActiveDescriptor()

Returns the ActiveDescriptor associated with this service handle

Returns:

The ActiveDescriptor associated with this handle

isActive

boolean isActive()

This returns true if the underlying service has already been created

Returns:

true if the underlying service has been created

destroy

void destroy()

Will destroy this object and all PerLookup instances created because of this service

setServiceData

void setServiceData(Object serviceData)

Service data can be set on a service handle. If the service data is set prior to the services associated Context has created an instance then this service data can be used to influence the context's creation of the service. The service data is associated with a handle, not with the service itself

Parameters:

serviceData - Sets the serviceData for the handle (may be null)

getServiceData

Object getServiceData()

Service data can be set on a service handle. If the service data is set prior to the services associated Context has created an instance then this service data can be used to influence the context's creation of the service. The service data is associated with a handle, not with the service itself

Returns:

The service data for this service handle (may return null)