org.eclipse.gef4.common.adapt

Class AdapterStore

java.lang.Object

org.eclipse.gef4.common.adapt.AdapterStore

All Implemented Interfaces:

IAdaptable, IPropertyChangeNotifier

public class AdapterStore
extends java.lang.Object
implements IAdaptable

An AdapterStore is a basic IAdaptable implementation that can be used standalone.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.gef4.common.adapt.IAdaptable

IAdaptable.Bound<A extends IAdaptable>

Field Summary

Fields inherited from interface org.eclipse.gef4.common.adapt.IAdaptable

ADAPTERS_PROPERTY

Constructor Summary

Constructors

Constructor and Description
AdapterStore()

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Register a PropertyChangeListener at this IPropertyChangeNotifier.
<T> T	getAdapter(AdapterKey<? super T> key) Returns an adapter for the given AdapterKey if one can unambiguously be retrieved, i.e. if there is only a single adapter that 'matches' the given AdapterKey.
<T> T	getAdapter(java.lang.Class<? super T> key) Returns an adapter for the given Class key if one can unambiguously be retrieved.
<T> T	getAdapter(com.google.common.reflect.TypeToken<? super T> key) Returns an adapter for the given TypeToken key if one can unambiguously be retrieved.
<T> java.util.Map<AdapterKey<? extends T>,T>	getAdapters(java.lang.Class<? super T> key) Returns all adapters 'matching' the given Class key, i.e. all adapters whose AdapterKey's TypeToken key AdapterKey.getKey()) refers to the same or a sub-type of the given Class key (see TypeToken.isAssignableFrom(Type)).
<T> java.util.Map<AdapterKey<? extends T>,T>	getAdapters(com.google.common.reflect.TypeToken<? super T> key) Returns all adapters 'matching' the given TypeToken key, i.e. all adapters whose AdapterKey's TypeToken key AdapterKey.getKey()) refers to the same or a sub-type or of the given TypeToken key (see TypeToken.isAssignableFrom(TypeToken)).
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) Unregister an already registered PropertyChangeListener from this IPropertyChangeNotifier.
<T> void	setAdapter(AdapterKey<? super T> key, T adapter) Registers the given adapter under the given AdapterKey.
<T> void	setAdapter(java.lang.Class<? super T> key, T adapter) Registers the given adapter under an AdapterKey, which will use a TypeToken representing the given Class key, i.e. using TypeToken.of(Class), as well as the default role (see AdapterKey.DEFAULT_ROLE.
<T> void	setAdapter(com.google.common.reflect.TypeToken<? super T> key, T adapter) Registers the given adapter under an AdapterKey, which will use the given TypeToken key as well as the default role (see AdapterKey.DEFAULT_ROLE.
<T> T	unsetAdapter(AdapterKey<? super T> key) Unregisters the adapter registered under the exact AdapterKey given, returning it for convenience.

Methods inherited from class java.lang.Object

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

Constructor Detail

AdapterStore

public AdapterStore()

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Description copied from interface: IPropertyChangeNotifier

Register a PropertyChangeListener at this IPropertyChangeNotifier.

Specified by:

addPropertyChangeListener in interface IPropertyChangeNotifier

Parameters:

listener - The PropertyChangeListener to register.

See Also:

PropertyChangeSupport.addPropertyChangeListener(PropertyChangeListener)

getAdapter

public <T> T getAdapter(AdapterKey<? super T> key)

Description copied from interface: IAdaptable

Returns an adapter for the given AdapterKey if one can unambiguously be retrieved, i.e. if there is only a single adapter that 'matches' the given AdapterKey.

An adapter 'matching' the AdapterKey is an adapter, which is registered with an AdapterKey, whose TypeToken key ( AdapterKey.getKey()) refers to the same type or a sub-type of the given AdapterKey's TypeToken key (@see TypeToken.isAssignableFrom(TypeToken) and whose role ( AdapterKey.getRole())) equals the role of the given AdapterKey's role.

If there is more than one adapter that 'matches' the given AdapterKey, or there is no one 'matching' it, null will be returned.

Specified by:

getAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The AdapterKey used to retrieve a registered adapter.

Returns:

The unambiguously retrievable adapter for the given AdapterKey or null if none could be retrieved.

getAdapter

public <T> T getAdapter(java.lang.Class<? super T> key)

Description copied from interface: IAdaptable

Returns an adapter for the given Class key if one can unambiguously be retrieved. That is, if there is only a single adapter that 'matches' the given Class key, this adapter is returned, ignoring the role under which it is registered (see AdapterKey.getRole()).

An adapter 'matching' the Class key is an adapter, which is registered with an AdapterKey, whose key ( AdapterKey.getKey()) refers to the same type or a sub-type of the given Class key (see TypeToken.isAssignableFrom(Type)).

If there is more than one adapter that 'matches' the given Class key, it will return the single adapter that is registered for the default role (AdapterKey.DEFAULT_ROLE), if there is a single adapter for which this holds. Otherwise it will return null.

Specified by:

getAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The Class key used to retrieve a registered adapter.

Returns:

The unambiguously retrievable adapter for the given Class key or null if none could be retrieved.

getAdapter

public <T> T getAdapter(com.google.common.reflect.TypeToken<? super T> key)

Description copied from interface: IAdaptable

Returns an adapter for the given TypeToken key if one can unambiguously be retrieved. That is, if there is only a single adapter that 'matches' the given TypeToken key, this adapter is returned, ignoring the role under which it is registered (see AdapterKey.getRole()).

An adapter 'matching' the TypeToken key is an adapter, which is registered with an AdapterKey, whose key ( AdapterKey.getKey()) refers to the same type or a sub-type of the given type key (see TypeToken.isAssignableFrom(TypeToken).

If there is more than one adapter that 'matches' the given TypeToken key, it will return the single adapter that is registered for the default role (AdapterKey.DEFAULT_ROLE), if there is a single adapter for which this holds. Otherwise it will return null.

Specified by:

getAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The TypeToken key used to retrieve a registered adapter.

Returns:

The unambiguously retrievable adapter for the given TypeToken key or null if none could be retrieved.

getAdapters

public <T> java.util.Map<AdapterKey<? extends T>,T> getAdapters(java.lang.Class<? super T> key)

Description copied from interface: IAdaptable

Returns all adapters 'matching' the given Class key, i.e. all adapters whose AdapterKey's TypeToken key AdapterKey.getKey()) refers to the same or a sub-type of the given Class key (see TypeToken.isAssignableFrom(Type)).

Specified by:

getAdapters in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The Class key to retrieve adapters for.

Returns:

A Map containing all those adapters registered at this IAdaptable, whose AdapterKey's TypeToken key (AdapterKey.getKey()) refers to the same or a sub-type of the given Class key, qualified by their respective AdapterKeys.

See Also:

IAdaptable.getAdapter(Class)

getAdapters

public <T> java.util.Map<AdapterKey<? extends T>,T> getAdapters(com.google.common.reflect.TypeToken<? super T> key)

Description copied from interface: IAdaptable

Returns all adapters 'matching' the given TypeToken key, i.e. all adapters whose AdapterKey's TypeToken key AdapterKey.getKey()) refers to the same or a sub-type or of the given TypeToken key (see TypeToken.isAssignableFrom(TypeToken)).

Specified by:

getAdapters in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The TypeToken key to retrieve adapters for.

Returns:

A Map containing all those adapters registered at this IAdaptable, whose AdapterKey's TypeToken key (AdapterKey.getKey()) refers to the same or a sub-type of the given TypeToken key, qualified by their respective AdapterKeys.

See Also:

IAdaptable.getAdapter(TypeToken)

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Description copied from interface: IPropertyChangeNotifier

Unregister an already registered PropertyChangeListener from this IPropertyChangeNotifier.

Specified by:

removePropertyChangeListener in interface IPropertyChangeNotifier

Parameters:

listener - The PropertyChangeListener to unregister.

See Also:

PropertyChangeSupport.removePropertyChangeListener(PropertyChangeListener)

setAdapter

public <T> void setAdapter(AdapterKey<? super T> key,
                           T adapter)

Description copied from interface: IAdaptable

Registers the given adapter under the given AdapterKey. The adapter has to be compliant to the AdapterKey, i.e. it has to be of the same type or a sub-type of the AdapterKey's type key ( AdapterKey.getKey()).

If the given adapter implements IAdaptable.Bound, the adapter will obtain a back-reference to this IAdaptable via its IAdaptable.Bound.setAdaptable(IAdaptable) method.

Specified by:

setAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The AdapterKey under which to register the given adapter.

adapter - The adapter to register under the given AdapterKey.

setAdapter

public <T> void setAdapter(java.lang.Class<? super T> key,
                           T adapter)

Description copied from interface: IAdaptable

Registers the given adapter under an AdapterKey, which will use a TypeToken representing the given Class key, i.e. using TypeToken.of(Class), as well as the default role (see AdapterKey.DEFAULT_ROLE.

If the given adapter implements IAdaptable.Bound, the adapter will obtain a back-reference to this IAdaptable via its IAdaptable.Bound.setAdaptable(IAdaptable) method.

Specified by:

setAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The Class under which to register the given adapter.

adapter - The adapter to register under the given Class key.

See Also:

IAdaptable.setAdapter(AdapterKey, Object)

setAdapter

public <T> void setAdapter(com.google.common.reflect.TypeToken<? super T> key,
                           T adapter)

Description copied from interface: IAdaptable

Registers the given adapter under an AdapterKey, which will use the given TypeToken key as well as the default role (see AdapterKey.DEFAULT_ROLE.

If the given adapter implements IAdaptable.Bound, the adapter will obtain a back-reference to this IAdaptable via its IAdaptable.Bound.setAdaptable(IAdaptable) method.

Specified by:

setAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The TypeToken under which to register the given adapter.

adapter - The adapter to register under the given TypeToken key.

See Also:

IAdaptable.setAdapter(AdapterKey, Object)

unsetAdapter

public <T> T unsetAdapter(AdapterKey<? super T> key)

Description copied from interface: IAdaptable

Unregisters the adapter registered under the exact AdapterKey given, returning it for convenience.

If the given adapter implements IAdaptable.Bound, the back-reference to this IAdaptable will be removed via its IAdaptable.Bound.setAdaptable(IAdaptable) method, passing over null.

Specified by:

unsetAdapter in interface IAdaptable

Type Parameters:

T - The adapter type.

Parameters:

key - The AdapterKey for which to remove a registered adapter.

Returns:

The adapter, which has been removed.