Class AnnotatedNode

src/main/java/org/codehaus/groovy/ast/AnnotatedNode.java:31–196

Base class for any AST node which is capable of being annotated

 * Base class for any AST node which is capable of being annotated
 */
public class AnnotatedNode extends ASTNode implements GroovydocHolder<AnnotatedNode> {
    private List<AnnotationNode> annotations = Collections.emptyList();
    private ClassNode declaringClass;
    private boolean synthetic;

    /**
     * Returns all annotations attached to this AST node.
     * Annotations are runtime-visible or source-level metadata attached to language elements.
     *
     * @return list of {@link AnnotationNode}, or empty list if none
     */
    public List<AnnotationNode> getAnnotations() {
        return annotations;
    }

    /**
     * Returns annotations of a specific type attached to this AST node.
     * Filters the annotation list by the provided type.
     *
     * @param type the annotation type to filter by
     * @return list of matching {@link AnnotationNode}, or empty list if none
     */
    public List<AnnotationNode> getAnnotations(final ClassNode type) {
        List<AnnotationNode> annotations = new ArrayList<>();
        for (AnnotationNode node : getAnnotations()) {
            if (type.equals(node.getClassNode())) {
                annotations.add(node);
            }
        }
        return annotations;
    }

    /**
     * Adds a new annotation of the specified type to this node.
     * Creates an {@link AnnotationNode} and attaches it.
     *
     * @param type the annotation type as a {@link ClassNode}
     * @return the newly created {@link AnnotationNode}
     */
    public AnnotationNode addAnnotation(final ClassNode type) {
        AnnotationNode node = new AnnotationNode(type);
        addAnnotation(node);
        return node;
    }

    /**
     * Attaches an annotation node to this AST node.
     * Does nothing if the annotation is null. Lazily initializes the annotations list.
     *
     * @param annotation the {@link AnnotationNode} to attach
     */
    public void addAnnotation(AnnotationNode annotation) {
        if (annotation != null) {
            if (annotations == Collections.EMPTY_LIST) {
                annotations = new ArrayList<>(3);
            }
            annotations.add(annotation);
        }