RepeatableAnnotationCollector (hutool 6.0.0-M20 API)

All Known Implementing Classes:

RepeatableAnnotationCollector.AbstractCollector, RepeatableAnnotationCollector.Condition, RepeatableAnnotationCollector.Full, RepeatableAnnotationCollector.None, RepeatableAnnotationCollector.Standard
```
public interface RepeatableAnnotationCollector
```
可重复注解收集器，用于从一个注解获得被它包含的可重复注解

Author:

huangchengxing

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`RepeatableAnnotationCollector.AbstractCollector` `RepeatableAnnotationCollector`的基本实现
`static class`	`RepeatableAnnotationCollector.Condition` 自定义判断条件的实现，当解析注解属性时，将根据给定的判断条件，确定该属性中是否含有可重复注解，收集器将返回所有匹配的属性中的可重复注解。
`static class`	`RepeatableAnnotationCollector.Full` 全量实现，当注解中存在有属性为注解数组，且该数组对应的注解类型被`Repeatable`注解时，认为该属性包含可重复注解。
`static class`	`RepeatableAnnotationCollector.None` 空实现
`static class`	`RepeatableAnnotationCollector.Standard` 标准实现，当注解中有且仅有一个名为`value`的属性时，若该属性类型为注解数组，且该数组对应的注解类型被`Repeatable`注解，则收集器将返回该属性中包括的可重复注解。

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static void`	`clearSingletonCaches()` 清空单例缓存
`static RepeatableAnnotationCollector`	`condition(BiPredicate<Annotation,Method> predicate)` 当解析注解属性时，将根据给定的判断条件，确定该属性中是否含有可重复注解。
`static RepeatableAnnotationCollector`	`full()` 当注解中存在有属性为注解数组，且该数组对应的注解类型被`Repeatable`注解时，认为该属性包含可重复注解。
`List<Annotation>`	`getAllRepeatableAnnotations(Annotation annotation)` 若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的注解对象。
`List<Annotation>`	`getFinalRepeatableAnnotations(Annotation annotation)` 若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的注解对象。
`<T extends Annotation> List<T>`	`getRepeatableAnnotations(Annotation annotation, Class<T> annotationType)` 若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的指定类型注解对象。
`static RepeatableAnnotationCollector`	`none()` 空实现
`static RepeatableAnnotationCollector`	`standard()` 当注解中有且仅有一个名为`value`的属性时，若该属性类型为注解数组，且该数组对应的注解类型被`Repeatable`注解，则收集器将返回该属性中包括的可重复注解。

- Method Detail
  - none
```
static RepeatableAnnotationCollector none()
```
    空实现
    
    Returns:
    
    RepeatableAnnotationCollector实例
  - standard
```
static RepeatableAnnotationCollector standard()
```
    当注解中有且仅有一个名为value的属性时，若该属性类型为注解数组，且该数组对应的注解类型被Repeatable注解，则收集器将返回该属性中包括的可重复注解。
    eg:
```
 // 容器注解
  @interface Annotation {
        Item[] value() default {};
 }
 // 可重复注解
  @Repeatable(Annotation.class)
  @interface Item {}
 
```
    解析任意Annotation注解对象，则可以获得value属性中的Item注解对象
    Returns:
    
    RepeatableAnnotationCollector实例
    
    See Also:
    
    RepeatableAnnotationCollector.Standard
  - condition
```
static RepeatableAnnotationCollector condition(BiPredicate<Annotation,Method> predicate)
```
    当解析注解属性时，将根据给定的判断条件，确定该属性中是否含有可重复注解。
    收集器将返回所有匹配的属性中的可重复注解。
    
    Parameters:
    
    predicate - 是否为容纳可重复注解的属性的判断条件
    
    Returns:
    
    RepeatableAnnotationCollector实例
  - full
```
static RepeatableAnnotationCollector full()
```
    当注解中存在有属性为注解数组，且该数组对应的注解类型被Repeatable注解时，认为该属性包含可重复注解。
    收集器将返回所有符合上述条件的属性中的可重复注解。
    eg:
```
  @interface Annotation {
        Item1[] items1() default {};
        Item2[] items2() default {};
 }
 
```
    解析任意Annotation注解对象，则可以获得items1属性中的Item1注解对象，以及items2属性中的Item2注解对象，
    Returns:
    
    RepeatableAnnotationCollector实例
  - clearSingletonCaches
```
static void clearSingletonCaches()
```
    清空单例缓存
  - getFinalRepeatableAnnotations
```
List<Annotation> getFinalRepeatableAnnotations(Annotation annotation)
```
    若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的注解对象。若包含的注解对象也是可重复注解的容器注解，则继续解析直到获得所有非容器注解为止。
    eg: 若存在嵌套关系a -> b -> c，则解析注解a，则将得到全部c注解。
    如果注解不包含可重复注解，则返回a本身。
    
    Parameters:
    
    annotation - 容器注解
    
    Returns:
    
    容器注解中的可重复注解，若annotation不为容器注解，则数组中仅有其本身一个对象
  - getAllRepeatableAnnotations
```
List<Annotation> getAllRepeatableAnnotations(Annotation annotation)
```
    若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的注解对象。若包含的注解对象也是可重复注解的容器注解，则继续解析直到获得所有非容器注解为止。
    eg: 若存在嵌套关系a -> b -> c，则解析注解a, 将获得全部a、b、c注解。
    如果注解不包含可重复注解，则返回a本身。
    
    Parameters:
    
    annotation - 容器注解
    
    Returns:
    
    容器注解中的可重复注解，若annotation不为容器注解，则数组中仅有其本身一个对象
  - getRepeatableAnnotations
```
<T extends Annotation> List<T> getRepeatableAnnotations(Annotation annotation,
                                                        Class<T> annotationType)
```
    若一个注解是可重复注解的容器注解，则尝试通过其属性获得获得包含的指定类型注解对象。
    eg: 若存在嵌套关系a -> b -> c，则：
    - 解析注解a：可获得a、b、c；
    - 解析注解b：可获得b、c；
    - 解析注解c：只可获得c；
    Type Parameters:
    
    T - 注解类型
    
    Parameters:
    
    annotation - 容器注解
    
    annotationType - 注解类型
    
    Returns:
    
    容器注解中的可重复注解

Interface RepeatableAnnotationCollector

Nested Class Summary

Method Summary

Method Detail

none

standard

condition

full

clearSingletonCaches

getFinalRepeatableAnnotations

getAllRepeatableAnnotations

getRepeatableAnnotations