net.covers1624.quack.asm.annotation

Class AnnotationLoader

java.lang.Object

net.covers1624.quack.asm.annotation.AnnotationLoader

public class AnnotationLoader
extends java.lang.Object

Utility for converting annotations loaded from ASM into class instances.

Created by covers1624 on 21/6/23.

Constructor Summary

Constructors

Constructor and Description
AnnotationLoader()
AnnotationLoader(AnnotationParser.ClassLookup lookup)
AnnotationLoader(AnnotationParser.ClassLookup lookup, boolean ignoreMissing)
AnnotationLoader(boolean ignoreMissing)

Method Summary

Modifier and Type	Method and Description
static <T extends java.lang.annotation.Annotation> T[]	expandRepeatable(java.lang.annotation.Annotation ann) If the given annotation is a Repeatable annotation, expand it into the contained annotations.
org.objectweb.asm.ClassVisitor	forClass() Returns a ClassVisitor which will consume class annotations into this AnnotationLoader.
org.objectweb.asm.ClassVisitor	forClass(@Nullable org.objectweb.asm.ClassVisitor delegate) Returns a ClassVisitor which will consume class annotations into this AnnotationLoader.
org.objectweb.asm.FieldVisitor	forField() Overload of forField(FieldVisitor).
org.objectweb.asm.FieldVisitor	forField(@Nullable org.objectweb.asm.FieldVisitor delegate) Returns a FieldVisitor which will consume field annotations into this AnnotationLoader.
org.objectweb.asm.MethodVisitor	forMethod() Returns a MethodVisitor which will consume method annotations into this AnnotationLoader.
org.objectweb.asm.MethodVisitor	forMethod(@Nullable org.objectweb.asm.MethodVisitor delegate) Returns a MethodVisitor which will consume method annotations into this AnnotationLoader.
java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAllTypes() Get all annotation types..
java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>>	getAllTypes(boolean visible) Get all annotation types..
<T extends java.lang.annotation.Annotation> T	getAnnotation(java.lang.Class<T> clazz) Get a single annotation of the specified type.
<T extends java.lang.annotation.Annotation> T	getAnnotation(java.lang.Class<T> clazz, boolean visible) Get a single annotation of the specified type.
<T extends java.lang.annotation.Annotation> T[]	getAnnotations(java.lang.Class<T> clazz) Get all annotation of the specified type.
<T extends java.lang.annotation.Annotation> T[]	getAnnotations(java.lang.Class<T> clazz, boolean visible) Get all annotation of the specified type.

Methods inherited from class java.lang.Object

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

Constructor Detail

AnnotationLoader

public AnnotationLoader()

AnnotationLoader

public AnnotationLoader(boolean ignoreMissing)

AnnotationLoader

public AnnotationLoader(AnnotationParser.ClassLookup lookup)

AnnotationLoader

public AnnotationLoader(AnnotationParser.ClassLookup lookup,
                        boolean ignoreMissing)

Method Detail

forClass

public org.objectweb.asm.ClassVisitor forClass()

Returns a ClassVisitor which will consume class annotations into this AnnotationLoader.

Returns:

The visitor.

forClass

public org.objectweb.asm.ClassVisitor forClass(@Nullable
                                               @Nullable org.objectweb.asm.ClassVisitor delegate)

Returns a ClassVisitor which will consume class annotations into this AnnotationLoader.

Returns:

The visitor.

forMethod

public org.objectweb.asm.MethodVisitor forMethod()

Returns a MethodVisitor which will consume method annotations into this AnnotationLoader.

Returns:

The visitor.

forMethod

public org.objectweb.asm.MethodVisitor forMethod(@Nullable
                                                 @Nullable org.objectweb.asm.MethodVisitor delegate)

Returns a MethodVisitor which will consume method annotations into this AnnotationLoader.

Parameters:

delegate - Additionally chain visited data to the given delegate.

Returns:

The visitor.

forField

public org.objectweb.asm.FieldVisitor forField()

Overload of forField(FieldVisitor).

Returns:

The visitor.

forField

public org.objectweb.asm.FieldVisitor forField(@Nullable
                                               @Nullable org.objectweb.asm.FieldVisitor delegate)

Returns a FieldVisitor which will consume field annotations into this AnnotationLoader.

Parameters:

delegate - Additionally chain visited data to the given delegate.

Returns:

The visitor.

getAnnotation

@Nullable
public <T extends java.lang.annotation.Annotation> T getAnnotation(java.lang.Class<T> clazz)

Get a single annotation of the specified type.

If there is more than one annotation, the first is returned.

Parameters:

clazz - The annotation class.

Returns:

The annotation instance.

getAnnotation

@Nullable
public <T extends java.lang.annotation.Annotation> T getAnnotation(java.lang.Class<T> clazz,
                                                                             boolean visible)

Get a single annotation of the specified type.

If there is more than one annotation, the first is returned.

Parameters:

clazz - The annotation class.

visible - If the runtime visible or invisible annotation list should be queried.

Returns:

The annotation instance.

getAnnotations

public <T extends java.lang.annotation.Annotation> T[] getAnnotations(java.lang.Class<T> clazz)

Get all annotation of the specified type.

Parameters:

clazz - The annotation class.

Returns:

The annotation instance.

getAnnotations

public <T extends java.lang.annotation.Annotation> T[] getAnnotations(java.lang.Class<T> clazz,
                                                                      boolean visible)

Get all annotation of the specified type.

Parameters:

clazz - The annotation class.

visible - If the runtime visible or invisible annotation list should be queried.

Returns:

The annotation instance.

getAllTypes

public java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>> getAllTypes()

Get all annotation types..

Returns:

The types.

getAllTypes

public java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>> getAllTypes(boolean visible)

Get all annotation types..

Parameters:

visible - If the runtime visible or invisible annotation list should be queried.

Returns:

The types.

expandRepeatable

public static <T extends java.lang.annotation.Annotation> T[] expandRepeatable(java.lang.annotation.Annotation ann)

If the given annotation is a Repeatable annotation, expand it into the contained annotations.

Parameters:

ann - The annotation to expand.

Returns:

The expanded annotations, or null if the annotation is not repeatable and no expansion is possible.