Annotation-java注解

Java中提供3个内置注释类型

a. Override ，只能用于方法（不能用于类，包声明或者其他构造）
?作用：注释能实现编译时检查，你可以为你的方法添加该注释，以声明该方法是用于覆盖父类中的方法。如果该方法不是覆盖父类的方法，将会在编译时报错。?用法：
?@Override
? public void fun(){..}

b.Deprecated? 同样只能作用与方法
?作用：是对不应该在使用的方法添加注释，当编程人员使用这些方法时，将会在编译时显示提示信息，它与javadoc里的@deprecated标记有相同的功能，准确的说，它还不如javadoc @deprecated，因为它不支持参数.

?用法：
?@Deprecated
?public void fun{...}

?

c.SupressWarnings 可以注释一段代码
?作用：关闭特定的警告信息，例如你在使用泛型的时候未指定类型
?用法：?

???? 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参数值都是已经定义好了的，我们选择性的使用就好了，参数如下：?

???? deprecation?? 使用了过时的类或方法时的警告

???? unchecked? 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型

???? fallthrough?? 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告

???? path?? 在类路径、源文件路径等中有不存在的路径时的警告

???? serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告

???? finally??? 任何 finally 子句不能正常完成时的警告

?????all 关于以上所有情况的警告?

?@SupressWarnings(value={"unchecked"})
?public void fun{...}

?

?

?

Java中还提供了四种元注释，专门负责注释其他的注释

@Target表示该注释可以用于什么地方。
???可用的ElementType参数包括：
?????? CONSTRUCTOR : 构造器的声明
?????? FIELD : 域声明（包括enum实例）
?????? LOCAL_VARIABLE : 局部变量声明
?????? METHOD : 方法声明
?????? PACKAGE : 包声明
?????? PARAMETER : 参数声明
?????? TYPE : 类、接口 （包括注解类型) 或enum声明

public enum ElementType {    /** Class, interface (including annotation type), or enum declaration */    TYPE,    /** Field declaration (includes enum constants) */    FIELD,    /** Method declaration */    METHOD,    /** Parameter declaration */    PARAMETER,    /** Constructor declaration */    CONSTRUCTOR,    /** Local variable declaration */    LOCAL_VARIABLE,    /** Annotation type declaration */    ANNOTATION_TYPE,    /** Package declaration */    PACKAGE}

??

@Retention 表示需要在什么级别保存该注释信息。可选的RetentionPoicy参数包括：
??????? SOURCE : 注释将被编译器丢掉
??????? CLASS : 注释在class文件中可用，但会被VM丢弃
??????? RUNTIME : VM将在运行时也保留注释，因此可以通过反射机制读取注释的信息。

public enum RetentionPolicy {    /**     * Annotations are to be discarded by the compiler.     */    SOURCE,    /**     * Annotations are to be recorded in the class file by the compiler     * but need not be retained by the VM at run time.  This is the default     * behavior.     */    CLASS,    /**     * Annotations are to be recorded in the class file by the compiler and     * retained by the VM at run time, so they may be read reflectively.     *     * @see java.lang.reflect.AnnotatedElement     */    RUNTIME}

?

@Documented 将注释包含在JavaDoc中

@Inheried? 允许子类继承父类中的注释。

?