org.mapstruct.ap.internal.model.source

Class ForgedMethod

java.lang.Object

org.mapstruct.ap.internal.model.source.ForgedMethod

All Implemented Interfaces:

Method

public class ForgedMethod
extends Object
implements Method

This method will be generated in absence of a suitable abstract method to implement.

Author:

Sjaak Derksen

Constructor Summary

Constructors

Constructor and Description
ForgedMethod(String name, ForgedMethod forgedMethod) creates a new ForgedMethod with the same arguments but with a new name
ForgedMethod(String name, Type sourceType, Type returnType, MapperConfiguration mapperConfiguration, ExecutableElement positionHintElement, List<Parameter> additionalParameters, ParameterProvidedMethods parameterProvidedMethods) Creates a new forged method with the given name.
ForgedMethod(String name, Type sourceType, Type returnType, MapperConfiguration mapperConfiguration, ExecutableElement positionHintElement, List<Parameter> additionalParameters, ParameterProvidedMethods parameterProvidedMethods, ForgedMethodHistory history, MappingOptions mappingOptions, boolean forgedNameBased) Creates a new forged method with the given name.

Method Summary

Modifier and Type	Method and Description
void	addThrownTypes(List<Type> thrownTypesToAdd)
boolean	equals(Object o)
Accessibility	getAccessibility() Returns the Accessibility of this method.
List<Parameter>	getContextParameters() returns the list of mapping context parameters, i.e. those parameters that are annotated with Context.
ParameterProvidedMethods	getContextProvidedMethods()
Type	getDeclaringMapper() Returns the mapper type declaring this method if it is not declared by the mapper interface currently processed but by another mapper imported via Mapper#users().
Type	getDefiningType()
ExecutableElement	getExecutable()
ForgedMethodHistory	getHistory()
MapperConfiguration	getMapperConfiguration()
MappingOptions	getMappingOptions()
Parameter	getMappingTargetParameter() Returns the parameter designated as mapping target (if present) MappingTarget
String	getName() Returns then name of the method.
List<String>	getParameterNames()
List<Parameter>	getParameters() In contrast to Method.getSourceParameters() this method returns all parameters
Type	getResultType() Returns the type of the result.
Type	getReturnType() Returns the return type of the method
List<Parameter>	getSourceParameters() returns the list of 'true' source parameters excluding the parameter(s) that are designated as target, target type or context parameter.
Parameter	getTargetTypeParameter() Returns the parameter designated as target type (if present) TargetType
List<Type>	getThrownTypes() Returns all exceptions thrown by this method
int	hashCode()
boolean	isDefault() Whether this method is Java 8 default method
boolean	isForgedNamedBased()
boolean	isLifecycleCallbackMethod()
boolean	isObjectFactory() object factory mechanism not supported for forged methods
boolean	isStatic() Whether this method is static or an instance method
boolean	isUpdateMethod()
boolean	matches(List<Type> sourceTypes, Type targetType) Checks whether the provided sourceType and provided targetType match with the parameter respectively return type of the method.
boolean	overridesMethod() Whether this method overrides an abstract method.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.mapstruct.ap.internal.model.source.Method

isMappingTargetAssignableToReturnType

Constructor Detail

ForgedMethod

public ForgedMethod(String name,
                    Type sourceType,
                    Type returnType,
                    MapperConfiguration mapperConfiguration,
                    ExecutableElement positionHintElement,
                    List<Parameter> additionalParameters,
                    ParameterProvidedMethods parameterProvidedMethods)

Creates a new forged method with the given name.

Parameters:

name - the (unique name) for this method

sourceType - the source type

returnType - the return type.

mapperConfiguration - the mapper configuration

positionHintElement - element used to for reference to the position in the source file.

additionalParameters - additional parameters to add to the forged method

parameterProvidedMethods - additional factory/lifecycle methods to consider that are provided by context parameters

ForgedMethod

public ForgedMethod(String name,
                    Type sourceType,
                    Type returnType,
                    MapperConfiguration mapperConfiguration,
                    ExecutableElement positionHintElement,
                    List<Parameter> additionalParameters,
                    ParameterProvidedMethods parameterProvidedMethods,
                    ForgedMethodHistory history,
                    MappingOptions mappingOptions,
                    boolean forgedNameBased)

Creates a new forged method with the given name.

Parameters:

name - the (unique name) for this method

sourceType - the source type

returnType - the return type.

mapperConfiguration - the mapper configuration

positionHintElement - element used to for reference to the position in the source file.

additionalParameters - additional parameters to add to the forged method

parameterProvidedMethods - additional factory/lifecycle methods to consider that are provided by context parameters

history - a parent forged method if this is a forged method within a forged method

mappingOptions - the mapping options for this method

forgedNameBased - forges a name based (matched) mapping method

ForgedMethod

public ForgedMethod(String name,
                    ForgedMethod forgedMethod)

creates a new ForgedMethod with the same arguments but with a new name

Parameters:

name - the new name

forgedMethod - existing forge method

Method Detail

matches

public boolean matches(List<Type> sourceTypes,
                       Type targetType)

Description copied from interface: Method

