cn.hutool.core.annotation.Link Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hutool-all Show documentation

Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。

There is a newer version: 5.8.34

package cn.hutool.core.annotation;

import java.lang.annotation.*;

/**
 * 用于在同一注解中，或具有一定关联的不同注解的属性中，表明这些属性之间具有特定的关联关系。
 * 在通过{@link SynthesizedAggregateAnnotation}获取合成注解后，合成注解获取属性值时会根据该注解进行调整。

 *
 * 该注解存在三个字注解：{@link MirrorFor}、{@link ForceAliasFor}或{@link AliasFor}，
 * 使用三个子注解等同于{@link Link}。但是需要注意的是，
 * 当注解中的属性同时存在多个{@link Link}或基于{@link Link}的子注解时，
 * 仅有声明在被注解的属性最上方的注解会生效，其余注解都将被忽略。
 *
 * 注意：该注解的优先级低于{@link Alias}
 *
 * @author huangchengxing
 * @see SynthesizedAggregateAnnotation
 * @see RelationType
 * @see AliasFor
 * @see MirrorFor
 * @see ForceAliasFor
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
public @interface Link {

	/**
	 * 产生关联的注解类型，当不指定时，默认指注释的属性所在的类
	 *
	 * @return 关联的注解类型
	 */
	Class annotation() default Annotation.class;

	/**
	 * {@link #annotation()}指定注解中关联的属性
	 *
	 * @return 属性名
	 */
	String attribute() default "";

	/**
	 * {@link #attribute()}指定属性与当前注解的属性建的关联关系类型
	 *
	 * @return 关系类型
	 */
	RelationType type() default RelationType.MIRROR_FOR;

}