uk.ac.ed.epcc.safe.accounting.properties

Class MultiFinder

java.lang.Object

uk.ac.ed.epcc.safe.accounting.properties.MultiFinder

All Implemented Interfaces:

PropertyFinder

public final class MultiFinder
extends java.lang.Object
implements PropertyFinder

MultiFinder is a PropertyFinder that spans multiple PropertyRegistry objects. If MultiFinders can be added then each of the wrapped PropertyRegistry objects will be added in turn. This means that any subsequent changes to the child MultiFinder will not be tracked by the parent. Finders are always searched in the reverse order they were added.

Author:

spb

Constructor Summary

Constructors

Constructor and Description
MultiFinder()

Method Summary

Methods

Modifier and Type	Method and Description
void	addFinder(PropertyFinder f) Add a PropertyFinder to the Set of finders to be searched.
PropertyFinder	copy() return a new PropertyFinder that represents a copy of the current state of this object.
<T> PropertyTag<? extends T>	find(java.lang.Class<T> clazz, java.lang.String name) Locate a registered property by name and class of result.
PropertyTag<?>	find(java.lang.String name) Locate a registered property by name.
PropertyTag<?>	find(TagFilter fil, java.lang.String name) Locate a registered property by name and additional filter.
java.util.Set<FixedPropertyFinder>	getNested()
java.util.Set<PropertyTag>	getProperties() Get all properties That could be found using this object
<T> java.util.Set<PropertyTag<? extends T>>	getProperties(java.lang.Class<T> clazz) Get all properties where the property can be assigned to class T
boolean	hasProperty(PropertyTag tag) is the specified property in the set of properties that can be found by this object.
PropertyTag<?>	make(java.lang.String name) Locate a registered property by name.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiFinder

public MultiFinder()

Method Detail

addFinder

public void addFinder(PropertyFinder f)

Add a PropertyFinder to the Set of finders to be searched. Finders are always searched in the reverse order they were added.

Parameters:

f - PropertyFinder to add

make

public PropertyTag<?> make(java.lang.String name)
                    throws InvalidPropertyException

Description copied from interface: PropertyFinder

Locate a registered property by name. The property is required to exist and an InvalidPropertyException will be thrown if it does not. Note that this is only able to find a property once the class where the property is defined has been loaded

Specified by:

make in interface PropertyFinder

Throws:

InvalidPropertyException

Returns:

PropertyTag

find

public PropertyTag<?> find(java.lang.String name)

Description copied from interface: PropertyFinder

Locate a registered property by name. Note that this is only able to find a property once the class where the property is defined has been loaded

Specified by:

find in interface PropertyFinder

Returns:

PropertyTag or null

find

public <T> PropertyTag<? extends T> find(java.lang.Class<T> clazz,
                                java.lang.String name)

Description copied from interface: PropertyFinder

Locate a registered property by name and class of result. This method will only return a PropertyTag if its property can be assigned to class T This is primarily intended to distinguish between tags with the same unqualified name.

Specified by:

find in interface PropertyFinder

Type Parameters:

T - Target class

Parameters:

clazz - Class object for target

name - String name of property

Returns:

PropertyTag or null

find

public PropertyTag<?> find(TagFilter fil,
                  java.lang.String name)

Description copied from interface: PropertyFinder

Locate a registered property by name and additional filter. This method will only return a PropertyTag if the TagFilter accepts the result.

Specified by:

find in interface PropertyFinder

Returns:

ProeprtyTag or null

getProperties

public java.util.Set<PropertyTag> getProperties()

Description copied from interface: PropertyFinder

Get all properties That could be found using this object

Specified by:

getProperties in interface PropertyFinder

Returns:

Set of PropertyTag

hasProperty

public boolean hasProperty(PropertyTag tag)

Description copied from interface: PropertyFinder

is the specified property in the set of properties that can be found by this object.

Specified by:

hasProperty in interface PropertyFinder

Returns:

boolean

getProperties

public <T> java.util.Set<PropertyTag<? extends T>> getProperties(java.lang.Class<T> clazz)

Description copied from interface: PropertyFinder

Get all properties where the property can be assigned to class T

Specified by:

getProperties in interface PropertyFinder

Returns:

Set of PropertyTag

copy

public PropertyFinder copy()

Description copied from interface: PropertyFinder

return a new PropertyFinder that represents a copy of the current state of this object.

Specified by:

copy in interface PropertyFinder

Returns:

PropertyFinder

getNested

public java.util.Set<FixedPropertyFinder> getNested()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object