Package org.alfresco.traitextender

Class ExtenderImpl

java.lang.Object

org.alfresco.traitextender.Extender

org.alfresco.traitextender.ExtenderImpl

public class ExtenderImpl
extends Extender

Standard-singleton Extender implementation.

Author:

Bogdan Horje

Constructor Summary

Constructors

Constructor	Description
ExtenderImpl()

Method Summary

Modifier and Type	Method	Description
<E,M extends Trait> E	getExtension(Extensible anExtensible, ExtensionPoint<E,M> point)	Creates and returns a unique per ExtensibleTrait object or null if no extension-point factory is registered for the given ExtensionPoint. Given that Extensible.getTrait(Class) is used to obtain the ExtendedTrait that the returned extension is uniquely associated with, the uniqueness and garbage collection of the returned extension is dependent on how the given Extensible handles its ExtendedTraits.
void	register(ExtensionPoint<?,?> point, ExtensionFactory<?> factory)	Registers an extension-point to factory association to be used in extension creation.
void	start(ExtensionBundle bundle)	Start life-cycle phase trigger method. Upon successful execution the bundle will have all its extension points registered using Extender.register(ExtensionPoint, ExtensionFactory) and ready to be.
void	stop(ExtensionBundle bundle)	Start life-cycle phase trigger method. Upon successful execution the bundle will have all its extension points unregistered using Extender.unregister(ExtensionPoint).
void	stopAll()	Stops all previously registered ExtensionBundles.
void	unregister(ExtensionPoint<?,?> point)	Unregisters an extension-point to factory association of the given extension point.

Methods inherited from class org.alfresco.traitextender.Extender

getInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtenderImpl

public ExtenderImpl()

Method Detail

start

public void start(ExtensionBundle bundle)

Description copied from class: Extender

Start life-cycle phase trigger method.
Upon successful execution the bundle will have all its extension points registered using Extender.register(ExtensionPoint, ExtensionFactory) and ready to be.

Specified by:

start in class Extender

Parameters:

bundle - to be started

stop

public void stop(ExtensionBundle bundle)

Description copied from class: Extender

Start life-cycle phase trigger method.
Upon successful execution the bundle will have all its extension points unregistered using Extender.unregister(ExtensionPoint).

Specified by:

stop in class Extender

Parameters:

bundle - to be stopped

stopAll

public void stopAll()

Description copied from class: Extender

Stops all previously registered ExtensionBundles.

Specified by:

stopAll in class Extender

getExtension

public <E,M extends Trait> E getExtension(Extensible anExtensible,
                                                ExtensionPoint<E,M> point)

Description copied from class: Extender

Creates and returns a unique per ExtensibleTrait object or null if no extension-point factory is registered for the given ExtensionPoint.
Given that Extensible.getTrait(Class) is used to obtain the ExtendedTrait that the returned extension is uniquely associated with, the uniqueness and garbage collection of the returned extension is dependent on how the given Extensible handles its ExtendedTraits.

Specified by:

getExtension in class Extender

Returns:

a unique per ExtensibleTrait extension object or null if no extension-point factory is registered for the given ExtensionPoint

register

public void register(ExtensionPoint<?,?> point,
                     ExtensionFactory<?> factory)

Description copied from class: Extender

Registers an extension-point to factory association to be used in extension creation. The presence of an association for a given extension point guarantees that, when requested, a unique extension object per ExtensibleTrait extension is returned by Extender.getExtension(Extensible, ExtensionPoint).

Specified by:

register in class Extender

Parameters:

point - the extension point to be associated with the given extension factory during extension retrieval using Extender.getExtension(Extensible, ExtensionPoint)

unregister

public void unregister(ExtensionPoint<?,?> point)

Description copied from class: Extender

Unregisters an extension-point to factory association of the given extension point. The absence of an association for a given extension point guarantees that, when requested, a null is returned by Extender.getExtension(Extensible, ExtensionPoint).
Unregistering extension points does not force the garbage collection of the already created extensions.

Specified by:

unregister in class Extender