org.mapstruct.ap.model.source.selector

Class QualifierSelector

java.lang.Object

org.mapstruct.ap.model.source.selector.QualifierSelector

All Implemented Interfaces:

MethodSelector

public class QualifierSelector
extends Object
implements MethodSelector

This selector selects a best match based on qualifiers name.

A method is said to be marked with a qualifier annotation if the class in which it resides is annotated with a qualifier annotation or if the method itself is annotated with a qualifier annotation or both.

Rules:

1. If a method is marked with a qualifier annotation, it does not contribute to a match otherwise and is hence removed from the list of potential mapping methods
2. If multiple qualifiers (qualifedBy) are specified, all should match to make a match.

Author:

Sjaak Derksen

Constructor Summary

Constructors

Constructor and Description
QualifierSelector(Types typeUtils, Elements elementUtils)

Method Summary

Modifier and Type	Method and Description
<T extends Method> List<T>	getMatchingMethods(Method mappingMethod, List<T> methods, Type parameterType, Type returnType, List<TypeMirror> qualifiers, String targetPropertyName) Selects those methods which match the given types and other criteria

Methods inherited from class java.lang.Object

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

Constructor Detail

QualifierSelector

public QualifierSelector(Types typeUtils,
                         Elements elementUtils)

Method Detail

getMatchingMethods

public <T extends Method> List<T> getMatchingMethods(Method mappingMethod,
                                                     List<T> methods,
                                                     Type parameterType,
                                                     Type returnType,
                                                     List<TypeMirror> qualifiers,
                                                     String targetPropertyName)

Description copied from interface: MethodSelector

Selects those methods which match the given types and other criteria

Specified by:

getMatchingMethods in interface MethodSelector

Type Parameters:

T - either SourceMethod or BuiltInMethod

Parameters:

mappingMethod - mapping method, defined in Mapper for which this selection is carried out

methods - list of available methods

parameterType - parameter type that should be matched

returnType - return type that should be matched

qualifiers - list of custom annotations, used in the qualifying process

targetPropertyName - some information can be derived from the target property

Returns:

list of methods that passes the matching process