Interface TypeAnnotation

public sealed interface TypeAnnotation

Models a type_annotation structure (JVMS 4.7.20). This model indicates the annotated type within a declaration or expression and the part of the indicated type that is annotated, in addition to what is available in an Annotation.

This model can reconstruct an annotation on a type or a part of a type, given the location of the type_annotation structure in the class file and the definition of the annotation interface.

Two TypeAnnotation objects should be compared using the equals method.

Since:

See Also:

Nested Class Summary

Modifier and Type	Interface	Description
`static interface`	`TypeAnnotation.CatchTarget`	Indicates that an annotation appears on the i'th type in an exception parameter declaration.
`static interface`	`TypeAnnotation.EmptyTarget`	Indicates that an annotation appears on either the type in a field declaration, the return type of a method, the type of a newly constructed object, or the receiver type of a method or constructor.
`static interface`	`TypeAnnotation.FormalParameterTarget`	Indicates that an annotation appears on the type in a formal parameter declaration of a method, constructor, or lambda expression.
`static interface`	`TypeAnnotation.LocalVarTarget`	Indicates that an annotation appears on the type in a local variable declaration, including a variable declared as a resource in a try-with-resources statement.
`static interface`	`TypeAnnotation.LocalVarTargetInfo`	Indicates a range of code array offsets within which a local variable has a value, and the index into the local variable array of the current frame at which that local variable can be found.
`static interface`	`TypeAnnotation.OffsetTarget`	Indicates that an annotation appears on either the type in an instanceof expression or a new expression, or the type before the :: in a method reference expression.
`static interface`	`TypeAnnotation.SupertypeTarget`	Indicates that an annotation appears on a type in the extends or implements clause of a class or interface declaration.
`static interface`	`TypeAnnotation.TargetInfo`	Specifies which type in a declaration or expression is being annotated.
`static enum`	`TypeAnnotation.TargetType`	The kind of target on which the annotation appears, as defined in JVMS 4.7.20.1.
`static interface`	`TypeAnnotation.ThrowsTarget`	Indicates that an annotation appears on the i'th type in the throws clause of a method or constructor declaration.
`static interface`	`TypeAnnotation.TypeArgumentTarget`	Indicates that an annotation appears either on the i'th type in a cast expression, or on the i'th type argument in the explicit type argument list for any of the following: a new expression, an explicit constructor invocation statement, a method invocation expression, or a method reference expression.
`static interface`	`TypeAnnotation.TypeParameterBoundTarget`	Indicates that an annotation appears on the i'th bound of the j'th type parameter declaration of a generic class, interface, method, or constructor.
`static interface`	`TypeAnnotation.TypeParameterTarget`	Indicates that an annotation appears on the declaration of the i'th type parameter of a generic class, generic interface, generic method, or generic constructor.
`static interface`	`TypeAnnotation.TypePathComponent`	JVMS: Type_path structure identifies which part of the type is annotated, as defined in JVMS 4.7.20.2

Method Summary

Modifier and Type	Method	Description
`Annotation`	`annotation()`	Returns the annotation applied to the part indicated by `targetPath()`.
`static TypeAnnotation`	`of(TypeAnnotation.TargetInfo targetInfo, List<TypeAnnotation.TypePathComponent> targetPath, Annotation annotation)`	Returns a `type_annotation` structure.
`TypeAnnotation.TargetInfo`	`targetInfo()`	Returns information describing precisely which type in a declaration or expression is annotated.
`List<TypeAnnotation.TypePathComponent>`	`targetPath()`	Returns which part of the type indicated by `targetInfo()` is annotated.

Method Details

targetInfo

TypeAnnotation.TargetInfo targetInfo()

Returns information describing precisely which type in a declaration or expression is annotated. This models the target_type and target_info items.

Returns:: information describing precisely which type in a declaration or expression is annotated

targetPath

List<TypeAnnotation.TypePathComponent> targetPath()

Returns which part of the type indicated by targetInfo() is annotated.

Returns:: which part of the type indicated by targetInfo() is annotated

annotation

Annotation annotation()

Returns the annotation applied to the part indicated by targetPath(). This models the interface of the annotation and the set of element-value pairs, the subset of the type_annotation structure that is identical to the annotation structure.

Returns:: the annotation applied to the part indicated by targetPath()

of

static TypeAnnotation of(TypeAnnotation.TargetInfo targetInfo, List<TypeAnnotation.TypePathComponent> targetPath, Annotation annotation)

Returns a type_annotation structure.

Parameters:: targetInfo - which type in a declaration or expression is annotated; targetPath - which part of the type is annotated; annotation - the annotation
Returns:: a type_annotation structure

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/classfile/TypeAnnotation.html