com.oracle.svm.util

Class GuardedAnnotationAccess

java.lang.Object

com.oracle.svm.util.GuardedAnnotationAccess

public final class GuardedAnnotationAccess
extends Object

Wrapper class for annotation access that defends against https://bugs.openjdk.java.net/browse/JDK-7183985: when an annotation declares a Class array parameter and one of the referenced classes is not present on the classpath parsing the annotations will result in an ArrayStoreException instead of caching of a TypeNotPresentExceptionProxy. This is a problem in JDK8 but was fixed in JDK11+. This wrapper class also defends against incomplete class path issues. If the element for which annotations are queried is a JMVCI value, i.e., a HotSpotResolvedJavaField, or HotSpotResolvedJavaMethod, the annotations are read via HotSpotJDKReflection using the getFieldAnnotation()/getMethodAnnotation() methods which first construct the field/method object via CompilerToVM.asReflectionField()/CompilerToVM.asReflectionExecutable() which eagerly try to resolve the types referenced in the element signature. If a field declared type or a method return type is missing then JVMCI throws a NoClassDefFoundError.

Constructor Summary

Constructors

Constructor and Description
GuardedAnnotationAccess()

Method Summary

Modifier and Type	Method and Description
static <T extends Annotation> T	getAnnotation(AnnotatedElement element, Class<T> annotationType)
static <T extends Annotation> T	getAnnotation(AnnotationExtracter extracter, AnnotatedElement element, Class<T> annotationType)
static Annotation[]	getAnnotations(AnnotatedElement element)
static Class<? extends Annotation>[]	getAnnotationTypes(AnnotatedElement element)
static <T extends Annotation> T	getDeclaredAnnotation(AnnotatedElement element, Class<T> annotationType)
static <T extends Annotation> T	getDeclaredAnnotation(AnnotationExtracter extracter, AnnotatedElement element, Class<T> annotationType)
static Annotation[]	getDeclaredAnnotations(AnnotatedElement element)
static boolean	isAnnotationPresent(AnnotatedElement element, Class<? extends Annotation> annotationClass)
static boolean	isAnnotationPresent(AnnotationExtracter extracter, AnnotatedElement element, Class<? extends Annotation> annotationClass)

Methods inherited from class java.lang.Object

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

Constructor Detail

GuardedAnnotationAccess

public GuardedAnnotationAccess()

Method Detail

isAnnotationPresent

public static boolean isAnnotationPresent(AnnotatedElement element,
                                          Class<? extends Annotation> annotationClass)

isAnnotationPresent

public static boolean isAnnotationPresent(AnnotationExtracter extracter,
                                          AnnotatedElement element,
                                          Class<? extends Annotation> annotationClass)

getAnnotation

public static <T extends Annotation> T getAnnotation(AnnotatedElement element,
                                                     Class<T> annotationType)

getAnnotation

public static <T extends Annotation> T getAnnotation(AnnotationExtracter extracter,
                                                     AnnotatedElement element,
                                                     Class<T> annotationType)

getAnnotations

public static Annotation[] getAnnotations(AnnotatedElement element)

getAnnotationTypes

public static Class<? extends Annotation>[] getAnnotationTypes(AnnotatedElement element)

getDeclaredAnnotation

public static <T extends Annotation> T getDeclaredAnnotation(AnnotatedElement element,
                                                             Class<T> annotationType)

getDeclaredAnnotation

public static <T extends Annotation> T getDeclaredAnnotation(AnnotationExtracter extracter,
                                                             AnnotatedElement element,
                                                             Class<T> annotationType)

getDeclaredAnnotations

public static Annotation[] getDeclaredAnnotations(AnnotatedElement element)