场景1:在同一个注解内,对两个不同的属性一起使用,互为别名,比如@RequestMapping中path和value成对使用,互为别名。
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
String name() default "";
@AliasFor("path") // 此时path和value值是一样的,如果不一样会报错
String[] value() default {};
@AliasFor("value") // 此时path和value值是一样的,如果不一样会报错
String[] path() default {};
... 其它略 ....
}
使用如下:
// 正解:path和value都为"/getbaidu"
@RequestMapping(path="/getbaidu", method=RequestMethod.GET)
// 正解:path和value都为"/getbaidu"
@RequestMapping(value="/getbaidu", method=RequestMethod.GET)
// 正解:path和value都为"/getbaidu"
@RequestMapping(path="/getbaidu", value="/getbaidu", method=RequestMethod.GET)
// 错误:因为path和value已经绑定,互为别名,因此值必须一样
@RequestMapping(path="/getbaidu", value="/getgoogle", method=RequestMethod.GET)
- 此外,注意一点,因为互为别名,因此path和value的默认值,即default值必须一样
场景2:为其它注解别名
- 还是以@RequestMapping为例,我们为@RequestMapping换个名称:NewRM
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
@RequestMapping // 这个地方不能少,不知道为什么????
public @interface NewRM {
@AliasFor(value="path", annotation = RequestMapping.class)
String[] ph() default {};
@AliasFor(value="method", annotation = RequestMapping.class)
RequestMethod[] md() default {};
... 其它略 ....
}
- 这样设置以后,下面两种方式就变成完全等价的了:
// 这两行注解是完全等价的
@RequestMapping(path="/getbaidu", method=RequestMethod.GET)
@NewRM(ph="/getbaidu", md = RequestMethod.GET)
场景3:传递别名(跟场景2很类似):再来看NewRM:
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
@RequestMapping // 这个地方不能少,不知道为什么????
public @interface NewRM {
@AliasFor(value="path", annotation = RequestMapping.class)
String[] ph() default {};
@AliasFor(value="method", annotation = RequestMapping.class)
RequestMethod[] md() default {};
// 这里用了attribute传递,而在AliasFor中,attribute与value是相通的,因此ph2等价于ph
@AliasFor(attribute="path", annotation = RequestMapping.class)
String[] ph2() default {};
... 其它略 ....
}
- 因此,下面三种方式是等价的:
// 这三行注解是完全等价的
@RequestMapping(path="/getbaidu", method=RequestMethod.GET)
@NewRM(ph="/getbaidu", md = RequestMethod.GET)
@NewRM(ph2="/getbaidu", md = RequestMethod.GET)
更加深层次的介绍,参见这里:https://www.jianshu.com/p/869ed7037833