JAVA注解技术详解 课件.ppt

Annotation Exploration Java 5 新特性－－注解 概览 Jet 2019.08.30 Annotation in JDK 5.0 －－将元数 据（ metadata ）引入 Java a. 元数据是描述数据的数据 b. Javadoc 、 XDoclet 都是元数据工具 b. 元数据的用处 文档编制、编译器检查和代码分析 标准 Annotation 类型 a. Override 表示一个方法声明打算重写父类中的另一个方法声明 b. SuppressWarnings 指示应该在注解元素中取消显示指定的编译器警告 c. Deprecated 不鼓励程序员使用这样的元素，因为很危险或存在更 好的选择 标准 Annotation 类型 代码示例 Override public String totring(){ //some code } 编译时会提示错误，因为此方法并没有重写父类里的 toString() 方法。 Deprecated public String getString(){ //some code } 当其他类试图调用或重写此方法时，编译器会发出警告 SuppressWarnings(“unchecked”) public void add(){ List temp = new ArrayList(); temp.add(annotation test!!!); } 当其他类试图调用或重写此方法时，编译器会发出警告 自定义 Annotation 1. Public interface TestAnnotation{ 2. int id(); 3. String description() default “nothing”; 4. String[] reason(); 5. } 6. 使用时： 1. 在所有修饰符前声明； 2. 如果含有成员， 声明时必须初始化； 3. 允许使用默认值； 4. 只有单 个成员变量时，最好叫做 value() ，这样可以使用 简化的初始声明。 自定义 Annotation 1. 对注解的注解： 2. 1.Target ，从枚举类 ElementType 里取一个或多个 值，指明此注解可以应用的程序元素。 3. 2.Retention ，保持性，从枚举类 RetentionPolicy 里取唯一值指明编译器处理此注解的方式。 4. 3.Documented ，注解应出现在 javadoc 里； RetentionPolicy.RUNTIME 的注解才能使用。 5. 4.Inherited ，表示此注解的方法期望把父类的注解 也继承下来。慎用。 自定义 Annotation 1. Documented 2. Inherited ? Target(value={ElementType.FIELD,ElementType. METHOD}) ? Retention(RetentionPolicy.RUNTIME ) ? Public interface AdvancedAnnotation{ ? //some members declared here. ? } Annotation 与反射 1. JDK 5.0 反射 API 增加了读取 运行时 annotation 的能 力 2. isAnnotationPresent(Class annotationClass) 3. getAnnotation(Class annotationClass) 4. getAnnotations() 5. getDeclaredAnnotations() 省去由继承获得的 annotation 6. getParameterAnnotations() 没试过 Annotation 与反射 1. 利用反射机制我们可以对 annotation 进行灵活的处 理 2. 1. 获得不同的 Annotation 3. 2. 获得 Annotation 的成员变量 4. 见示例代码 apt ： sun 提供的 annotation processing tools 1. 专门处理 annotation 的 javac ，据说 jdk 6.0 已经将其 加入 javac 2. 一般需要自己定义 annotation 处理接口 3. apt – factory ourProcessorFactory ${dir}