org.mapstruct.ap.internal.model.source.selector

Class QualifierSelector

java.lang.Object

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

public class QualifierSelector
extends Object

This selector selects a best match based on qualifier annotations.

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 no qualifiers are requested in the selection criteria, then only candidate methods without any qualifier annotations remain in the list of potential candidates
2. If multiple qualifiers (qualifedBy) are specified, then all of them need to be present at a candidate for it to match.
3. If no candidate matches the required qualifiers, then all candidates are returned.

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<SelectedMethod<T>>	getMatchingMethods(Method mappingMethod, List<SelectedMethod<T>> methods, List<Type> sourceTypes, Type targetType, SelectionCriteria criteria) 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<SelectedMethod<T>> getMatchingMethods(Method mappingMethod,
                                                                     List<SelectedMethod<T>> methods,
                                                                     List<Type> sourceTypes,
                                                                     Type targetType,
                                                                     SelectionCriteria criteria)

Selects those methods which match the given types and other criteria

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

sourceTypes - parameter type(s) that should be matched

targetType - result type that should be matched

criteria - criteria used in the selection process

Returns:

list of methods that passes the matching process