com.cedarsoft.lookup

Class DynamicLookup

java.lang.Object

com.cedarsoft.lookup.AbstractLookup

com.cedarsoft.lookup.DynamicLookup

All Implemented Interfaces:

Lookup, LookupStore

public class DynamicLookup
extends AbstractLookup
implements LookupStore

A dynamic lookup

Author:

Johannes Schneider (js@cedarsoft.com)

Constructor Summary

Constructors

Constructor and Description
DynamicLookup(Object... values) Creates a new dynamic lookup

Method Summary

Modifier and Type	Method and Description
<T> void	addChangeListener(Class<T> type, LookupChangeListener<? super T> lookupChangeListener) Add a lookup change listener for a given type
void	addChangeListener(LookupChangeListener<?> lookupChangeListener) Adds a lookup change listener
<T> void	addChangeListenerWeak(Class<T> type, LookupChangeListener<? super T> lookupChangeListener) Add a lookup change listener that is wrapped within a WeakLookupChangeListener for a given type
void	addChangeListenerWeak(LookupChangeListener<?> lookupChangeListener) Adds a lookup change listener that is wrapped within a WeakLookupChangeListener
boolean	addValue(Object value) Adds a value to the store.
boolean	addValues(Lookup lookup) addValues
boolean	addValues(Object... objects) addValues
<T> void	bind(Class<T> type, LookupChangeListener<? super T> lookupChangeListener) Binds the given lookup change listener.
<T> void	bind(TypedLookupChangeListener<T> lookupChangeListener) Binds the given lookup change listener with the key retrieved from TypedLookupChangeListener#getType().
<T> void	bindWeak(Class<T> type, LookupChangeListener<? super T> lookupChangeListener) Binds the given lookup change listener that is wrapped within a WeakLookupChangeListener.
<T> void	bindWeak(TypedLookupChangeListener<T> lookupChangeListener) Binds the given lookup change listener (that is wrapped within a WeakLookupChangeListener) with the key retrieved from TypedLookupChangeListener#getType().
void	clear() Clears the lookup
List<? extends LookupChangeListener<?>>	getLookupChangeListeners() getLookupChangeListeners
<T> T	lookup(Class<T> type) Lookup a given object
Map<Class<?>,Object>	lookups() Returns a map containing the available lookup objects.
<T> void	removeChangeListener(Class<T> type, LookupChangeListener<? super T> lookupChangeListener) Remove a lookup change listener from the given type
void	removeChangeListener(LookupChangeListener<?> lookupChangeListener) Remove a lookup change listener
boolean	removeValue(Object value) removeValue
boolean	removeValues(Lookup lookup) removeValues
boolean	removeValues(Object... objects) removeValues
<T> void	store(Class<T> type, T value) A lookup store is able to add elements to the lookup

Methods inherited from class com.cedarsoft.lookup.AbstractLookup

lookupNonNull

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cedarsoft.lookup.Lookup

lookupNonNull

Constructor Detail

DynamicLookup

public DynamicLookup(@Nonnull
                     Object... values)

Creates a new dynamic lookup

Parameters:

values - the values that are stored within the lookup

Method Detail

clear

public void clear()

Clears the lookup

store

public <T> void store(@Nonnull
                      Class<T> type,
                      @Nonnull
                      T value)

A lookup store is able to add elements to the lookup

The type is ignored

Specified by:

store in interface LookupStore

Type Parameters:

T - a T object.

Parameters:

type - the type

value - the value

addValue

public final boolean addValue(@Nonnull
                              Object value)

Adds a value to the store. The value may be lookup up using the type of value and all its super classes and interfaces.

Parameters:

value - the value that is added

Returns:

a boolean.

removeValue

public final boolean removeValue(@Nonnull
                                 Object value)

removeValue

Parameters:

value - a Object object.

Returns:

a boolean.

addValues

public final boolean addValues(@Nonnull
                               Object... objects)

addValues

Parameters:

objects - a Object object.

Returns:

a boolean.

addValues

public final boolean addValues(@Nonnull
                               Lookup lookup)

addValues

Parameters:

lookup - a Lookup object.

Returns:

a boolean.

removeValues

public final boolean removeValues(@Nonnull
                                  Lookup lookup)

removeValues

Parameters:

lookup - a Lookup object.

Returns:

a boolean.

removeValues

public final boolean removeValues(@Nonnull
                                  Object... objects)

removeValues

Parameters:

