JAVA 中的文档注解

    @see 用来跳转查看其他Api的

    @since 1.9  用来说明什么版本引入这个Api的

    @deprecated 用来说明由哪个新办法取代了这个

    @throws 用来说明抛出哪个异常

    @return 用来说明返回了什么值

    @param  用啦说明传入了什么参数

jdk 1.5 之后引入的Annotation：

    @Override

    @SuppressWarnings(ALL) --取消编译期的警告提示 

注解是用来解释程序的

自定义注解：  @注解名

元注解：用来解释注解

    @Target          --解释注解可以用在哪里的 

                        ->

                                通过ElementType来取值 (TYPE、METHOD、FIELD.....）

用例：

                          1.@Target(ElementType.TYPE)可以用在类、接口、枚举...

                          2.@Target(ElementType.METHOD)可以用在方法上

                          3.@Target(ElementType.FIELD)可以用在属性上

                          4.@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD})

    @Retention      --解释注解的生命周期，约束注解的生命周期，分别有三个值，源码级                                                别source），类文件级别（class）或者运行时级别（runtime）。

                           ->   

                                通过 RetentionPolicy来取值(RUNTIME,CLASS,SOURCE)

用例：

                    1.@Retention(RetentionPolicy.RUNTIME) 注解信息将在运行期(JVM)也保留，因此                           可以通过反射机制读取注解的信息（源码、class文件和执行的时候都有注解的信息）

                    2.@Retention(RetentionPolicy.SOURCE) --该类型的注解信息只会保留在源码里

                    3.@Retention(RetentionPolicy.CLASS) --注解在class文件中可用