cn.hutool.core.annotation

Class AbstractLinkAnnotationPostProcessor

java.lang.Object

cn.hutool.core.annotation.AbstractLinkAnnotationPostProcessor

All Implemented Interfaces:

SynthesizedAnnotationPostProcessor, Comparable<SynthesizedAnnotationPostProcessor>

Direct Known Subclasses:

AliasLinkAnnotationPostProcessor, MirrorLinkAnnotationPostProcessor

public abstract class AbstractLinkAnnotationPostProcessor
extends Object
implements SynthesizedAnnotationPostProcessor

SynthesizedAnnotationPostProcessor的基本实现， 用于处理注解中带有Link注解的属性。

Author:

huangchengxing

See Also:

MirrorLinkAnnotationPostProcessor, AliasLinkAnnotationPostProcessor

Field Summary

Fields inherited from interface cn.hutool.core.annotation.SynthesizedAnnotationPostProcessor

ALIAS_ANNOTATION_POST_PROCESSOR, ALIAS_LINK_ANNOTATION_POST_PROCESSOR, MIRROR_LINK_ANNOTATION_POST_PROCESSOR

Constructor Summary

Constructors

Constructor and Description
AbstractLinkAnnotationPostProcessor()

Method Summary

Modifier and Type	Method and Description
protected void	checkAttributeType(AnnotationAttribute original, AnnotationAttribute alias) 校验两个注解属性的返回值类型是否一致
protected void	checkLinkedAttributeNotNull(AnnotationAttribute original, AnnotationAttribute linkedAttribute, Link annotation) 检查Link指向的注解属性是否存在
protected void	checkLinkedSelf(AnnotationAttribute original, AnnotationAttribute linked) 检查Link指向的注解属性是否就是本身
protected Link	getLinkAnnotation(AnnotationAttribute attribute, RelationType... relationTypes) 从注解属性上获取指定类型的Link注解
protected SynthesizedAnnotation	getLinkedAnnotation(Link annotation, AnnotationSynthesizer synthesizer, Class<? extends Annotation> defaultType) 从合成注解中获取Link.type()指定的注解对象
protected Class<?>	getLinkedAnnotationType(Link annotation, Class<?> defaultType) 若Link.annotation()获取的类型Annotation#getClass()，则返回defaultType， 否则返回Link.annotation()指定的类型
void	process(SynthesizedAnnotation synthesizedAnnotation, AnnotationSynthesizer synthesizer) 若一个注解属性上存在Link注解，注解的Link.type()返回值在processTypes()中存在， 且此Link指定的注解对象在当前的SynthesizedAggregateAnnotation中存在， 则从聚合器中获取类型对应的合成注解对象，与该对象中的指定属性，然后将全部关联数据交给 processLinkedAttribute(cn.hutool.core.annotation.AnnotationSynthesizer, cn.hutool.core.annotation.Link, cn.hutool.core.annotation.SynthesizedAnnotation, cn.hutool.core.annotation.AnnotationAttribute, cn.hutool.core.annotation.SynthesizedAnnotation, cn.hutool.core.annotation.AnnotationAttribute)处理。
protected abstract void	processLinkedAttribute(AnnotationSynthesizer synthesizer, Link annotation, SynthesizedAnnotation originalAnnotation, AnnotationAttribute originalAttribute, SynthesizedAnnotation linkedAnnotation, AnnotationAttribute linkedAttribute) 对关联的合成注解对象及其关联属性的处理
protected abstract RelationType[]	processTypes() 当属性上存在Link注解时，仅当Link.type()在本方法返回值内存在时才进行处理

Methods inherited from class java.lang.Object

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

Methods inherited from interface cn.hutool.core.annotation.SynthesizedAnnotationPostProcessor

compareTo, order

Constructor Detail

AbstractLinkAnnotationPostProcessor

public AbstractLinkAnnotationPostProcessor()

Method Detail

process

public void process(SynthesizedAnnotation synthesizedAnnotation,
                    AnnotationSynthesizer synthesizer)

若一个注解属性上存在Link注解，注解的Link.type()返回值在processTypes()中存在， 且此Link指定的注解对象在当前的SynthesizedAggregateAnnotation中存在， 则从聚合器中获取类型对应的合成注解对象，与该对象中的指定属性，然后将全部关联数据交给 processLinkedAttribute(cn.hutool.core.annotation.AnnotationSynthesizer, cn.hutool.core.annotation.Link, cn.hutool.core.annotation.SynthesizedAnnotation, cn.hutool.core.annotation.AnnotationAttribute, cn.hutool.core.annotation.SynthesizedAnnotation, cn.hutool.core.annotation.AnnotationAttribute)处理。

Specified by:

process in interface SynthesizedAnnotationPostProcessor

Parameters:

synthesizedAnnotation - 合成的注解

synthesizer - 合成注解聚合器

processTypes

protected abstract RelationType[] processTypes()

当属性上存在Link注解时，仅当Link.type()在本方法返回值内存在时才进行处理

Returns:

支持处理的RelationType类型

processLinkedAttribute

protected abstract void processLinkedAttribute(AnnotationSynthesizer synthesizer,
                                               Link annotation,
                                               SynthesizedAnnotation originalAnnotation,
                                               AnnotationAttribute originalAttribute,
                                               SynthesizedAnnotation linkedAnnotation,
                                               AnnotationAttribute linkedAttribute)

对关联的合成注解对象及其关联属性的处理

Parameters:

synthesizer - 注解合成器

annotation - originalAttribute上的Link注解对象

originalAnnotation - 当前正在处理的SynthesizedAnnotation对象

originalAttribute - originalAnnotation上的待处理的属性

linkedAnnotation - Link指向的关联注解对象

linkedAttribute - Link指向的originalAnnotation中的关联属性，该参数可能为空

getLinkAnnotation

protected Link getLinkAnnotation(AnnotationAttribute attribute,
                                 RelationType... relationTypes)

从注解属性上获取指定类型的Link注解

Parameters:

attribute - 注解属性

relationTypes - 类型

Returns:

注解

getLinkedAnnotation

protected SynthesizedAnnotation getLinkedAnnotation(Link annotation,
                                                    AnnotationSynthesizer synthesizer,
                                                    Class<? extends Annotation> defaultType)

从合成注解中获取Link.type()指定的注解对象

Parameters:

annotation - Link注解

synthesizer - 注解合成器

defaultType - 默认类型

Returns:

SynthesizedAnnotation

getLinkedAnnotationType

protected Class<?> getLinkedAnnotationType(Link annotation,
                                           Class<?> defaultType)

若Link.annotation()获取的类型Annotation#getClass()，则返回defaultType， 否则返回Link.annotation()指定的类型

Parameters:

annotation - Link注解

defaultType - 默认注解类型

Returns:

注解类型

checkAttributeType

protected void checkAttributeType(AnnotationAttribute original,
                                  AnnotationAttribute alias)

校验两个注解属性的返回值类型是否一致

Parameters:

original - 原属性

alias - 别名属性

checkLinkedSelf

protected void checkLinkedSelf(AnnotationAttribute original,
                               AnnotationAttribute linked)

检查Link指向的注解属性是否就是本身

Parameters:

original - Link注解的属性

linked - Link指向的注解属性

checkLinkedAttributeNotNull

protected void checkLinkedAttributeNotNull(AnnotationAttribute original,
                                           AnnotationAttribute linkedAttribute,
                                           Link annotation)

检查Link指向的注解属性是否存在

Parameters:

original - Link注解的属性

linkedAttribute - Link指向的注解属性

annotation - Link注解