Given a parameterized type and a generic type information, aligns actual type parameters. For example, if a class uses generic type

<T,U,V>

<java.lang.String, U,V>

<T,V>

<java.lang.String,V>

Parameters

redirectGenericTypes:GenericsType[]

the type arguments or the redirect class node

parameterizedTypes:GenericsType[]

the actual type arguments used on this class node

alignmentTarget:GenericsType[]

the generic type arguments to which we want to align to

Returns:GenericsType[]

aligned type arguments

Annotations

@Deprecated

Transforms generics types from an old context to a new context using the given spec. This method assumes all generics types will be placeholders.

Parameters

genericsSpec:Map<String, ClassNode>

the generics context information spec

oldPlaceHolders:GenericsType[]

the old placeholders

Returns:GenericsType[]

the new generics types

Generates a wildcard generic type in order to be used for checks against class nodes. See GenericsType#isCompatibleWith(ClassNode).

Clears the parameterized type cache.

It is useful to IDE as the type being compiled are continuously being edited/altered, see GROOVY-8675

Since

2.4.1

Returns the type parameter/argument relationships of the specified type.

Parameters

type:ClassNode

the class node to check

Populates the supplied map with the type parameter/argument relationships of the specified type.

Parameters

type:ClassNode

the class node to check

placeholders:Map<GenericsType.GenericsTypeName, GenericsType>

the generics type information collector

Gets the actual type according to the placeholder name.

Parameters

placeholderName:String

the placeholder name (i.e. "T", "E", etc.)

genericsPlaceholderAndTypeMap:Map<GenericsType, GenericsType>

the result of makeDeclaringAndActualGenericsTypeMap(ClassNode, ClassNode)

Convenience method for findParameterizedType(ClassNode, ClassNode, boolean) when tryToFindExactType is false.

Gets the parameterized type by searching the whole class hierarchy according to generics class and actual receiver.

findParameterizedTypeFromCache(ClassNode, ClassNode, boolean) is strongly recommended for better performance.

Convenience method for findParameterizedTypeFromCache(ClassNode, ClassNode, boolean) when the tryToFindExactType boolean is false.

Try to get the parameterized type from the cache.

If no cached item found, cache and return the result of findParameterizedType(ClassNode, ClassNode, boolean)

Checks if the type has any non-placeholder (aka resolved) generics.

Since

3.0.0

Checks if the type has any placeholder (aka unresolved) generics.

Since

3.0.0

Checks for any placeholder (aka unresolved) generics.

map declaring generics type to actual generics type, e.g. GROOVY-7204: declaring generics types: T, S extends Serializable actual generics types : String, Long the result map is [ T: String, S: Long ] The resolved types can not help us to choose methods correctly if the argument is a string: T: Object, S: Serializable so we need actual types: T: String, S: Long

The method is similar with GenericsUtils#makeDeclaringAndActualGenericsTypeMap(ClassNode, ClassNode), The main difference is that the method will try to map all placeholders found to the relevant exact types, but the other will not try even if the parameterized type has placeholders

Parameters

declaringClass:ClassNode

the generics class node declaring the generics types

actualReceiver:ClassNode

the subclass class node

Returns:Map<GenericsType, GenericsType>

the placeholder-to-actualtype mapping

Since

3.0.0

Interface class nodes retrieved from org.codehaus.groovy.ast.ClassNode#getInterfaces() or org.codehaus.groovy.ast.ClassNode#getAllInterfaces() are returned with generic type arguments. This method allows returning a parameterized interface given the parameterized class node which implements this interface.

Parameters

hint:ClassNode

the class node where generics types are parameterized

target:ClassNode

the interface we want to parameterize generics types

Returns:ClassNode

a parameterized interface class node

Annotations

@Deprecated

Gets the parameter and return types of the abstract method of SAM. If the abstract method is not parameterized, we will get generics placeholders, e.g. T, U For example, the abstract method of java.util.function.Function is

     R apply(T t);

     Integer apply(String t);

Parameters

samType:ClassNode

the class node which contains only one abstract method

Since

3.0.0

Interface class nodes retrieved from org.codehaus.groovy.ast.ClassNode#getInterfaces() or org.codehaus.groovy.ast.ClassNode#getAllInterfaces() are returned with generic type arguments. This method allows returning a parameterized interface given the parameterized class node which implements this interface.

Parameters

hint:ClassNode

the ClassNode where generics types are parameterized

target:ClassNode

the interface we want to parameterize generics types

Returns:ClassNode

a parameterized interface ClassNode