黑马程序员_java 加强-注解

----------------------android培训、java培训、期待与您交流！ ----------------------

注解(注释)Annotation类

jdk1.5以后提供的新特性

①类中的注释有三个@Deprecated(废除)、@Override(复写)、@SuppressWarnings(压缩警告)

Deprecated类

用 @Deprecated 注释的程序元素，不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时，编译器会发出警告。

Override类

@Override表示一个方法声明打算重写超类中的另一个方法声明。

SuppressWarnings类

@SuppressWarnings指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。如果要在特定的方法中取消显示某个警告，则应该注释该方法而不是注释它的类。

注释的反射：

class类中的isAnnotation()和isAnnotationPresent方法可以检测这个class对象上是否有注释并且可以获取这个注释

boolean isAnnotation()

如果此 Class 对象表示一个注释类型则返回 true。

boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)

如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。

②注释中的注释有四个Documented类、Inherited类、Retention类和Target类

Documented类

指示某一类型的注释将通过 javadoc 和类似的默认工具进行文档化。

Inherited类

指示注释类型被自动继承。如果在注释类型声明中存在 Inherited 元注释，并且用户在某一类声明中查询该注释类型，同时该类声明中没有此类型的注释，则将在该类的超类中自动查询该注释类型。此过程会重复进行，直到找到此类型的注释或到达了该类层次结构的顶层 (Object) 为止。如果没有超类具有该类型的注释，则查询将指示当前类没有这样的注释。

注意，如果使用注释类型注释类以外的任何事物，此元注释类型都是无效的。还要注意，此元注释仅促成从超类继承注释；对已实现接口的注释无效。

Retention类

指示注释类型的注释要保留多久。如果注释类型声明中不存在 Retention 注释，则保留策略默认为 RetentionPolicy.CLASS。

三种取值：RetentionPolicy.SOURCE 、RetentionPolicy.CLASS 、RetentionPolicy.RUNTIME 分别对应的阶段为：java源文件，class文件，内存字节码

注意：只有元注释类型直接用于注释时，Target 元注释才有效。

Target类

指示注释类型所适用的成分。

参数：

ElementType.[

ANNOTATION_TYPE 注释类型声明

CONSTRUCTOR 构造方法声明

FIELD 字段声明（包括枚举常量）

LOCAL_VARIABLE 局部变量声明

METHOD 方法声明

PACKAGE 包声明

PARAMETER 参数声明

TYPE 类、接口（包括注释类型）或枚举声明 ]

③。注解属性

注解的属性就类似于注释的标志

注解的属性可以包括String类型，Class类型，8个基本类型，8个基本类型加String类型的数组类型，枚举类型，注释类型。

自定义注解实例

package cn.itcast.day2;
import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import java.lang.annotation.ElementType;
import java.lang.annotation.RetentionPolicy;
/*
 * 元注解@Target,@Retention,@Documented,@Inherited
 * @Target 表示该注解用于什么地方，可能的 ElemenetType 参数包括：
 * ElemenetType.CONSTRUCTOR 构造器声明
 * ElemenetType.FIELD 域声明（包括 enum 实例）
 * ElemenetType.LOCAL_VARIABLE 局部变量声明
 * ElemenetType.METHOD 方法声明
 * ElemenetType.PACKAGE 包声明
 * ElemenetType.PARAMETER 参数声明
 * ElemenetType.TYPE 类，接口（包括注解类型）或enum声明
 * @Retention 表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括：
 * RetentionPolicy.SOURCE 注解将被编译器丢弃
 * RetentionPolicy.CLASS 注解在class文件中可用，但会被VM丢弃
 * RetentionPolicy.RUNTIME VM将在运行期也保留注释，因此可以通过反射机制读取注解的信息。
 * @Documented 将此注解包含在 javadoc 中
 * @Inherited 允许子类继承父类中的注解
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
/*
* 定义注解 Test
* 注解中含有两个元素 id 和 description
* description 元素 有默认值 "no description"
*/
public @interface Test {
     public int id();
     public String description() default "no description";
}

下面是一个使用注解 和 解析注解的实例

package cn.itcast.day2;
import java.lang.reflect.Method;
public class Test_1 {
  /*
   * 被注解的三个方法
     */
 @Test(id = 1, description = "hello method_1")
 public void method_1() {

  }
  @Test(id = 2)
  public void method_2() {

 }

  @Test(id = 3, description = "last method")
     public void method_3() {

  }
 /*

  * 解析注解，将Test_1类 所有被注解方法 的信息打印出来

 */
 public static void main(String[] args) {
  Method[] methods = Test_1.class.getDeclaredMethods();
  for (Method method : methods) {
   /*
             * 判断方法中是否有指定注解类型的注解

  */
            boolean hasAnnotation = method.isAnnotationPresent(Test.class);
            if (hasAnnotation) {
                /*
                 * 根据注解类型返回方法的指定类型注解
    */
    Test annotation = method.getAnnotation(Test.class);
     System.out.println("Test( method = " + method.getName()
        + " , id = " + annotation.id() + " , description = "
        + annotation.description() + " )");
   }
  }
 }
}

输出结果如下：

    Test( method = method_1 , id = 1 , description = hello method_1 )

    Test( method = method_2 , id = 2 , description = no description )

    Test( method = method_3 , id = 3 , description = last method )

 

 

---------------------- android培训、java培训、期待与您交流！ ----------------------

详细请查看：http://edu.csdn.net/heima