org.oddjob.arooa.registry

Class SimpleBeanDirectory

java.lang.Object

org.oddjob.arooa.registry.SimpleBeanDirectory

All Implemented Interfaces:

BeanDirectory

public class SimpleBeanDirectory
extends java.lang.Object
implements BeanDirectory

Provide a BeanDirectory from some mapping functions.

Author:

Rob Gordon.

Constructor Summary

Constructors

Constructor and Description
SimpleBeanDirectory(java.util.function.Function<? super java.lang.String,?> ids, java.util.function.Function<? super java.lang.Object,? extends java.lang.String> toId, java.util.function.Supplier<java.util.stream.Stream<?>> components, PropertyAccessor propertyAccessor, ArooaConverter converter)

Method Summary

Modifier and Type	Method and Description
<T> java.lang.Iterable<T>	getAllByType(java.lang.Class<T> type) Get all objects in the directory of the required type.
java.lang.String	getIdFor(java.lang.Object component) Find the id for the given component.
java.lang.Object	lookup(java.lang.String path) Get the value which is either a bean or the property of a bean.
<T> T	lookup(java.lang.String path, java.lang.Class<T> required) Get a value, as above, but also convert it into to given type.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleBeanDirectory

public SimpleBeanDirectory(java.util.function.Function<? super java.lang.String,?> ids,
                           java.util.function.Function<? super java.lang.Object,? extends java.lang.String> toId,
                           java.util.function.Supplier<java.util.stream.Stream<?>> components,
                           PropertyAccessor propertyAccessor,
                           ArooaConverter converter)

Method Detail

getAllByType

public <T> java.lang.Iterable<T> getAllByType(java.lang.Class<T> type)

Description copied from interface: BeanDirectory

Get all objects in the directory of the required type.

Why an Iterable not a Collection or Set? It was thought that this would force read only use. Maybe it should be an array...

Specified by:

getAllByType in interface BeanDirectory

Type Parameters:

T - The required type.

Parameters:

type - The type.

Returns:

An Iterable for matches. Never null.

lookup

public java.lang.Object lookup(java.lang.String path)
                        throws ArooaPropertyException

Description copied from interface: BeanDirectory

Get the value which is either a bean or the property of a bean.

The path can be either:

• The id of a bean e.g. mybean
• A simple property of a bean e.g. mybean.simple
• An indexed property of a bean e.g. mybean.indexed[1]
• A mapped property of a bean e.g. mybean.mapped(key)
• A nested property of a bean e.g. mybean.complex.simple
• A nested beanownerid/mybean
• Most combinations of the above.

Specified by:

lookup in interface BeanDirectory

Parameters:

path - The path.

Returns:

The resultant value or null.

Throws:

ArooaPropertyException - If property access fails.

lookup

public <T> T lookup(java.lang.String path,
                    java.lang.Class<T> required)
             throws ArooaPropertyException,
                    ArooaConversionException

Description copied from interface: BeanDirectory

Get a value, as above, but also convert it into to given type.

Conversion in the directory is required when the client code has no access to the converters required, for instance in a nested Oddjob.

Specified by:

lookup in interface BeanDirectory

Type Parameters:

T - The required type.

Parameters:

path - The full path

required - The required type.

Returns:

An object of the required type or null if none can be found.

Throws:

ArooaPropertyException - If property access fails.

ArooaConversionException - If an object can be found but it can't be converted into the required type.

getIdFor

public java.lang.String getIdFor(java.lang.Object component)

Find the id for the given component.

Specified by:

getIdFor in interface BeanDirectory

Parameters:

component - The component.

Returns:

The id or null if none can be found.