org.junit.platform.commons.util

Class AnnotationUtils

java.lang.Object

org.junit.platform.commons.util.AnnotationUtils

@API(value=Internal)
public final class AnnotationUtils
extends Object

Collection of utilities for working with annotations.

DISCLAIMER

These utilities are intended solely for usage within the JUnit framework itself. Any usage by external parties is not supported. Use at your own risk!

Since:

1.0

See Also:

Annotation, AnnotatedElement

Method Summary

Modifier and Type	Method and Description
static List<Method>	findAnnotatedMethods(Class<?> clazz, Class<? extends Annotation> annotationType, ReflectionUtils.MethodSortOrder sortOrder)
static <A extends Annotation> Optional<A>	findAnnotation(AnnotatedElement element, Class<A> annotationType) Find the first annotation of annotationType that is either present or meta-present on the supplied element.
static <A extends Annotation> Optional<A>	findAnnotation(Optional<? extends AnnotatedElement> element, Class<A> annotationType) Find the first annotation of annotationType that is either present or meta-present on the supplied optional element.
static <A extends Annotation> List<A>	findRepeatableAnnotations(AnnotatedElement element, Class<A> annotationType) Find all repeatable annotations of annotationType that are either present, indirectly present, or meta-present on the supplied AnnotatedElement.
static boolean	isAnnotated(AnnotatedElement element, Class<? extends Annotation> annotationType) Determine if an annotation of annotationType is either present or meta-present on the supplied element.

Methods inherited from class java.lang.Object

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

Method Detail

isAnnotated

public static boolean isAnnotated(AnnotatedElement element,
                                  Class<? extends Annotation> annotationType)

Determine if an annotation of annotationType is either present or meta-present on the supplied element.

See Also:

findAnnotation(AnnotatedElement, Class)

findAnnotation

public static <A extends Annotation> Optional<A> findAnnotation(Optional<? extends AnnotatedElement> element,
                                                                Class<A> annotationType)

Find the first annotation of annotationType that is either present or meta-present on the supplied optional element.

See Also:

findAnnotation(AnnotatedElement, Class)

findAnnotation

public static <A extends Annotation> Optional<A> findAnnotation(AnnotatedElement element,
                                                                Class<A> annotationType)

Find the first annotation of annotationType that is either present or meta-present on the supplied element.

findRepeatableAnnotations

public static <A extends Annotation> List<A> findRepeatableAnnotations(AnnotatedElement element,
                                                                       Class<A> annotationType)

Find all repeatable annotations of annotationType that are either present, indirectly present, or meta-present on the supplied AnnotatedElement.

This method extends the functionality of AnnotatedElement.getAnnotationsByType(Class) with additional support for meta-annotations.

In addition, if the element is a class and the repeatable annotation is @Inherited, this method will search on superclasses first in order to support top-down semantics. The result is that this algorithm finds repeatable annotations that would be shadowed and therefore not visible according to Java's standard semantics for inherited, repeatable annotations, but most developers will naturally assume that all repeatable annotations in JUnit are discovered regardless of whether they are declared stand-alone, in a container, or as a meta-annotation (e.g., multiple declarations of @ExtendWith within a test class hierarchy).

If the supplied element is null, this method simply returns an empty list.

Parameters:

element - the element to search on, potentially null

annotationType - the repeatable annotation type to search for; never null

Returns:

the list of all such annotations found; never null

See Also:

Repeatable, Inherited

findAnnotatedMethods

public static List<Method> findAnnotatedMethods(Class<?> clazz,
                                                Class<? extends Annotation> annotationType,
                                                ReflectionUtils.MethodSortOrder sortOrder)