objects - a Object object.

Returns:

a boolean.

lookup

@Nullable
public <T> T lookup(@Nonnull
                              Class<T> type)

Lookup a given object

Specified by:

lookup in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - the type

Returns:

the lookup object or null if nothing has been found

lookups

@Nonnull
public Map<Class<?>,Object> lookups()

Returns a map containing the available lookup objects. This method can throw an UnsupportedOperationException if the map is not available. If no exception is thrown the map must contain every possible lookup object.

Specified by:

lookups in interface Lookup

Returns:

a map containing the available lookup objects.

bind

public <T> void bind(@Nonnull
                     Class<T> type,
                     @Nonnull
                     LookupChangeListener<? super T> lookupChangeListener)

Binds the given lookup change listener. Adds the given listener and calls LookupChangeListener#lookupChanged(LookupChangeEvent) for the first time.

Specified by:

bind in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - a Class object.

lookupChangeListener - the listener that is added

bind

public <T> void bind(@Nonnull
                     TypedLookupChangeListener<T> lookupChangeListener)

Binds the given lookup change listener with the key retrieved from TypedLookupChangeListener#getType(). Adds the given listener and calls LookupChangeListener#lookupChanged(LookupChangeEvent) for the first time.

Specified by:

bind in interface Lookup

Type Parameters:

T - a T object.

Parameters:

lookupChangeListener - the listener that is added

bindWeak

public <T> void bindWeak(@Nonnull
                         Class<T> type,
                         @Nonnull
                         LookupChangeListener<? super T> lookupChangeListener)

Binds the given lookup change listener that is wrapped within a WeakLookupChangeListener. Adds the given listener and calls LookupChangeListener#lookupChanged(LookupChangeEvent) for the first time.

Specified by:

bindWeak in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - a Class object.

lookupChangeListener - the listener that is added

bindWeak

public <T> void bindWeak(@Nonnull
                         TypedLookupChangeListener<T> lookupChangeListener)

Binds the given lookup change listener (that is wrapped within a WeakLookupChangeListener) with the key retrieved from TypedLookupChangeListener#getType(). Adds the given listener and calls LookupChangeListener#lookupChanged(LookupChangeEvent) for the first time.

Specified by:

bindWeak in interface Lookup

Type Parameters:

T - a T object.

Parameters:

lookupChangeListener - the listener that is added

addChangeListenerWeak

public void addChangeListenerWeak(@Nonnull
                                  LookupChangeListener<?> lookupChangeListener)

Adds a lookup change listener that is wrapped within a WeakLookupChangeListener

Specified by:

addChangeListenerWeak in interface Lookup

Parameters:

lookupChangeListener - the lookup change listener

addChangeListenerWeak

public <T> void addChangeListenerWeak(@Nonnull
                                      Class<T> type,
                                      @Nonnull
                                      LookupChangeListener<? super T> lookupChangeListener)

Add a lookup change listener that is wrapped within a WeakLookupChangeListener for a given type

Specified by:

addChangeListenerWeak in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - the type

lookupChangeListener - the listener

addChangeListener

public void addChangeListener(@Nonnull
                              LookupChangeListener<?> lookupChangeListener)

Adds a lookup change listener

Specified by:

addChangeListener in interface Lookup

Parameters:

lookupChangeListener - the lookup change listener

addChangeListener

public <T> void addChangeListener(@Nonnull
                                  Class<T> type,
                                  @Nonnull
                                  LookupChangeListener<? super T> lookupChangeListener)

Add a lookup change listener for a given type

Specified by:

addChangeListener in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - the type

lookupChangeListener - the listener

removeChangeListener

public void removeChangeListener(@Nonnull
                                 LookupChangeListener<?> lookupChangeListener)

Remove a lookup change listener

Specified by:

removeChangeListener in interface Lookup

Parameters:

lookupChangeListener - the listener that is removed from *all* types

removeChangeListener

public <T> void removeChangeListener(@Nonnull
                                     Class<T> type,
                                     @Nonnull
                                     LookupChangeListener<? super T> lookupChangeListener)

Remove a lookup change listener from the given type

Specified by:

removeChangeListener in interface Lookup

Type Parameters:

T - a T object.

Parameters:

type - the type of the listener

lookupChangeListener - the listener

getLookupChangeListeners

@Nonnull
public List<? extends LookupChangeListener<?>> getLookupChangeListeners()

getLookupChangeListeners

Returns:

a List object.