org.mapstruct.ap.internal.model

Class MethodReference

java.lang.Object

org.mapstruct.ap.internal.writer.FreeMarkerWritable

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

org.mapstruct.ap.internal.model.MappingMethod

org.mapstruct.ap.internal.model.MethodReference

All Implemented Interfaces:

Assignment, Writable

public class MethodReference
extends MappingMethod
implements Assignment

Represents a reference to another method, e.g. used to map a bean property from source to target type or to instantiate the return value of a mapping method (rather than calling the new operator).

Author:

Gunnar Morling

Nested Class Summary

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

Assignment.AssignmentType

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

Writable.Context

Constructor Summary

Constructors

Constructor and Description
MethodReference(BuiltInMethod method, ConversionContext contextParam)
MethodReference(Method method, MapperReference declaringMapper, Type targetType) Creates a new reference to the given method.

Method Summary

Modifier and Type	Method and Description
Assignment	getAssignment()
String	getContextParam()
MapperReference	getDeclaringMapper()
Type	getDefiningType()
Set<Type>	getImportTypes() Returns a set containing those Types referenced by this model element for which an import statement needs to be declared.
String	getMapperVariableName()
Type	getSingleSourceParameterType()
String	getSourceLocalVarName() a local variable name for supporting a null check and avoiding executing a nested method forged method twice
String	getSourceReference() the source reference being a source-getter, a constant, nested method call, etc.
Type	getSourceType() the source type.
List<Type>	getThrownTypes() returns all types exception types thrown by this assignment.
Assignment.AssignmentType	getType() Returns whether the type of assignment
boolean	isUpdateMethod()
void	setAssignment(Assignment assignment) An assignment in itself can wrap another assignment.
void	setSourceLocalVarName(String sourceLocalVarName) Use sourceLocalVarName iso sourceReference

Methods inherited from class org.mapstruct.ap.internal.model.MappingMethod

getAccessibility, getAfterMappingReferences, getBeforeMappingReferencesWithMappingTarget, getBeforeMappingReferencesWithoutMappingTarget, getName, getParameterNames, getParameters, getResultName, getResultType, getReturnType, getSourceParameters, isExistingInstanceMapping, isStatic, toString

Methods inherited from class org.mapstruct.ap.internal.model.common.ModelElement

write

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

getTemplateName, getTemplateNameForClass

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodReference

public MethodReference(Method method,
                       MapperReference declaringMapper,
                       Type targetType)

Creates a new reference to the given method.

Parameters:

method - the target method of the reference

declaringMapper - the method declaring the mapper; null if the current mapper itself

targetType - in case the referenced method has a parameter for passing the target type, the given target type, otherwise null

MethodReference

public MethodReference(BuiltInMethod method,
                       ConversionContext contextParam)

Method Detail

getDeclaringMapper

public MapperReference getDeclaringMapper()

getMapperVariableName

public String getMapperVariableName()

getContextParam

public String getContextParam()

getAssignment

public Assignment getAssignment()

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

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

getSourceType

public Type getSourceType()

Description copied from interface: Assignment

the source type.

Specified by:

getSourceType in interface Assignment

Returns:

source type (can be null)

getSourceLocalVarName

public String getSourceLocalVarName()

Description copied from interface: Assignment

a local variable name for supporting a null check and avoiding executing a nested method forged method twice

Specified by:

getSourceLocalVarName in interface Assignment

Returns:

local variable name (can be null)

setSourceLocalVarName

public void setSourceLocalVarName(String sourceLocalVarName)

Description copied from interface: Assignment

Use sourceLocalVarName iso sourceReference

Specified by:

setSourceLocalVarName in interface Assignment

Parameters:

sourceLocalVarName - source local variable name

getSingleSourceParameterType

public Type getSingleSourceParameterType()

Returns:

the type of the single source parameter that is not the @TargetType parameter

getDefiningType

public Type getDefiningType()

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

Overrides:

getImportTypes in class MappingMethod

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

Overrides:

getThrownTypes in class MappingMethod

Returns:

exceptions thrown

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

isUpdateMethod

public boolean isUpdateMethod()

Specified by:

isUpdateMethod in interface Assignment