org.mapstruct.ap.processor.creation

Class MappingResolver

java.lang.Object

org.mapstruct.ap.processor.creation.MappingResolver

public class MappingResolver
extends java.lang.Object

Resolves class is responsible for resolving the most suitable way to resolve a mapping from source to target. There are 2 basic types of mappings:

• conversions
• methods

conversions are essentially one line mappings, such as String to Integer and Integer to Long methods come in some varieties:

• referenced mapping methods, these are methods implemented (or referenced) by the user. Sometimes indicated with the 'uses' in the mapping annotations or part of the abstract mapper class
• generated mapping methods (by means of MapStruct)
• built in methods

Author:

Sjaak Derksen

Constructor Summary

Constructors

Constructor and Description
MappingResolver(javax.annotation.processing.Messager messager, TypeFactory typeFactory, javax.lang.model.util.Elements elementUtils, javax.lang.model.util.Types typeUtils)

Method Summary

Modifier and Type	Method and Description
Assignment	getTargetAssignment(SourceMethod mappingMethod, java.lang.String mappedElement, java.util.List<MapperReference> mapperReferences, java.util.List<SourceMethod> methods, Type sourceType, Type targetType, java.lang.String targetPropertyName, java.lang.String dateFormat, java.lang.String sourceReference) returns a parameter assignment
java.util.Set<VirtualMappingMethod>	getVirtualMethodsToGenerate()

Methods inherited from class java.lang.Object

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

Constructor Detail

MappingResolver

public MappingResolver(javax.annotation.processing.Messager messager,
                       TypeFactory typeFactory,
                       javax.lang.model.util.Elements elementUtils,
                       javax.lang.model.util.Types typeUtils)

Method Detail

getTargetAssignment

public Assignment getTargetAssignment(SourceMethod mappingMethod,
                                      java.lang.String mappedElement,
                                      java.util.List<MapperReference> mapperReferences,
                                      java.util.List<SourceMethod> methods,
                                      Type sourceType,
                                      Type targetType,
                                      java.lang.String targetPropertyName,
                                      java.lang.String dateFormat,
                                      java.lang.String sourceReference)

returns a parameter assignment

Parameters:

mappingMethod - target mapping method

mappedElement - used for error messages

mapperReferences - list of references to mapper

methods - list of candidate methods

sourceType - parameter to match

targetType - return type to match

targetPropertyName - name of the target property

dateFormat - used for formatting dates in build in methods that need context information

sourceReference - call to source type as string

Returns:

an assignment to a method parameter, which can either be:

1. MethodReference
2. TypeConversion
3. Direct Assignment (empty TargetAssignment)
4. null, no assignment found

getVirtualMethodsToGenerate

public java.util.Set<VirtualMappingMethod> getVirtualMethodsToGenerate()