org.nuiton.util.beans
Class Binder<I,O>

java.lang.Object
  org.nuiton.util.beans.Binder<I,O>

Type Parameters:

I - the source bean type

O - the destination bean type

All Implemented Interfaces:

java.io.Serializable

public class Binder<I,O>
extends java.lang.Object
implements java.io.Serializable

A binder permits to copy some properties from an object to another one.

It is based on a BinderModel which contains the mapping of properties to transfert from the source object to the destination object.

Use the method copy(Object, Object,String...) to transfert properties.

Use the method obtainProperties(Object,String...) to obtain

Since:

1.1.5

Author:

tchemit

See Also:

Serialized Form

Nested Class Summary

static class

Binder.CollectionStrategy Types of loading of collections.

Field Summary

protected BinderModel<I,O>

model the model of the binder

Constructor Summary

Binder()

Method Summary

protected java.lang.Object	bind(Binder binder, java.lang.Object read)
protected java.lang.Object	bindCollection(java.lang.String sourceProperty, java.lang.Object read)
protected java.lang.Object	bindProperty(java.lang.String sourceProperty, java.lang.Object read)
protected void	copy(I source, O target, boolean excludeProperties, java.lang.String... propertyNames) Copy properties from a source bean to a destination one according to the model of the binder.
void	copy(I source, O target, java.lang.String... propertyNames) Copy properties from a source bean to a destination one according to the model of the binder.
void	copyExcluding(I source, O target, java.lang.String... propertyNames) Copy properties from a source bean to a destination one according to the model of the binder excluding propertyNames.
protected java.lang.String[]	getAllPropertiesExclude(java.lang.String... propertyNameExcludes) Obtains all properties from binder's model except those propertyNameExcludes.
protected java.lang.Object	getCollectionValue(java.lang.String sourceProperty, java.lang.Object readValue)
protected BinderModel<I,O>	getModel() Get the model of the binder.
protected java.lang.String[]	getProperties(java.lang.String... propertyNames) Obtain the properties, if none is given in propertyNames parameter, will use all property names defined in binder's model, otherwise, check that all given property names are safe (registred in binder's model).
java.lang.Class<I>	getSourceType() Obtains the type of the source bean.
java.lang.Class<O>	getTargetType() Obtains the type of the target bean.
java.util.Map<java.lang.String,java.lang.Object>	obtainProperties(I source, java.lang.String... propertyNames) Obtain from the given object all properties registred in the binder model.
protected void	setModel(BinderModel<?,?> model) Set the model of the binder.

Methods inherited from class java.lang.Object

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

Field Detail

model

protected BinderModel<I,O> model

the model of the binder

Constructor Detail

Binder

public Binder()

Method Detail

getSourceType

public java.lang.Class<I> getSourceType()

Obtains the type of the source bean.

Returns:

the type of the source bean

getTargetType

public java.lang.Class<O> getTargetType()

Obtains the type of the target bean.

Returns:

the type of the target bean

obtainProperties

public java.util.Map<java.lang.String,java.lang.Object> obtainProperties(I source,
                                                                         java.lang.String... propertyNames)

Obtain from the given object all properties registred in the binder model.

Note: If a property's value is null, it will not be injected in the result.

Parameters:

source - the bean to read

propertyNames - subset of properties to load

Returns:

the map of properties obtained indexed by their property name, or an empty map is the given from is null.

copy

public void copy(I source,
                 O target,
                 java.lang.String... propertyNames)

Copy properties from a source bean to a destination one according to the model of the binder. If propertyNames is defined, only those properties will be copied.

Note: If from object is null, then null values will be set to mapped properties into dst

Parameters:

source - the bean to read

target - the bean to write

propertyNames - optional subset of properties to copy (if none is specifed, will use all the properties defined in binder)

Throws:

java.lang.NullPointerException - if target parameter is null

copyExcluding

public void copyExcluding(I source,
                          O target,
                          java.lang.String... propertyNames)

Copy properties from a source bean to a destination one according to the model of the binder excluding propertyNames.

Note: If from object is null, then null values will be set to mapped properties into dst.

Parameters:

source - the bean to read

target - the bean to write

propertyNames - optional subset of properties to copy (if none is specifed, will use all the properties defined in binder)

Throws:

java.lang.NullPointerException - if target parameter is null

copy

protected void copy(I source,
                    O target,
                    boolean excludeProperties,
                    java.lang.String... propertyNames)
             throws java.lang.NullPointerException

Copy properties from a source bean to a destination one according to the model of the binder.

Note: If from object is null, then null values will be set to mapped properties into dst.

Parameters:

source - the bean to read

target - the bean to write

excludeProperties - true to exclude following propertyNames

propertyNames - optional subset of properties to copy (if none is specifed, will use all the properties defined in binder)

Throws:

java.lang.NullPointerException - if target parameter is null

getModel

protected BinderModel<I,O> getModel()

Get the model of the binder.

Returns:

the model of the binder

setModel

protected void setModel(BinderModel<?,?> model)

Set the model of the binder.

Parameters:

model - the model of the binder

getProperties

protected java.lang.String[] getProperties(java.lang.String... propertyNames)

Obtain the properties, if none is given in propertyNames parameter, will use all property names defined in binder's model, otherwise, check that all given property names are safe (registred in binder's model).

Parameters:

propertyNames - optional subset of properties to get

Returns:

the array of property names

getAllPropertiesExclude

protected java.lang.String[] getAllPropertiesExclude(java.lang.String... propertyNameExcludes)

Obtains all properties from binder's model except those propertyNameExcludes. Unknown properties will be ignored.

Parameters:

propertyNameExcludes - name of properties to exclude

Returns:

the array of property names without those in argument

getCollectionValue

protected java.lang.Object getCollectionValue(java.lang.String sourceProperty,
                                              java.lang.Object readValue)

bindProperty

protected java.lang.Object bindProperty(java.lang.String sourceProperty,
                                        java.lang.Object read)
                                 throws java.lang.IllegalAccessException,
                                        java.lang.InstantiationException

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

bindCollection

protected java.lang.Object bindCollection(java.lang.String sourceProperty,
                                          java.lang.Object read)
                                   throws java.lang.IllegalAccessException,
                                          java.lang.InstantiationException

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

bind

protected java.lang.Object bind(Binder binder,
                                java.lang.Object read)
                         throws java.lang.IllegalAccessException,
                                java.lang.InstantiationException

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException