限定annotation使用对象@Target
使用java.lang.annotation.Target可以定义其使用之时机,在定义时要指定java.lang.annotation.ElementType的枚举值之一。
一个annotation不加限定的话,其可以定义在程序任何地方使用,可以放在类,方法,属性等前都可以.
用@Target可以加以限定定义的annotation放的位置,结合ElementType使用.
package java.lang.annotation;
public enum ElementType
{
TYPE, //适用class, interface, enum
FIELD, //适用field
METHOD, //适用method
PARAMETER, //适用method上之parameter
CONSTRUCTOR, //适用constructor --构造方法
LOCAL_VARIABLE, //适用局部变量
ANNOTATION_TYPE, //适用annotation型态
PACKAGE //适用package
}
总结来说:Target可以限定定义的annotation放在程序什么位置。
要求为API文件@Documented:
想要在使用者制作JavaDoc文件的同时,也一并将Annotation的讯息加入至API文件中,使用至API文件中,使用java.lang.annotation.Documented
在定义annotation时前面加入@Documented,那么在javadoc时会将加入到程序前面的annotation信息一起加到doc中.
eclipse制作javadoc,菜单-->Project-->Generate Javadoc 选择想要制作的类或全部即可生成javadoc
子类是否继承父类@Inherited
预设上父类别中的Annotation并不会被继承至子类别中,可以在自定义annotation型态时加上
java.lang.annotation.Inherited型态的annotation.即@Inherited
这样就可以被子类继承了,如果子类覆写了父类的方法,则不会继承父类的annotation,方法被覆盖,注解也一样的被覆盖了。
在接口中实现类不会继承接口中的annotation
附件为学习annotation小例子