Package io.micronaut.ast.groovy.visitor

Class GroovyClassElement

java.lang.Object

io.micronaut.inject.ast.annotation.AbstractAnnotationElement

io.micronaut.ast.groovy.visitor.AbstractGroovyElement

io.micronaut.ast.groovy.visitor.GroovyClassElement

All Implemented Interfaces:

AnnotatedElement, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, Described, Named, MutableAnnotationMetadataDelegate<Element>, ArrayableClassElement, ClassElement, Element, TypedElement

@Internal
public class GroovyClassElement
extends AbstractGroovyElement
implements ArrayableClassElement

A class element returning data from a ClassNode.

Since:

1.0

Author:

James Kleeh, Denis Stepanov

Field Summary

Fields

Modifier and Type	Field	Description
protected final org.codehaus.groovy.ast.ClassNode	classNode
protected Map<String,ClassElement>	resolvedTypeArguments

Fields inherited from class io.micronaut.ast.groovy.visitor.AbstractGroovyElement

compilationUnit, sourceUnit, visitorContext

Fields inherited from class io.micronaut.inject.ast.annotation.AbstractAnnotationElement

elementAnnotationMetadataFactory, presetAnnotationMetadata

Fields inherited from interface io.micronaut.core.annotation.AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface io.micronaut.core.annotation.AnnotationSource

EMPTY

Fields inherited from interface io.micronaut.inject.ast.ClassElement

ZERO_CLASS_ELEMENTS

Fields inherited from interface io.micronaut.inject.ast.Element

EMPTY_ELEMENT_ARRAY

Fields inherited from interface io.micronaut.inject.ast.annotation.MutableAnnotationMetadataDelegate

EMPTY

Constructor Summary

Constructors

Constructor	Description
GroovyClassElement(GroovyVisitorContext visitorContext, GroovyNativeElement nativeElement, ElementAnnotationMetadataFactory annotationMetadataFactory)

Method Summary

Modifier and Type	Method	Description
protected @NonNull GroovyClassElement	copyConstructor()	Constructs this element by invoking the constructor.
@NonNull AnnotationMetadata	getAnnotationMetadata()	Supplies the metadata.
protected MutableAnnotationMetadataDelegate<?>	getAnnotationMetadataToWrite()	Get annotation metadata to add or remove annotations.
int	getArrayDimensions()	If the type is an array, the number of dimensions.
@NonNull List<PropertyElement>	getBeanProperties()	Returns the bean properties (getters and setters) for this class element.
@NonNull List<PropertyElement>	getBeanProperties(@NonNull PropertyElementQuery propertyElementQuery)	Returns the bean properties (getters and setters) for this class element based on custom configuration.
@NonNull List<? extends ClassElement>	getBoundGenericTypes()	The list of type arguments bound to this type, or an empty list if there are no type arguments or this is a raw type.
@NonNull List<? extends GenericPlaceholderElement>	getDeclaredGenericPlaceholders()	The type arguments declared on the raw class.
Optional<MethodElement>	getDefaultConstructor()	Find and return a single default constructor.
<T extends Element> @NonNull List<T>	getEnclosedElements(@NonNull ElementQuery<T> query)	Return the elements that match the given query.
Optional<ClassElement>	getEnclosingType()	Returns the enclosing type if ClassElement.isInner() return true.
Collection<ClassElement>	getInterfaces()
Set<ElementModifier>	getModifiers()
@NonNull String	getName()
Optional<ClassElement>	getOptionalValueType()	Gets optional value type.
PackageElement	getPackage()	The package name.
String	getPackageName()	The package name.
@NonNull Optional<MethodElement>	getPrimaryConstructor()	Find and return a single primary constructor.
@NonNull String	getSimpleName()	The simple name without the package name.
final <T extends Element> List<T>	getSourceEnclosedElements(@NonNull ElementQuery<T> query)	This method will produce th elements just like getEnclosedElements(ElementQuery) but the elements are constructed as the source ones.
Optional<ClassElement>	getSuperType()	Returns the super type of this element or empty if the element has no super type.
@NonNull List<PropertyElement>	getSyntheticBeanProperties()	Returns the synthetic bean properties.
@NonNull ClassElement	getType()
@NonNull MutableAnnotationMetadataDelegate<AnnotationMetadata>	getTypeAnnotationMetadata()	Returns the type annotations.
@NonNull Map<String,ClassElement>	getTypeArguments()
boolean	isAbstract()
boolean	isArray()	Is the type an array.
boolean	isAssignable(ClassElement type)	Tests whether one type is assignable to another.
boolean	isAssignable(String type)	Tests whether one type is assignable to another.
boolean	isFinal()
boolean	isInner()	Is this type an inner class.
boolean	isInterface()
boolean	isPrimitive()	Whether the type is primitive.
boolean	isPrivate()
boolean	isProtected()
boolean	isPublic()
boolean	isRecord()
boolean	isStatic()
boolean	isTypeVariable()	In this case of calling ClassElement.getTypeArguments() a returned ClassElement may represent a type variable in which case this method will return true.
String	toString()
ClassElement	withAnnotationMetadata(AnnotationMetadata annotationMetadata)	Copies this element and overrides its annotations.
ClassElement	withArrayDimensions(int arrayDimensions)	Convert the class element to an element for the same type, but with the given number of array dimensions.
final @NonNull ClassElement	withTypeArguments(@NonNull Collection<ClassElement> typeArguments)	Copies this element and overrides its type arguments.
@NonNull ClassElement	withTypeArguments(Map<String,ClassElement> typeArguments)	Copies this element and overrides its type arguments.

