de.cismet.ext

Class CExtManager

java.lang.Object

de.cismet.ext.CExtManager

public class CExtManager
extends Object

Global extension manager implementation that can provide extension implementations of any type. The behavior is similar to those of the global Lookup. However, this implementation provides additional facilities to collect extensions for specific situations/usages using an additional CExtContext object to express this very context. Extension providers can thus restrict the usage of their extensions to contexts in which they decided that the specific extension is reasonable. Extension users in turn can exactly specify their needs and thus can filter unsuitable extensions for their context.

Version:

1.0, 2012/08/28

Author:

thorsten, mscholl

See Also:

CExtContext, CExtProvider, Lookup

Method Summary

Modifier and Type	Method and Description
<T> T	getExtension(Class<T> c, CExtContext context) Provides the first matching extension implementation of the given type for the given context.
<T> Collection<? extends T>	getExtensions(Class<T> c, CExtContext context) Collects all matching extension implementations of the given type for the given context.
static CExtManager	getInstance() Returns the CExtManager instance (Singleton).

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static CExtManager getInstance()

Returns the CExtManager instance (Singleton).

Returns:

the CExtManager instance

Since:

1.0

getExtensions

public <T> Collection<? extends T> getExtensions(Class<T> c,
                                                 CExtContext context)

Collects all matching extension implementations of the given type for the given context. It makes use of the global Lookup and thus the ordering of the result depends on the order of the CExtProvider implementations that in turn provide implementations of the given type.

Type Parameters:

T - type of the requested extensions

Parameters:

c - class of the type of the requested extensions

context - context for which the extensions are requested for

Returns:

an appropriate extension collection, ordered from most relevant to least relevant, never null

Since:

1.0

getExtension

public <T> T getExtension(Class<T> c,
                          CExtContext context)

Provides the first matching extension implementation of the given type for the given context. It makes use of the global Lookup and thus the first matching implementation depends on the order of the CExtProvider implementations that in turn provide implementations of the given type.

Type Parameters:

T - type of the requested extension

Parameters:

c - class of the type of the requested extension

context - context for which the extension is requested for

Returns:

an appropriate extension implementation or null if there is no CExtProvider that provides an extension implementation for the given type and context

Since:

1.0