net.sf.morph.transform.converters
Class EvaluateExpressionConverter

java.lang.Object
  net.sf.morph.transform.transformers.BaseTransformer
      net.sf.morph.transform.converters.EvaluateExpressionConverter

All Implemented Interfaces:

net.sf.composite.Component, Converter, DecoratedConverter, DecoratedTransformer, ExplicitTransformer, Transformer

public class EvaluateExpressionConverter
extends BaseTransformer
implements DecoratedConverter

A Converter that returns the result of evaluating a property against an object using a DecoratedLanguage.

Since:

Morph 1.1

Author:

Matt Benson

Field Summary

Fields inherited from class net.sf.morph.transform.transformers.BaseTransformer

destinationClasses, log, sourceClasses

Fields inherited from interface net.sf.morph.transform.Transformer

TRANSFORMATION_TYPE_CONVERT, TRANSFORMATION_TYPE_COPY

Fields inherited from interface net.sf.morph.transform.Transformer

TRANSFORMATION_TYPE_CONVERT, TRANSFORMATION_TYPE_COPY

Constructor Summary

EvaluateExpressionConverter()
Create a new EvaluateExpressionConverter.

EvaluateExpressionConverter(java.lang.String expression)
Construct a new EvaluateExpressionConverter.

Method Summary

protected java.lang.Object	convertImpl(java.lang.Class destinationClass, java.lang.Object source, java.util.Locale locale) The implementation of the convert method, which may omit the invalid argument checks already performed by this base class.
protected java.lang.Class[]	getDestinationClassesImpl() Transformer.getDestinationClasses() implementation template method.
java.lang.String	getExpression() Get the expression of this EvaluateExpressionConverter.
DecoratedLanguage	getLanguage() Get the DecoratedLanguage language.
protected java.lang.Class[]	getSourceClassesImpl() Transformer.getSourceClasses() implementation template method.
protected void	initializeImpl() Gives subclasses a chance to perform any computations needed to initialize the transformer.
void	setDestinationClasses(java.lang.Class[] destinationClasses) Configures the destinationClasses property of this transformer.
void	setExpression(java.lang.String expression) Set the String expression.
void	setLanguage(DecoratedLanguage language) Set the DecoratedLanguage language.
void	setSourceClasses(java.lang.Class[] sourceClasses) Configures the sourceClasses property of this transformer.

Methods inherited from class net.sf.morph.transform.transformers.BaseTransformer

clone, convert, convert, copy, copy, copyImpl, createDefaultReflector, createNewInstance, createNewInstanceImpl, createReusableSource, equals, equals, equalsUnidirectionalTest, getDestinationClasses, getInstantiatingReflector, getLocale, getLog, getNestedTransformer, getReflector, getReflector, getSourceClasses, getTransformableCallCache, getTransformerName, initialize, isAutomaticallyHandlingNulls, isCachingIsTransformableCalls, isImpreciseTransformation, isImpreciseTransformationImpl, isInitialized, isPerformingLogging, isTransformable, isTransformableImpl, isWrappingRuntimeExceptions, setCachingIsTransformableCalls, setInitialized, setLog, setNestedTransformer, setReflector, setTransformableCallCache, setTransformerName, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.morph.transform.DecoratedConverter

convert, equals, equals

Methods inherited from interface net.sf.morph.transform.Converter

convert

Methods inherited from interface net.sf.morph.transform.Transformer

getDestinationClasses, getSourceClasses

Methods inherited from interface net.sf.morph.transform.Transformer

getDestinationClasses, getSourceClasses

Methods inherited from interface net.sf.morph.transform.ExplicitTransformer

isTransformable

Constructor Detail

EvaluateExpressionConverter

public EvaluateExpressionConverter()

Create a new EvaluateExpressionConverter.

EvaluateExpressionConverter

public EvaluateExpressionConverter(java.lang.String expression)

Construct a new EvaluateExpressionConverter.

Parameters:

expression -

Method Detail

initializeImpl

protected void initializeImpl()
                       throws java.lang.Exception

Gives subclasses a chance to perform any computations needed to initialize the transformer.

Overrides:

initializeImpl in class BaseTransformer

Throws:

java.lang.Exception

See Also:

BaseTransformer.initializeImpl()

setDestinationClasses

public void setDestinationClasses(java.lang.Class[] destinationClasses)

Configures the destinationClasses property of this transformer. Note that this method should be called before the transformer is used. Otherwise, if another thread is in the middle of transforming an object graph and this method is called, the behavior of the transformer can change partway through the transformation.

Overrides:

setDestinationClasses in class BaseTransformer

Parameters:

destinationClasses - the new destinationClasses for this transformer

See Also:

BaseTransformer.setDestinationClasses(java.lang.Class[])

getDestinationClassesImpl

protected java.lang.Class[] getDestinationClassesImpl()
                                               throws java.lang.Exception

Transformer.getDestinationClasses() implementation template method.

Specified by:

getDestinationClassesImpl in class BaseTransformer

Returns:

Class[]

Throws:

java.lang.Exception

setSourceClasses

public void setSourceClasses(java.lang.Class[] sourceClasses)

Configures the sourceClasses property of this transformer. Note that this method should be called before the transformer is used. Otherwise, if another thread is in the middle of transforming an object graph and this method is called, the behavior of the transformer can change partway through the transformation.

Overrides:

setSourceClasses in class BaseTransformer

Parameters:

sourceClasses - the new sourceClasses for this transformer

See Also:

BaseTransformer.setSourceClasses(java.lang.Class[])

getSourceClassesImpl

protected java.lang.Class[] getSourceClassesImpl()
                                          throws java.lang.Exception

Transformer.getSourceClasses() implementation template method.

Specified by:

getSourceClassesImpl in class BaseTransformer

Returns:

Class[]

Throws:

java.lang.Exception

See Also:

BaseTransformer.getSourceClassesImpl()

convertImpl

protected java.lang.Object convertImpl(java.lang.Class destinationClass,
                                       java.lang.Object source,
                                       java.util.Locale locale)
                                throws java.lang.Exception

The implementation of the convert method, which may omit the invalid argument checks already performed by this base class. By default, this method creates a new instance of the destinationClass and copies information from the source to the destination. This implementation should be fine as-is for Copiers, but Converters will need to implement this method since they will not be implementing the copy method.

Overrides:

convertImpl in class BaseTransformer

locale - the locale in which the conversion should take place. for converters that are not locale-aware, the local argument can simply be ignored

Throws:

java.lang.Exception

getExpression

public java.lang.String getExpression()

Get the expression of this EvaluateExpressionConverter.

Returns:

the expression

setExpression

public void setExpression(java.lang.String expression)

Set the String expression.

Parameters:

expression - String

getLanguage

public DecoratedLanguage getLanguage()

Get the DecoratedLanguage language.

Returns:

DecoratedLanguage

setLanguage

public void setLanguage(DecoratedLanguage language)

Set the DecoratedLanguage language.

Parameters:

language - DecoratedLanguage