org.mapstruct.ap.util

Class SpecificCompilerWorkarounds

java.lang.Object

org.mapstruct.ap.util.SpecificCompilerWorkarounds

public class SpecificCompilerWorkarounds
extends Object

Contains workarounds for various quirks in specific compilers.

Author:

Sjaak Derksen, Andreas Gudian

Method Summary

Modifier and Type	Method and Description
static TypeMirror	erasure(Types types, TypeMirror t) Returns the erasure of a type.
static boolean	isSubType(Types types, TypeMirror t1, TypeMirror t2) Tests whether one type is a subtype of another.
static TypeElement	replaceTypeElementIfNecessary(Elements elementUtils, TypeElement element) When running during Eclipse Incremental Compilation, we might get a TypeElement that has an UnresolvedTypeBinding and which is not automatically resolved.

Methods inherited from class java.lang.Object

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

Method Detail

isSubType

public static boolean isSubType(Types types,
                                TypeMirror t1,
                                TypeMirror t2)

Tests whether one type is a subtype of another. Any type is considered to be a subtype of itself. Also see JLS section 4.10, Subtyping.

Work-around for a bug related to sub-typing in the Eclipse JSR 269 implementation.

Parameters:

types - the type utils

t1 - the first type

t2 - the second type

Returns:

true if and only if the first type is a subtype of the second

Throws:

IllegalArgumentException - if given an executable or package type

erasure

public static TypeMirror erasure(Types types,
                                 TypeMirror t)

Returns the erasure of a type.

Performs an additional test on the given type to check if it is not void. Calling Types.erasure(TypeMirror) with a void kind type will create a ClassCastException in Eclipse JDT. See the JLS, section 4.6 Type Erasure, for reference.

Parameters:

types - the type utils

t - the type to be erased

Returns:

the erasure of the given type

Throws:

IllegalArgumentException - if given a package type

replaceTypeElementIfNecessary

public static TypeElement replaceTypeElementIfNecessary(Elements elementUtils,
                                                        TypeElement element)

When running during Eclipse Incremental Compilation, we might get a TypeElement that has an UnresolvedTypeBinding and which is not automatically resolved. In that case, getEnclosedElements returns an empty list. We take that as a hint to check if the TypeElement resolved by FQN might have any enclosed elements and, if so, return the resolved element.

Parameters:

elementUtils - element utils

element - the original element

Returns:

the element freshly resolved using the qualified name, if the original element did not return any enclosed elements, whereas the resolved element does return enclosed elements.