Package org.mapstruct.ap.internal.model.source

Class MethodMatcher

java.lang.Object

org.mapstruct.ap.internal.model.source.MethodMatcher

public class MethodMatcher
extends java.lang.Object

SourceMethodMatcher $8.4 of the JavaLanguage specification describes a method body as such:

 SourceMethodDeclaration: SourceMethodHeader SourceMethodBody
 SourceMethodHeader: SourceMethodModifiers TypeParameters Result SourceMethodDeclarator Throws
 SourceMethodDeclarator: Identifier ( FormalParameterList )

 example <T extends String & Serializable>  T   getResult(? extends T) throws Exception
         \-------------------------------/ \-/            \---------/
               TypeParameters             Result        ParameterList
 

Matches a given method with given ParameterList and Result type obeying the constraints in the TypeParameters block.

For more info on java-generics: http://www.javacodegeeks.com/2011/04/java-generics-quick-tutorial.html http://www.angelikalanger.com/GenericsFAQ/FAQSections/ParameterizedTypes.html

The following situations is not supported / tested:

1. Multiple bounds were the bound itself is again a generic type.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	MethodMatcher.GenericAnalyser
private static class	MethodMatcher.TypeVarCandidate

Field Summary

Fields

Modifier and Type	Field	Description
private SourceMethod	candidateMethod
private TypeFactory	typeFactory
private TypeUtils	typeUtils

Constructor Summary

Constructors

Constructor	Description
MethodMatcher(TypeUtils typeUtils, TypeFactory typeFactory, SourceMethod candidateMethod)

Method Summary

Modifier and Type	Method	Description
private boolean	isPrimitiveToObject(Type type, Type isAssignableTo)	Primitive to Object (Boxed Type) should be handled by a type conversion rather than a direct mapping Direct mapping runs the risk of null pointer exceptions: e.g.
(package private) boolean	matches(java.util.List<Type> sourceTypes, Type targetType)	Whether the given source and target types are matched by this matcher's candidate method.

Methods inherited from class java.lang.Object

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

Field Detail

candidateMethod

private final SourceMethod candidateMethod

typeUtils

private final TypeUtils typeUtils

typeFactory

private final TypeFactory typeFactory

Constructor Detail

MethodMatcher

MethodMatcher(TypeUtils typeUtils,
              TypeFactory typeFactory,
              SourceMethod candidateMethod)

Method Detail

matches

boolean matches(java.util.List<Type> sourceTypes,
                Type targetType)

Whether the given source and target types are matched by this matcher's candidate method.

Parameters:

sourceTypes - the source types

targetType - the target type

Returns:

true when both, source type and target types match the signature of this matcher's method; false otherwise.

isPrimitiveToObject

private boolean isPrimitiveToObject(Type type,
                                    Type isAssignableTo)

Primitive to Object (Boxed Type) should be handled by a type conversion rather than a direct mapping Direct mapping runs the risk of null pointer exceptions: e.g. in the assignment of Integer to int, Integer can be null.

Parameters:

type - the type to be assigned

isAssignableTo - the type to which @param type should be assignable to

Returns:

true if isAssignable is a primitive type and type is an object