com.cedarsoft.lookup

Class MergingLookup

java.lang.Object

com.cedarsoft.lookup.AbstractLookup

com.cedarsoft.lookup.MergingLookup

All Implemented Interfaces:

Lookup

public class MergingLookup
extends AbstractLookup
implements Lookup

Merges two lookups. The first lookup has predecense. Every object that is contained within the first lookup is resolved using the first. Only if no object of a given type is contained within the first lookup the second lookup is queried.

Author:

Johannes Schneider (js@cedarsoft.com)

Constructor Summary

Constructors

Constructor and Description
MergingLookup(Lookup first, Lookup second) Constructor for MergingLookup.

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
<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().
<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

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

MergingLookup

public MergingLookup(@Nonnull
                     Lookup first,
                     @Nonnull
                     Lookup second)

Constructor for MergingLookup.

Parameters:

first - a Lookup object.

second - a Lookup object.

Method Detail

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 <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

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