JavaAnnotation详解.doc

? 元数据的作用 如果要对于元数据的作用进行分类，目前还没有明确的定义，不过我们可以根据它所起的作用，大致可分为三类： l ???????? 编写文档：通过代码里标识的元数据生成文档。 l ???????? 代码分析：通过代码里标识的元数据对代码进行分析。 l ???????? 编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查。 ? 基本内置注释 ??? @Override 注释能实现编译时检查，你可以为你的方法添加该注释，以声明该方法是用于覆盖父类中的方法。如果该方法不是覆盖父类的方法，将会在编译时报错。例如我们为某类重写toString() 方法却写成了tostring() ，并且我们为该方法添加了@Override 注释； ???? @Deprecated 的作用是对不应该在使用的方法添加注释，当编程人员使用这些方法时，将会在编译时显示提示信息，它与javadoc 里的 @deprecated 标记有相同的功能，准确的说，它还不如javadoc @deprecated ，因为它不支持参数， 注意：要了解详细信息，请使用 -Xlint:deprecation 重新编译。 ??? @SuppressWarnings 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参数值都是已经定义好了的，我们选择性的使用就好了，参数如下： ? deprecation?? 使用了过时的类或方法时的警告 unchecked? 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型 fallthrough?? 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告 path?? 在类路径、源文件路径等中有不存在的路径时的警告 serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告 finally??? 任何 finally 子句不能正常完成时的警告 all 关于以上所有情况的警告 ? 注意：要了解详细信息，请使用 -Xlint:unchecked 重新编译。 ? 定制注释类型 ??? 好的，让我们创建一个自己的注释类型（annotation type ）吧。它类似于新创建一个接口类文件，但为了区分，我们需要将它声明为@interface, 如下例： public @interface NewAnnotation { ? } ? 使用定制的注释类型 ??? 我们已经成功地创建好一个注释类型NewAnnotation ，现在让我们来尝试使用它吧，如果你还记得本文的第一部分，那你应该知道他是一个标记注释，使用也很容易，如下例： public class AnnotationTest { ? ??? @NewAnnotation ??? public static void main(String[] args) { ??? ??? } } ? 添加变量 ??? J2SE 5.0 里，我们了解到内置注释@SuppressWarnings() 是可以使用参数的，那么自定义注释能不能定义参数个数和类型呢？答案是当然可以，但参数类型只允许为基本类型、String 、Class 、枚举类型等，并且参数不能为空。我们来扩展NewAnnotation ，为之添加一个String 类型的参数，示例代码如下： public @interface NewAnnotation { ? ??? String value(); } ??? 使用该注释的代码如下：正如你所看到的，该注释的使用有两种写法，这也是在之前的文章里所提到过的。如果你忘了这是怎么回事，那就再去翻翻吧。 public class AnnotationTest { ? ??? @NewAnnotation(Just a Test.) ??? public static void main(String[] args) { ??????? sayHello(); ??? } ??? ??? @NewAnnotation(value=Hello NUMEN.) ??? public static void sayHello() { ??????? // do something ??? } } ? 为变量赋默认值 ??? 我们对Java 自定义注释的了解正在不断的增多，不过我们还需要更过，在该条目里我们将了解到如何为变量设置默认值，我们再对NewAnnotaion 进行修改，看看它会变成什么样子，不仅参数多了几个，连类名也变了。但还是很容易理解的，我们先定义一个枚举类型，然后将参数设置为该