com.sun.hk2.component
Class EventPublishingInhabitant<T>

java.lang.Object
  com.sun.hk2.component.AbstractInhabitantImpl<T>
      com.sun.hk2.component.EventPublishingInhabitant<T>

All Implemented Interfaces:

Holder<T>, Binding<T>, Factory<T>, ManagedComponentProvider<T>, Provider<T>, Inhabitant<T>

Direct Known Subclasses:

LazyInhabitant, RunLevelInhabitant

public class EventPublishingInhabitant<T>
extends AbstractInhabitantImpl<T>

An inhabitant that implements InhabitantEventPublisher, and maintains a list of listeners to notify for interesting changes of the underlying delegate.

Author:

Jeff Trent

Nested Class Summary

Nested classes/interfaces inherited from interface com.sun.hk2.component.Holder

Holder.Impl<T>

Field Summary

protected Inhabitant<T>

real Real Inhabitant object.

Fields inherited from class com.sun.hk2.component.AbstractInhabitantImpl

descriptor, logger

Constructor Summary

EventPublishingInhabitant(Descriptor descriptor)

EventPublishingInhabitant(Inhabitant<?> delegate)

EventPublishingInhabitant(Inhabitant<?> delegate, InhabitantListener listener)

Method Summary

void	addInhabitantListener(InhabitantListener listener)
protected void	fetch()
T	get(Inhabitant onBehalfOf) Returns the instance of this inhabitant.
boolean	isActive()
MultiMap<String,String>	metadata() Gets the metadata associated with this inhabitant.
protected void	notify(InhabitantListener.EventType eventType)
void	release() Called to orderly shutdown Habitat.
boolean	removeInhabitantListener(InhabitantListener listener)
String	toString()
Class<? extends T>	type() Type of the inhabitant.
String	typeName() The short-cut for type().getName() but this allows us to defer loading the actual types.

Methods inherited from class com.sun.hk2.component.AbstractInhabitantImpl

companions, dispose, get, getAnnotation, getAnnotation, getAnnotations, getDescriptor, getDescriptorFor, getProvider, getProvider, getSerializedMetadata, getSerializedMetadata, lead, matches, setCompanions

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

real

protected volatile Inhabitant<T> real

Real Inhabitant object.

Constructor Detail

EventPublishingInhabitant

public EventPublishingInhabitant(Descriptor descriptor)

EventPublishingInhabitant

public EventPublishingInhabitant(Inhabitant<?> delegate)

EventPublishingInhabitant

public EventPublishingInhabitant(Inhabitant<?> delegate,
                                 InhabitantListener listener)

Method Detail

toString

public String toString()

Overrides:

toString in class AbstractInhabitantImpl<T>

typeName

public String typeName()

Description copied from interface: Inhabitant

The short-cut for type().getName() but this allows us to defer loading the actual types.

metadata

public MultiMap<String,String> metadata()

Description copied from interface: Inhabitant

Gets the metadata associated with this inhabitant.

This data is usually used by a sub-system of HK2, and not really meant to be used by applications. (At least for now.) The main benefit of metadata is that it's available right away as soon as the Habitat is properly initialized, even before component classes are loaded. In contrast, accessing annotations would require classes to be loaded and resolved.

Returns:

can be empty but never null. The values are read-only.

See Also:

Service.metadata()

release

public void release()

Description copied from interface: Inhabitant

Called to orderly shutdown Habitat.

The expected behavior is for objects to get its PreDestroy callback invoked, and its reference released. For singleton objects, this method is expected to dispose that object.

For scoped objects, those are released when ScopeInstance.release() is invoked.

isActive

public boolean isActive()

type

public Class<? extends T> type()

Description copied from interface: Inhabitant

Type of the inhabitant.

The only binding contract that needs to be honored is that the Inhabitant.get() method returns an instance assignable to this type. That is, get().getClass()==type() doesn't necessarily have to hold, but type().isInstance(get()) must.

This is particularly true when Factory is involved, as in such case HK2 has no way of knowing the actual type. That said, this method is not designed for the semantics of contract/implementation split --- implementations of a contract should return the concrete type from this method, and use habitat index to support look-up by contract.

Returns:

Always non-null, same value.

get

public T get(Inhabitant onBehalfOf)

Description copied from interface: Inhabitant

Returns the instance of this inhabitant.

THIS METHOD SHOULD BE ONLY USED BY HK2 IMPLEMENTATION.

Inhabitants are often used with the decorator pattern (see AbstractCreatorInhabitantImpl for example), yet during the object initializtion inside the Inhabitant.get() method, we often need the reference to the outer-most Inhabitant registered to the Habitat (for example so that we can request the injection of {link Inhabita} that represents itself, or to inject companions.)

So this overloaded version of the get method takes the outer-most Inhabitant. This method is only invoked from within HK2 where the decorator pattern is used.

fetch

protected void fetch()

addInhabitantListener

public void addInhabitantListener(InhabitantListener listener)

removeInhabitantListener

public boolean removeInhabitantListener(InhabitantListener listener)

notify

protected void notify(InhabitantListener.EventType eventType)