Methods inherited from class io.micronaut.ast.groovy.visitor.AbstractGroovyElement

copy, copyValues, equals, getDocumentation, getNativeType, hashCode, isPackagePrivate, newClassElement, newClassElement, newClassElement, resolveClassTypeArguments, resolveMethodTypeArguments, resolveModifiers, resolveModifiers, resolveModifiers, resolveTypeArgumentsToObject

Methods inherited from class io.micronaut.inject.ast.annotation.AbstractAnnotationElement

annotate, annotate, annotate, annotate, annotate, getElementAnnotationMetadata, getElementAnnotationMetadataFactory, removeAnnotation, removeAnnotation, removeAnnotationIf, removeStereotype, removeStereotype

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.micronaut.core.annotation.AnnotatedElement

isDeclaredNonNull, isDeclaredNullable, isNonNull, isNullable

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadata

enumValuesSet, enumValuesSet, getValues, hasDeclaredStereotype, hasEvaluatedExpressions, hasStereotypeNonRepeating, isAnnotationPresent, isDeclaredAnnotationPresent

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadataDelegate

booleanValue, booleanValue, booleanValue, booleanValue, classValue, classValue, classValue, classValue, classValues, classValues, classValues, classValues, copyAnnotationMetadata, doubleValue, doubleValue, doubleValue, enumValue, enumValue, enumValue, enumValue, enumValues, enumValues, enumValues, enumValues, findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, findRepeatableAnnotation, findRepeatableAnnotation, getAnnotation, getAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNames, getAnnotationNamesByStereotype, getAnnotationNamesByStereotype, getAnnotationType, getAnnotationType, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationValuesByName, getAnnotationValuesByStereotype, getAnnotationValuesByType, getDeclaredAnnotation, getDeclaredAnnotation, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNames, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationValuesByName, getDeclaredAnnotationValuesByType, getDeclaredMetadata, getDeclaredStereotypeAnnotationNames, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValues, getStereotypeAnnotationNames, getTargetAnnotationMetadata, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, getValues, hasAnnotation, hasAnnotation, hasDeclaredAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasDeclaredStereotype, hasPropertyExpressions, hasSimpleAnnotation, hasSimpleDeclaredAnnotation, hasStereotype, hasStereotype, hasStereotype, hasStereotype, intValue, intValue, intValue, isAnnotationPresent, isDeclaredAnnotationPresent, isEmpty, isFalse, isFalse, isPresent, isPresent, isRepeatableAnnotation, isRepeatableAnnotation, isTrue, isTrue, longValue, longValue, stringValue, stringValue, stringValue, stringValue, stringValues, stringValues, stringValues, stringValues, synthesize, synthesize, synthesizeAll, synthesizeAnnotationsByType, synthesizeDeclared, synthesizeDeclared, synthesizeDeclared, synthesizeDeclaredAnnotationsByType

Methods inherited from interface io.micronaut.inject.ast.ArrayableClassElement

fromArray, toArray

Methods inherited from interface io.micronaut.inject.ast.ClassElement

