Package org.miaixz.bus.core.lang.annotation.resolve.elements

Class RepeatableMetaAnnotatedElement<T extends AnnotationMapping<Annotation>>

java.lang.Object

org.miaixz.bus.core.lang.annotation.resolve.elements.RepeatableMetaAnnotatedElement<T>

Type Parameters:

T - AnnotationMapping类型

All Implemented Interfaces:

Iterable<T>, AnnotatedElement

public class RepeatableMetaAnnotatedElement<T extends AnnotationMapping<Annotation>>
extends Object
implements AnnotatedElement, Iterable<T>

支持可重复注解的增强AnnotatedElement， 功能与MetaAnnotatedElement类似，但是存在下述差异：

• 限制以同一根注解延伸出的树结构上——而不是AnnotatedElement上——每种类型注解只能保留一个， 即当AnnotatedElement存在多个根注解有相同的元注解时，这些元注解会都会被扫描到；
• 支持扫描AnnotatedElement可重复注解，即当当前实例指定的RepeatableAnnotationCollector 支持从AnnotatedElement上直接声明的注解中获得可重复注解时， 则将会自动将其展开直到不为容器注解为止。 eg： A上存在注解X，该注解是一个容器注解，内部可重复注解Y， 包含解析后，得到注解X与可重复注解Y, 同理，若存在X、Y、X的嵌套关系，则解析后获得全部三者；

由于上述机制，当通过实例的getAnnotation(Class)或getDeclaredAnnotation(Class) 方法获得指定类型注解时，若该类型注解存在多个，仅能尽可能获得最先被扫描到的那一个。

Since:

Java 17+

Author:

Kimi Liu

See Also:

• RepeatableAnnotationCollector

Method Summary

Modifier and Type	Method	Description
static <A extends AnnotationMapping<Annotation>> RepeatableMetaAnnotatedElement<A>	create(AnnotatedElement element, BiFunction<A,Annotation,A> mappingFactory)	获取AnnotatedElement上的注解结构，该方法会针对相同的AnnotatedElement缓存映射对象
static <A extends AnnotationMapping<Annotation>> RepeatableMetaAnnotatedElement<A>	create(RepeatableAnnotationCollector collector, AnnotatedElement element, BiFunction<A,Annotation,A> mappingFactory)	获取AnnotatedElement上的注解结构，该方法会针对相同的AnnotatedElement缓存映射对象
boolean	equals(Object o)	比较两个实例是否相等
<A extends Annotation> A	getAnnotation(Class<A> annotationType)	从element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解中获得指定类型的注解
Annotation[]	getAnnotations()	获取element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解
<A extends Annotation> A[]	getAnnotationsByType(Class<A> annotationType)	从element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解中获得指定类型的注解
<A extends Annotation> A	getDeclaredAnnotation(Class<A> annotationType)	获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解
Annotation[]	getDeclaredAnnotations()	获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解
<A extends Annotation> A[]	getDeclaredAnnotationsByType(Class<A> annotationType)	获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解
AnnotatedElement	getElement()	注解对象
int	hashCode()	获取实例的哈希值
boolean	isAnnotationPresent(Class<? extends Annotation> annotationType)	指定注解是否在element上直接声明的注解、直接声明的注解包含的可重复注解， 以及他们的元注解中存在
Iterator<T>	iterator()	获取迭代器

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Details

create

public static <A extends AnnotationMapping<Annotation>>
RepeatableMetaAnnotatedElement<A> create(AnnotatedElement element,
 BiFunction<A,Annotation,A> mappingFactory)

获取AnnotatedElement上的注解结构，该方法会针对相同的AnnotatedElement缓存映射对象

Type Parameters:

A - AnnotationMapping类型

Parameters:

element - 被注解元素

mappingFactory - 创建AnnotationMapping的工厂方法，返回值为null时将忽略该注解

Returns:

AnnotatedElement上的注解结构

create

public static <A extends AnnotationMapping<Annotation>>
RepeatableMetaAnnotatedElement<A> create(RepeatableAnnotationCollector collector,
 AnnotatedElement element,
 BiFunction<A,Annotation,A> mappingFactory)

获取AnnotatedElement上的注解结构，该方法会针对相同的AnnotatedElement缓存映射对象

Type Parameters:

A - AnnotationMapping类型

Parameters:

collector - 可重复注解收集器

element - 被注解元素

mappingFactory - 创建AnnotationMapping的工厂方法，返回值为null时将忽略该注解

Returns:

AnnotatedElement上的注解结构

isAnnotationPresent

public boolean isAnnotationPresent(Class<? extends Annotation> annotationType)

指定注解是否在element上直接声明的注解、直接声明的注解包含的可重复注解， 以及他们的元注解中存在

Specified by:

isAnnotationPresent in interface AnnotatedElement

Parameters:

annotationType - 注解类型

Returns:

是否

getAnnotation

public <A extends Annotation> A getAnnotation(Class<A> annotationType)

从element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解中获得指定类型的注解

Specified by:

getAnnotation in interface AnnotatedElement

Type Parameters:

A - 注解类型

Parameters:

annotationType - 注解类型

Returns:

注解

getAnnotations

public Annotation[] getAnnotations()

获取element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解

Specified by:

getAnnotations in interface AnnotatedElement

Returns:

注解

getAnnotationsByType

public <A extends Annotation> A[] getAnnotationsByType(Class<A> annotationType)

从element上直接声明的注解、直接声明的注解包含的可重复注解，以及它们的元注解中获得指定类型的注解

Specified by:

getAnnotationsByType in interface AnnotatedElement

Type Parameters:

A - 注解类型

Parameters:

annotationType - 注解类型

Returns:

注解

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解

Specified by:

getDeclaredAnnotations in interface AnnotatedElement

Returns:

注解

getDeclaredAnnotation

public <A extends Annotation> A getDeclaredAnnotation(Class<A> annotationType)

获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解

Specified by:

getDeclaredAnnotation in interface AnnotatedElement

Type Parameters:

A - 注解类型

Parameters:

annotationType - 注解类型

Returns:

注解

getDeclaredAnnotationsByType

public <A extends Annotation> A[] getDeclaredAnnotationsByType(Class<A> annotationType)

获取由element直接声明的注解，不包含被直接声明的容器注解包括的可重复注解

Specified by:

getDeclaredAnnotationsByType in interface AnnotatedElement

Type Parameters:

A - 注解类型

Parameters:

annotationType - 注解类型

Returns:

注解

getElement

public AnnotatedElement getElement()

注解对象

Returns:

被包装的原始元素

equals

public boolean equals(Object o)

比较两个实例是否相等

Overrides:

equals in class Object

Parameters:

o - 对象

Returns:

是否

hashCode

public int hashCode()

获取实例的哈希值

Overrides:

hashCode in class Object

Returns:

哈希值

iterator

public Iterator<T> iterator()

获取迭代器

Specified by:

iterator in interface Iterable<T extends AnnotationMapping<Annotation>>

Returns:

迭代器