Checks whether the provided sourceType and provided targetType match with the parameter respectively return type of the method. The check also should incorporate wild card and generic type variables

Specified by:

matches in interface Method

Parameters:

sourceTypes - the sourceTypes to match to the parameter

targetType - the targetType to match to the returnType

Returns:

true when match

getDeclaringMapper

public Type getDeclaringMapper()

Description copied from interface: Method

Returns the mapper type declaring this method if it is not declared by the mapper interface currently processed but by another mapper imported via Mapper#users().

Specified by:

getDeclaringMapper in interface Method

Returns:

The declaring mapper type

getName

public String getName()

Description copied from interface: Method

Returns then name of the method.

Specified by:

getName in interface Method

Returns:

method name

getParameters

public List<Parameter> getParameters()

Description copied from interface: Method

In contrast to Method.getSourceParameters() this method returns all parameters

Specified by:

getParameters in interface Method

Returns:

all parameters

getSourceParameters

public List<Parameter> getSourceParameters()

Description copied from interface: Method

returns the list of 'true' source parameters excluding the parameter(s) that are designated as target, target type or context parameter.

Specified by:

getSourceParameters in interface Method

Returns:

list of 'true' source parameters

getContextParameters

public List<Parameter> getContextParameters()

Description copied from interface: Method

returns the list of mapping context parameters, i.e. those parameters that are annotated with Context.

Specified by:

getContextParameters in interface Method

Returns:

list of context parameters

getContextProvidedMethods

public ParameterProvidedMethods getContextProvidedMethods()

Specified by:

getContextProvidedMethods in interface Method

Returns:

a mapping between Method.getContextParameters() to factory and lifecycle methods provided by them.

getMappingTargetParameter

public Parameter getMappingTargetParameter()

Description copied from interface: Method

Returns the parameter designated as mapping target (if present) MappingTarget

Specified by:

getMappingTargetParameter in interface Method

Returns:

mapping target parameter (when present) null otherwise.

getTargetTypeParameter

public Parameter getTargetTypeParameter()

Description copied from interface: Method

Returns the parameter designated as target type (if present) TargetType

Specified by:

getTargetTypeParameter in interface Method

Returns:

target type parameter (when present) null otherwise.

getAccessibility

public Accessibility getAccessibility()

Description copied from interface: Method

Returns the Accessibility of this method.

Specified by:

getAccessibility in interface Method

Returns:

the Accessibility of this method

getReturnType

public Type getReturnType()

Description copied from interface: Method

Returns the return type of the method

Specified by:

getReturnType in interface Method

Returns:

return type

getThrownTypes

public List<Type> getThrownTypes()

Description copied from interface: Method

Returns all exceptions thrown by this method

Specified by:

getThrownTypes in interface Method

Returns:

exceptions thrown

getHistory

public ForgedMethodHistory getHistory()

isForgedNamedBased

public boolean isForgedNamedBased()

addThrownTypes

public void addThrownTypes(List<Type> thrownTypesToAdd)

getResultType

public Type getResultType()

Description copied from interface: Method

Returns the type of the result. The result is defined as the type of the parameter designated with MappingTarget, or in absence the return type.

Specified by:

getResultType in interface Method

Returns:

result type

getParameterNames

public List<String> getParameterNames()

Specified by:

getParameterNames in interface Method

Returns:

the names of the parameters of this mapping method

overridesMethod

public boolean overridesMethod()

Description copied from interface: Method

Whether this method overrides an abstract method.

Specified by:

overridesMethod in interface Method

Returns:

true when an abstract method is overridden.

getExecutable

public ExecutableElement getExecutable()

Specified by:

getExecutable in interface Method

isLifecycleCallbackMethod

public boolean isLifecycleCallbackMethod()

Specified by:

isLifecycleCallbackMethod in interface Method

Returns:

true, if the method represents a mapping lifecycle callback (Before/After mapping method)

toString

public String toString()

Overrides:

toString in class Object

isStatic

public boolean isStatic()

Description copied from interface: Method

Whether this method is static or an instance method

Specified by:

isStatic in interface Method

Returns:

true when static.

isDefault

public boolean isDefault()

Description copied from interface: Method

Whether this method is Java 8 default method

Specified by:

isDefault in interface Method

Returns:

true when Java 8 default method

getDefiningType

public Type getDefiningType()

Specified by:

getDefiningType in interface Method

Returns:

the Type (class or interface) that defines this method.

getMapperConfiguration

public MapperConfiguration getMapperConfiguration()

Specified by:

getMapperConfiguration in interface Method

Returns:

the mapper config when this method needs to be implemented

isUpdateMethod

public boolean isUpdateMethod()

Specified by:

isUpdateMethod in interface Method

Returns:

true, if the method is an update method, i.e. it has a parameter annotated with @MappingTarget.

isObjectFactory

public boolean isObjectFactory()

object factory mechanism not supported for forged methods

Specified by:

isObjectFactory in interface Method

Returns:

false

getMappingOptions

public MappingOptions getMappingOptions()

Specified by:

getMappingOptions in interface Method

Returns:

the mapping options for this method

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object