addAssociatedBean, findDefaultStaticCreator, findField, findMethod, findStaticCreator, foldBoundGenericTypes, getAccessibleConstructors, getAccessibleStaticCreators, getAllTypeArguments, getCanonicalName, getEnclosedElement, getFields, getFirstTypeArgument, getMethods, getRawClassElement, getTypeArguments, getTypeArguments, hasUnresolvedTypes, isAssignable, isContainerType, isEnum, isGenericPlaceholder, isIterable, isOptional, isProxy, isRawType, isWildcard, withBoundGenericTypes

Methods inherited from interface io.micronaut.inject.ast.Element

annotate, annotate, annotate, annotate, annotate, getDescription, getDescription, getDocumentation, getNativeType, isPackagePrivate, isSynthetic, removeAnnotation, removeAnnotation, removeAnnotationIf, removeStereotype, removeStereotype

Methods inherited from interface io.micronaut.inject.ast.TypedElement

getGenericType, isVoid

Field Details

classNode

protected final org.codehaus.groovy.ast.ClassNode classNode

resolvedTypeArguments

protected Map<String,ClassElement> resolvedTypeArguments

Constructor Details

GroovyClassElement

public GroovyClassElement(GroovyVisitorContext visitorContext,
 GroovyNativeElement nativeElement,
 ElementAnnotationMetadataFactory annotationMetadataFactory)

Parameters:

visitorContext - The visitor context

nativeElement - The native element

annotationMetadataFactory - The annotation metadata

Method Details

copyConstructor

@NonNull
protected @NonNull GroovyClassElement copyConstructor()

Description copied from class: AbstractGroovyElement

Constructs this element by invoking the constructor.

Specified by:

copyConstructor in class AbstractGroovyElement

Returns:

the copy

getAnnotationMetadata

@NonNull
public @NonNull AnnotationMetadata getAnnotationMetadata()

Description copied from interface: AnnotationMetadataProvider

Supplies the metadata. Defaults to AnnotationMetadata.EMPTY_METADATA.

Specified by:

getAnnotationMetadata in interface AnnotationMetadataProvider

Overrides:

getAnnotationMetadata in class AbstractAnnotationElement

Returns:

The AnnotationMetadata

getAnnotationMetadataToWrite

protected MutableAnnotationMetadataDelegate<?> getAnnotationMetadataToWrite()

Description copied from class: AbstractAnnotationElement

Get annotation metadata to add or remove annotations.

Overrides:

getAnnotationMetadataToWrite in class AbstractAnnotationElement

Returns:

The annotation metadata to write

withAnnotationMetadata

public ClassElement withAnnotationMetadata(AnnotationMetadata annotationMetadata)

Description copied from interface: Element

Copies this element and overrides its annotations.

Specified by:

withAnnotationMetadata in interface ClassElement

Specified by:

withAnnotationMetadata in interface Element

Overrides:

withAnnotationMetadata in class AbstractGroovyElement

Parameters:

annotationMetadata - The annotation metadata

Returns:

A new element

withTypeArguments

@NonNull
public @NonNull ClassElement withTypeArguments(Map<String,ClassElement> typeArguments)

Description copied from interface: ClassElement

Copies this element and overrides its type arguments.

Specified by:

withTypeArguments in interface ClassElement

Parameters:

typeArguments - The type arguments

Returns:

A new element

withTypeArguments

@NonNull
public final @NonNull ClassElement withTypeArguments(@NonNull
 @NonNull Collection<ClassElement> typeArguments)

Description copied from interface: ClassElement

Copies this element and overrides its type arguments. Variation of ClassElement.withTypeArguments(Map) that doesn't require type argument names.

Specified by:

withTypeArguments in interface ClassElement

Parameters:

typeArguments - The type arguments

Returns:

A new element

isTypeVariable

public boolean isTypeVariable()

Description copied from interface: ClassElement

In this case of calling ClassElement.getTypeArguments() a returned ClassElement may represent a type variable in which case this method will return true.

Specified by:

isTypeVariable in interface ClassElement

Returns:

Is this type a type variable.

isRecord

public boolean isRecord()

Specified by:

isRecord in interface ClassElement

Returns:

Whether this element is a record

getEnclosedElements

@NonNull
public <T extends Element> @NonNull List<T> getEnclosedElements(@NonNull
 @NonNull ElementQuery<T> query)

Description copied from interface: ClassElement

Return the elements that match the given query.

Specified by:

getEnclosedElements in interface ClassElement

