com.github.t1.annotations

Interface Annotations

public interface Annotations

Method Summary

Modifier and Type	Method and Description
Stream<Annotation>	all() Get all Annotation instances.
<T extends Annotation> Stream<T>	all(Class<T> type) Get all (eventually repeatable) Annotation instances of this type.
<T extends Annotation> Optional<T>	get(Class<T> type) Get the 'strongest' Annotation instance of this type.
static Annotations	on(Class<?> type)
static Annotations	on(Field field)
static Annotations	on(Method method)
static Annotations	onField(Class<?> type, String fieldName)
static Annotations	onMethod(Class<?> type, String methodName, Class<?>... argTypes)

Method Detail

on

static Annotations on(Class<?> type)

on

static Annotations on(Field field)

onField

static Annotations onField(Class<?> type,
                           String fieldName)

on

static Annotations on(Method method)

onMethod

static Annotations onMethod(Class<?> type,
                            String methodName,
                            Class<?>... argTypes)

all

Stream<Annotation> all()

Get all Annotation instances. If the annotation type is Repeatable, the same type can show up several times, eventually with different properties.

get

<T extends Annotation> Optional<T> get(Class<T> type)

Get the 'strongest' Annotation instance of this type. Multiple annotations may be applicable, e.g. from several mixins or stereotypes. The annotation will be picked in this order:

1. mixin
2. target
3. target stereotypes
4. containing class
5. containing class stereotypes
6. containing package (TODO not yet implemented)
7. containing package stereotypes (TODO not yet implemented)

If this order not sufficiently defined, e.g. because there are multiple repeatable annotations, or because there are multiple mixins or stereotypes with the same annotation, an AmbiguousAnnotationResolutionException is thrown. I.e. when an annotation is changed to be repeatable, all frameworks using this annotation will have to use all(Class) instead (of course), but the semantics for the client code changes, which may break existing code.

all

<T extends Annotation> Stream<T> all(Class<T> type)

Get all (eventually repeatable) Annotation instances of this type.