jodd.bean

Class BeanCopy

java.lang.Object

jodd.bean.BeanVisitor

jodd.bean.BeanCopy

All Implemented Interfaces:

jodd.util.InExRuleMatcher<java.lang.String,java.lang.String>

public class BeanCopy
extends BeanVisitor

Powerful tool for copying properties from one bean into another.

See Also:

BeanVisitor

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	declaredTarget
protected java.lang.Object	destination

Fields inherited from class jodd.bean.BeanVisitor

blacklist, declared, ignoreNullValues, includeFields, rules, source

Fields inherited from interface jodd.util.InExRuleMatcher

WILDCARD_PATH_RULE_MATCHER, WILDCARD_RULE_MATCHER

Constructor Summary

Constructors

Constructor and Description
BeanCopy(java.lang.Object source, java.lang.Object destination)

Method Summary

Methods

Modifier and Type	Method and Description
static BeanCopy	beans(java.lang.Object source, java.lang.Object destination) Static factory.
void	copy() Performs the copying.
BeanCopy	declared(boolean declared) Defines if all properties should be copied (when set to true) or only public (when set to false, default).
BeanCopy	declared(boolean declaredSource, boolean declaredTarget) Fine-tuning of the declared behaviour.
BeanCopy	exclude(java.lang.String... excludes) Defines excluded property names.
BeanCopy	exclude(java.lang.String exclude) Exclude a property.
BeanCopy	excludeAll() Excludes all properties, i.e. enables blacklist mode.
BeanCopy	ignoreNulls(boolean ignoreNulls) Defines if null values should be ignored.
BeanCopy	include(java.lang.String... includes) Defines included property names.
BeanCopy	include(java.lang.String include) Include a property.
BeanCopy	includeAs(java.lang.Class template) Defines included property names as public properties of given template class.
BeanCopy	includeFields(boolean includeFields) Defines if fields without getters should be copied too.
protected boolean	visitProperty(java.lang.String name, java.lang.Object value) Copies single property to the destination.

Methods inherited from class jodd.bean.BeanVisitor

accept, getAllBeanPropertyNames, resolveProperties, visit

Methods inherited from class java.lang.Object

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

Field Detail

destination

protected java.lang.Object destination

declaredTarget

protected boolean declaredTarget

Constructor Detail

BeanCopy

public BeanCopy(java.lang.Object source,
        java.lang.Object destination)

Method Detail

beans

public static BeanCopy beans(java.lang.Object source,
             java.lang.Object destination)

Static factory.

excludeAll

public BeanCopy excludeAll()

Excludes all properties, i.e. enables blacklist mode.

exclude

public BeanCopy exclude(java.lang.String... excludes)

Defines excluded property names.

exclude

public BeanCopy exclude(java.lang.String exclude)

Exclude a property.

include

public BeanCopy include(java.lang.String... includes)

Defines included property names.

include

public BeanCopy include(java.lang.String include)

Include a property.

includeAs

public BeanCopy includeAs(java.lang.Class template)

Defines included property names as public properties of given template class. Sets to black list mode.

ignoreNulls

public BeanCopy ignoreNulls(boolean ignoreNulls)

Defines if null values should be ignored.

declared

public BeanCopy declared(boolean declared)

Defines if all properties should be copied (when set to true) or only public (when set to false, default).

declared

public BeanCopy declared(boolean declaredSource,
                boolean declaredTarget)

Fine-tuning of the declared behaviour.

includeFields

public BeanCopy includeFields(boolean includeFields)

Defines if fields without getters should be copied too.

copy

public void copy()

Performs the copying.

visitProperty

protected boolean visitProperty(java.lang.String name,
                    java.lang.Object value)

Copies single property to the destination. Exceptions are ignored, so copying continues if destination does not have some of the sources properties.

Specified by:

visitProperty in class BeanVisitor