Type Parameters:

T - The element type

Parameters:

query - The query to use.

Returns:

The fields

getSourceEnclosedElements

public final <T extends Element> List<T> getSourceEnclosedElements(@NonNull
 @NonNull ElementQuery<T> query)

This method will produce th elements just like getEnclosedElements(ElementQuery) but the elements are constructed as the source ones. ElementFactory.newSourceMethodElement(ClassElement, Object, ElementAnnotationMetadataFactory).

Type Parameters:

T - The element type

Parameters:

query - The query

Returns:

The list of elements

getModifiers

public Set<ElementModifier> getModifiers()

Specified by:

getModifiers in interface Element

Returns:

The ElementModifier types for this class element

isInner

public boolean isInner()

Description copied from interface: ClassElement

Is this type an inner class.

Specified by:

isInner in interface ClassElement

Returns:

True if it is an inner class

getEnclosingType

public Optional<ClassElement> getEnclosingType()

Description copied from interface: ClassElement

Returns the enclosing type if ClassElement.isInner() return true.

Specified by:

getEnclosingType in interface ClassElement

Returns:

The enclosing type if any

isInterface

public boolean isInterface()

Specified by:

isInterface in interface ClassElement

Returns:

Whether the class element is an interface

isPrimitive

public boolean isPrimitive()

Description copied from interface: TypedElement

Whether the type is primitive.

Specified by:

isPrimitive in interface TypedElement

Returns:

True if it is

getInterfaces

public Collection<ClassElement> getInterfaces()

Specified by:

getInterfaces in interface ClassElement

Returns:

The interfaces implemented by this class element

getSuperType

public Optional<ClassElement> getSuperType()

Description copied from interface: ClassElement

Returns the super type of this element or empty if the element has no super type.

Specified by:

getSuperType in interface ClassElement

Returns:

An optional of the super type

getPrimaryConstructor

@NonNull
public @NonNull Optional<MethodElement> getPrimaryConstructor()

Description copied from interface: ClassElement

Find and return a single primary constructor. If more than constructor candidate exists, then return empty unless a constructor is found that is annotated with either Creator or AnnotationUtil.INJECT.

Specified by:

getPrimaryConstructor in interface ClassElement

Returns:

The primary constructor if one is present

getDefaultConstructor

public Optional<MethodElement> getDefaultConstructor()

Description copied from interface: ClassElement

Find and return a single default constructor. A default constructor is one without arguments that is accessible.

Specified by:

getDefaultConstructor in interface ClassElement

Returns:

The default constructor if one is present

getTypeArguments

@NonNull
public @NonNull Map<String,ClassElement> getTypeArguments()

Specified by:

getTypeArguments in interface ClassElement

Returns:

The type arguments for this class element

getSyntheticBeanProperties

@NonNull
public @NonNull List<PropertyElement> getSyntheticBeanProperties()

Description copied from interface: ClassElement

Returns the synthetic bean properties. The properties where one of the methods (getter or setter) is synthetic - not user defined but created by the compiler.

Specified by:

getSyntheticBeanProperties in interface ClassElement

Returns:

The bean properties for this class element

getBeanProperties

@NonNull
public @NonNull List<PropertyElement> getBeanProperties(@NonNull
 @NonNull PropertyElementQuery propertyElementQuery)

Description copied from interface: ClassElement

Returns the bean properties (getters and setters) for this class element based on custom configuration.

Specified by:

getBeanProperties in interface ClassElement

Parameters:

propertyElementQuery - The configuration

Returns:

The bean properties for this class element

getBeanProperties

@NonNull
public @NonNull List<PropertyElement> getBeanProperties()

Description copied from interface: ClassElement

Returns the bean properties (getters and setters) for this class element.

Specified by:

getBeanProperties in interface ClassElement

Returns:

The bean properties for this class element

isArray

public boolean isArray()

Description copied from interface: TypedElement

Is the type an array.

Specified by:

isArray in interface TypedElement

Returns:

True if it is.

withArrayDimensions

public ClassElement withArrayDimensions(int arrayDimensions)

Description copied from interface: ArrayableClassElement

Convert the class element to an element for the same type, but with the given number of array dimensions. Do not mutate the existing instance. Create a new instance instead.

Specified by:

withArrayDimensions in interface ArrayableClassElement

Parameters:

arrayDimensions - The number of array dimensions of the new class element

