RepeatableMetaAnnotatedElement (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.annotation.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:

6.0.0

Author:

huangchengxing

See Also:

RepeatableAnnotationCollector

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and 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 Detail
  - 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:
    
    迭代器

Class RepeatableMetaAnnotatedElement<T extends AnnotationMapping<Annotation>>

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Method Detail

create

create

isAnnotationPresent

getAnnotation

getAnnotations

getAnnotationsByType

getDeclaredAnnotations

getDeclaredAnnotation

getDeclaredAnnotationsByType

getElement

equals

hashCode

iterator