Java+Annotation+介绍.ppt

Java Annotation 介绍 一、为什么使用Annotation： 在JAVA应用中，我们常遇到一些需要使用模版代码。例如，为了编写一个JAX-RPC web service，我们必须提供一对接口和实现作为模版代码。如果使用annotation对远程访问的方法代码进行修饰的话，这个模版就能够使用工具自动生成。 另外，一些API需要使用与程序代码同时维护的附属文件。例如，JavaBeans需要一个BeanInfo Class与一个Bean同时使用/维护，而EJB则同样需要一个部署描述符。此时在程序中使用annotation来维护这些附属文件的信息将十分便利而且减少了错误。 二、Annotation工作方式： 从Java5.0版发布以来，5.0平台提供了一个正式的annotation功能：允许开发者定义、使用自己的annoatation类型。此功能由一个定义annotation类型的语法和一个描述annotation声明的语法，读取annotaion的API，一个使用annotation修饰的class文件，一个annotation处理工具（apt）组成。 annotation并不直接影响代码语义，但是它能够工作的方式被看作类似程序的工具或者类库，它会反过来对正在运行的程序语义有所影响。annotation可以从源文件、class文件或者以在运行时反射的多种方式被读取。 当然annotation在某种程度上使javadoc tag更加完整。一般情况下，如果这个标记对java文档产生影响或者用于生成java文档的话，它应该作为一个javadoc tag；否则将作为一个annotation。 三、Annotation使用方法： 1。类型声明方式： 2。修饰方法的annotation声明方式： 一个简单的annotation类型声明： ????/**???? * Describes the Request-For-Enhancement(RFE) that led???? * to the presence of the annotated API element.???? */????public @interface RequestForEnhancement {????????int????id();????????String synopsis();????????String engineer() default [unassigned]; ????????String date();????default [unimplemented]; ????} 2。修饰方法的annotation声明方式： annotation是一种修饰符，能够如其它修饰符（如public、static、final）一般使用。习惯用法是annotaions用在其它的修饰符前面。annotations由“@+annotation类型+带有括号的成员-值列表”组成。这些成员的值必须是编译时常量（即在运行时不变）。 一个使用了RequestForEnhancement annotation的方法声明： ??@RequestForEnhancement(????????id?????? = 2868724,????????synopsis = Enable time-travel,????????engineer = Mr. Peabody,????????date???? = 4/1/3007????)????public static void travelThroughTime(Date destination) { ... } 当声明一个没有成员的annotation类型声明时，可使用以下方式： ??/**???? * Indicates that the specification of the annotated API element???? * is preliminary and subject to change.???? */????public @interface Preliminary { } 作为上面没有成员的annotation类型声明的简写方式： ????@Preliminary public class TimeTravel { ... } 如果在annotations中只有唯一一个成员，则该成员应命名为value： ????/**???? * Associates a copyright notice with the annotated API element.???? */????public @interface Copyright