Returns:

A new class element

getArrayDimensions

public int getArrayDimensions()

Description copied from interface: TypedElement

If the type is an array, the number of dimensions. String[] should return 1, String[][] should return 2

Specified by:

getArrayDimensions in interface TypedElement

Returns:

The number of dimensions

toString

public String toString()

Overrides:

toString in class Object

getName

@NonNull
public @NonNull String getName()

Specified by:

getName in interface Element

Specified by:

getName in interface Named

Returns:

The name of the element. For a type this represents the binary name.

getSimpleName

@NonNull
public @NonNull String getSimpleName()

Description copied from interface: ClassElement

The simple name without the package name.

Specified by:

getSimpleName in interface ClassElement

Specified by:

getSimpleName in interface Element

Returns:

The simple name

getPackageName

public String getPackageName()

Description copied from interface: ClassElement

The package name.

Specified by:

getPackageName in interface ClassElement

Returns:

The package name

getPackage

public PackageElement getPackage()

Description copied from interface: ClassElement

The package name.

Specified by:

getPackage in interface ClassElement

Returns:

The package name

isAbstract

public boolean isAbstract()

Specified by:

isAbstract in interface Element

Returns:

True if the element is abstract.

isStatic

public boolean isStatic()

Specified by:

isStatic in interface Element

Returns:

True if the element is static.

isPublic

public boolean isPublic()

Specified by:

isPublic in interface Element

Returns:

True if the element is public.

isPrivate

public boolean isPrivate()

Specified by:

isPrivate in interface Element

Returns:

True if the element is private.

isFinal

public boolean isFinal()

Specified by:

isFinal in interface Element

Returns:

True if the element is final.

isProtected

public boolean isProtected()

Specified by:

isProtected in interface Element

Returns:

True if the element is protected.

isAssignable

public boolean isAssignable(String type)

Description copied from interface: ClassElement

Tests whether one type is assignable to another.

Specified by:

isAssignable in interface ClassElement

Parameters:

type - The type to check

Returns:

true if and only if this type is assignable to the second

isAssignable

public boolean isAssignable(ClassElement type)

Description copied from interface: ClassElement

Tests whether one type is assignable to another.

Specified by:

isAssignable in interface ClassElement

Parameters:

type - The type to check

Returns:

true if and only if this type is assignable to the second

getOptionalValueType

public Optional<ClassElement> getOptionalValueType()

Description copied from interface: ClassElement

Gets optional value type.

Specified by:

getOptionalValueType in interface ClassElement

Returns:

the value type

getBoundGenericTypes

@NonNull
public @NonNull List<? extends ClassElement> getBoundGenericTypes()

Description copied from interface: ClassElement

The list of type arguments bound to this type, or an empty list if there are no type arguments or this is a raw type.

Note that for compatibility reasons, this method is inconsistent with ClassElement.getTypeArguments(). In particular, this method reflects the declaration type: If there is a class Test<T> { T field; }, this method will return T as the field type, even if the field type was obtained through a Test<String>.

Specified by:

getBoundGenericTypes in interface ClassElement

Returns:

The list of type arguments, in the same order as ClassElement.getDeclaredGenericPlaceholders(). Must be empty or of the same length as ClassElement.getDeclaredGenericPlaceholders().

getDeclaredGenericPlaceholders

@NonNull
public @NonNull List<? extends GenericPlaceholderElement> getDeclaredGenericPlaceholders()

Description copied from interface: ClassElement

The type arguments declared on the raw class. Independent of the actual bound type arguments.

This method will resolve the generic placeholders defined of the declaring class, if any.

For example List<String> will result a single placeholder called E of type Object.

Specified by:

getDeclaredGenericPlaceholders in interface ClassElement

Returns:

The type arguments declared on this class.

getType

@NonNull
public @NonNull ClassElement getType()

Specified by:

getType in interface ClassElement

Specified by:

getType in interface TypedElement

Returns:

The type of the element

getTypeAnnotationMetadata

@NonNull
public @NonNull MutableAnnotationMetadataDelegate<AnnotationMetadata> getTypeAnnotationMetadata()

Description copied from interface: ClassElement

Returns the type annotations. Added by: - The declaration of the type variable ElementType.TYPE_PARAMETER - The use of the type ElementType.TYPE

Specified by:

getTypeAnnotationMetadata in interface ClassElement

Returns:

the type annotations