Package org.mapstruct.ap.internal.model.assignment

Class AssignmentWrapper

java.lang.Object

org.mapstruct.ap.internal.writer.FreeMarkerWritable

org.mapstruct.ap.internal.model.common.ModelElement

org.mapstruct.ap.internal.model.assignment.AssignmentWrapper

All Implemented Interfaces:

Assignment, Writable

Direct Known Subclasses:

AdderWrapper, ArrayCopyWrapper, EnumConstantWrapper, Java8FunctionWrapper, LocalVarWrapper, ReturnWrapper, SetterWrapper, StreamAdderWrapper, UpdateWrapper, WrapperForCollectionsAndMaps

public abstract class AssignmentWrapper
extends ModelElement
implements Assignment

Base class for decorators (wrappers). Decorator pattern is used to decorate assignments.

Author:

Sjaak Derksen

Nested Class Summary

Nested classes/interfaces inherited from interface org.mapstruct.ap.internal.model.common.Assignment

Assignment.AssignmentType

Nested classes/interfaces inherited from interface org.mapstruct.ap.internal.writer.Writable

Writable.Context

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	fieldAssignment

Constructor Summary

Constructors

Constructor	Description
AssignmentWrapper(Assignment decoratedAssignment, boolean fieldAssignment)

Method Summary

Modifier and Type	Method	Description
String	createUniqueVarName(String desiredName)	Creates an unique safe (local) variable name.
Assignment	getAssignment()
Set<Type>	getImportTypes()	Returns a set containing those Types referenced by this model element for which an import statement needs to be declared.
String	getSourceLocalVarName()	See Assignment.setSourceLocalVarName(java.lang.String)
String	getSourceLoopVarName()	See Assignment.getSourceLoopVarName() (java.lang.String) }
String	getSourceParameterName()	Returns the source parameter name, to which this assignment applies.
PresenceCheck	getSourcePresenceCheckerReference()	the source presence checker reference
String	getSourceReference()	the source reference being a source-getter, a constant, nested method call, etc.
Type	getSourceType()	the source type used in the matching process
List<Type>	getThrownTypes()	returns all types exception types thrown by this assignment.
Assignment.AssignmentType	getType()	Returns whether the type of assignment
boolean	isCallingUpdateMethod()
boolean	isFieldAssignment()
boolean	isSourceReferenceParameter()
void	setAssignment(Assignment assignment)	An assignment in itself can wrap another assignment.
void	setSourceLocalVarName(String sourceLocalVarName)	Replaces the sourceReference at the call site in the assignment in the template with this sourceLocalVarName.
void	setSourceLoopVarName(String sourceLoopVarName)	Replaces the sourceLocalVar or sourceReference at the call site in the assignment in the template with this sourceLoopVarName.

Methods inherited from class org.mapstruct.ap.internal.writer.FreeMarkerWritable

getTemplateName, getTemplateNameForClass, write

Methods inherited from class java.lang.Object

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

Field Detail

fieldAssignment

protected final boolean fieldAssignment

Constructor Detail

AssignmentWrapper

public AssignmentWrapper(Assignment decoratedAssignment,
                         boolean fieldAssignment)

Method Detail

getImportTypes

public Set<Type> getImportTypes()

Description copied from class: ModelElement

Returns a set containing those Types referenced by this model element for which an import statement needs to be declared.

Specified by:

getImportTypes in interface Assignment

Specified by:

getImportTypes in class ModelElement

Returns:

A set with type referenced by this model element. Must not be null.

getThrownTypes

public List<Type> getThrownTypes()

Description copied from interface: Assignment

returns all types exception types thrown by this assignment.

Specified by:

getThrownTypes in interface Assignment

Returns:

exceptions thrown

setAssignment

public void setAssignment(Assignment assignment)

Description copied from interface: Assignment

An assignment in itself can wrap another assignment. E.g.:

• a MethodReference can wrap a TypeConversion, another MethodReference and ultimately a Simple
• a TypeConversion can wrap a MethodReference, and ultimately a Simple

Specified by:

setAssignment in interface Assignment

Parameters:

assignment - the assignment to set

getAssignment

public Assignment getAssignment()

getSourceReference

public String getSourceReference()

Description copied from interface: Assignment

the source reference being a source-getter, a constant, nested method call, etc.

Specified by:

getSourceReference in interface Assignment

Returns:

source reference

isSourceReferenceParameter

public boolean isSourceReferenceParameter()

Specified by:

isSourceReferenceParameter in interface Assignment

Returns:

true when the source reference is the source parameter (and not a property of the source parameter type)

getSourcePresenceCheckerReference

public PresenceCheck getSourcePresenceCheckerReference()

Description copied from interface: Assignment

the source presence checker reference

Specified by:

getSourcePresenceCheckerReference in interface Assignment

Returns:

source reference

getSourceType

public Type getSourceType()

Description copied from interface: Assignment

the source type used in the matching process

Specified by:

getSourceType in interface Assignment

Returns:

source type (can be null)

getSourceLocalVarName

public String getSourceLocalVarName()

Description copied from interface: Assignment

See Assignment.setSourceLocalVarName(java.lang.String)

Specified by:

getSourceLocalVarName in interface Assignment

Returns:

local variable name (can be null if not set)

setSourceLocalVarName

public void setSourceLocalVarName(String sourceLocalVarName)

Description copied from interface: Assignment

Replaces the sourceReference at the call site in the assignment in the template with this sourceLocalVarName. The sourceLocalVarName can subsequently be used for e.g. null checking.

Specified by:

setSourceLocalVarName in interface Assignment

Parameters:

sourceLocalVarName - source local variable name

getSourceLoopVarName

public String getSourceLoopVarName()

Description copied from interface: Assignment

See Assignment.getSourceLoopVarName() (java.lang.String) }

Specified by:

getSourceLoopVarName in interface Assignment

Returns:

loop variable (can be null if not set)

setSourceLoopVarName

public void setSourceLoopVarName(String sourceLoopVarName)

Description copied from interface: Assignment

Replaces the sourceLocalVar or sourceReference at the call site in the assignment in the template with this sourceLoopVarName. The sourceLocalVar can subsequently be used for e.g. null checking.

Specified by:

setSourceLoopVarName in interface Assignment

Parameters:

sourceLoopVarName - loop variable

getSourceParameterName

public String getSourceParameterName()

Description copied from interface: Assignment

Returns the source parameter name, to which this assignment applies. Note: the source parameter itself might be mapped by this assignment, or one of its properties

Specified by:

getSourceParameterName in interface Assignment

Returns:

the source parameter name

getType

public Assignment.AssignmentType getType()

Description copied from interface: Assignment

Returns whether the type of assignment

Specified by:

getType in interface Assignment

Returns:

Assignment.AssignmentType

isCallingUpdateMethod

public boolean isCallingUpdateMethod()

Specified by:

isCallingUpdateMethod in interface Assignment

createUniqueVarName

public String createUniqueVarName(String desiredName)

Description copied from interface: Assignment

Creates an unique safe (local) variable name.

Specified by:

createUniqueVarName in interface Assignment

Parameters:

desiredName - the desired name

Returns:

the desired name, made unique in the scope of the bean mapping.

isFieldAssignment

public boolean isFieldAssignment()

Returns:

true if the wrapper is for field assignment