java_注解.docVIP

高阶Java-Java注解 Java annotation 使用详解 文章分类:Java编程 来越的开源框架都提供了“元数据”支持了。为了不outdate，今天系统学习一下Java的注释（又叫元数据）。本文将遵循以下的结构布局1.什么是元数据？有什么作用2.Java的“注释”3.在Java中定义自己的注释4.总结一下 -----------------------开始---------------------- 1.什么是元数据，有什么作用？ 元数据，就是“关于数据的数据”。功能也有很多啦。你可能用过Javadoc的注释自动生成文档。这就是元数据功能的一种。总的来说，元数据可以用来创建文档，跟踪代码的依赖性，执行编译时格式检查，代替已有的配置文件（如Hibernate也提供了注释配置） 注释有3中基本类型 a.标记注释????? --没有变量，只有名称标识。例如 @annotationb.单一值注释??? --在标记注释的基础上提供一段数据。如 @annotation（“data”）c.完整注释????? --可以包括多个数据成员，每个数据成员由名称和值构成。????????????????? @annotation(val1=data1,val2=data2) 2.Java的“注释” Java中提供3个内置注释类型 a. Override ，只能用于方法（不能用于类，包声明或者其他构造）????????????? 作用：可以保证编译时候Override函数的声明正确性????????????? 用法：@Override??????????????????? public void fun(){..} b.Deprecated? 同样只能作用与方法????????????? 作用：对不应再使用的方法进行注解????????????? 用法：@Deprecated public void fun{...} //它们说这个注释跟函数要同一行 c.SupressWarnings 可以注释一段代码????????????????? 作用：关闭特定的警告信息，例如你在使用泛型的时候未指定类型????????????????? 用法： @SupressWarnings(value={unchecked})???????????????????????? ..代码 Java中还提供了四种元注释，专门负责注释其他的注释 @Target?? 表示该注释可以用于什么地方。可用的ElementType参数包括：????????? CONSTRUCTOR : 构造器的声明????????? FIELD : 域声明（包括enum实例）????????? LOCAL_VARIABLE : 局部变量声明????????? METHOD : 方法声明????????? PACKAGE : 包声明????????? PARAMETER : 参数声明????????? TYPE : 类、接口 （包括注解类型) 或enum声明 @Retention 表示需要在什么级别保存该注释信息。可选的RetentionPoicy参数包括：?????????? SOURCE : 注释将被编译器丢掉?????????? CLASS : 注释在class文件中可用，但会被VM丢弃?????????? RUNTIME : VM将在运行时也保留注释，因此可以通过反射机制读取注释的信息。 @Documented 将注释包含在JavaDoc中 @Inheried? 允许子类继承父类中的注释。 3. 在Java中定义自己的注释 Java语言支持一种新的类型--注释类型（annotation type），跟普通类差不多，在类中以符号（ @ ）的形式注释其他 Java 代码 下面将通过一个简单的例子来实现（代码是Brett McLaughlin 的） @interface 申明 i.简单的注释类型package com.oreilly.tiger.ch06;/**?* Marker annotation to indicate that a method or class?* is still in progress.?*/public @interface InProgress { } ii.使用定制的注释类型@com.oreilly.tiger.ch06.InProgresspublic void calculateInterest(float amout,float rate){????? //Need to finish this method later} iii.添加成员package com.oreil