java Annotation（注解）（一）

1.认识注解

注解也被称为元数据，那什么是元数据？所谓的元数据就是用来定义数据的数据，如类的属性和方法等这些都是类的元数据。注解想当与在代码做一些特殊的标记,这些注解可以在编译，类加载，运行时候不改变原有的逻辑的情况下，被读取，并执行相应的处理。 如下下面例子中Override注解所示

public class Test {/* 这里的Override就是一个标记，也就是我们所说的注解，它标记toString()方法就是一个覆写父类中的方法，因此我们如果我们将toString()方法名字写错了，则编译器就会根据这个Override的注解标记提示出相应的错误*/@Override public String toString(){return "";}}

注解类似于修饰符一样被使用，可以用于包，类构造方法，方法，成员变量，参数，局部变量。

2.系统定义三个内置注解以及四种元注解

注解的的语法比较简单，除了@符号使用之外，它基本与Java的固有语法一致。Java SE5内置了三种注解，定义在Java.lang中的注解：

@Override，表示当前的方法定义覆盖超类中的方法，如果你不小心拼写错误，或者方法签名对不上覆盖的方法，编译器就会发出错误提示。

@Deprecated 表示一个类或者方法以及过时，不建议再使用。如果程序员使用了它，编译器就会发出警告的信息。

@SuppressWarnings,关闭不当的编译警告信息。

下面我给出Override的注解类，JDK中定义源代码

@Target(ElementType.METHOD)@Retention(RetentionPolicy.SOURCE)public @interface Override {}

四种元注解主要用来注解其它的注解

（1）@Target 表示该注解可以用于什么地方，也就是说其使用范围，值得说明的事当属性名定义为value时候，在使用该注解的赋值的时候alue可以省略。

@Documented@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.ANNOTATION_TYPE)public @interface Target {    ElementType[] value();}

枚举ElementType 主要成员，该成员用来描述枚举

public enum ElementType {    /** Class, interface (including annotation type), or enum declaration */    TYPE,    /** Field declaration (includes enum constants) */    FIELD,    /** Method declaration */    METHOD,    /** Parameter declaration */    PARAMETER,    /** Constructor declaration */    CONSTRUCTOR,    /** Local variable declaration */    LOCAL_VARIABLE,    /** Annotation type declaration */    ANNOTATION_TYPE,    /** Package declaration */    PACKAGE}

@Retention 表示需要在什么级别上保存注解信息，SOURCE 注解将会编译器丢弃，也就是说其只在编译阶段起作用，如何Override只是在编译阶段起作用

CLASS 表示注解在class文件中可用，但在JVM中会丢弃。RUNTIME表示在运行时候注解依然可用。

@Documented@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.ANNOTATION_TYPE)public @interface Retention {    RetentionPolicy value();}

RetentionPolicy枚举

public enum RetentionPolicy {    /**     * Annotations are to be discarded by the compiler.     */    SOURCE,    /**     * Annotations are to be recorded in the class file by the compiler     * but need not be retained by the VM at run time.  This is the default     * behavior.     */    CLASS,    /**     * Annotations are to be recorded in the class file by the compiler and     * retained by the VM at run time, so they may be read reflectively.     *     * @see java.lang.reflect.AnnotatedElement     */    RUNTIME}

@Documented 注解表示的是文档化，可以生成doc文档的时候添加的注解，该注解是一个标记。

@Inherited 注解表示一个注解是否允许被其自己继承下来

3.自定义注解

注解的应用需要三个基本步骤：

（1）.编写注解

（2）.在类上应用注解

（3）.对应用类注解类进行反射操作的类，因为只有这样才能让注解起作用

自定义的注解的语法如下：

访问控制权限 @interface 注解名{}

下面给出一个注解实例

package com.ahu.annotation.test.demo;import java.lang.annotation.ElementType;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;/* *自定义注解 */@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)public @interface MyAnnotation {public String name();//注解的属性，类似于方法的定义public String info() default "student";public String[] like();//爱好public EnumSex sex();//性别}

在User类上使用注解

package com.ahu.annotation.test.demo;

/*使用自定义注解需要给相应的属性赋值,如何注解在定义的时候相应的属性已经给出了相应的缺省值,可以不用赋值，如info这个属性 * like 数组赋值 * sex 是枚举类型的数据赋值 */@MyAnnotation(name="hsc",like={"running","watch tv"},sex=EnumSex.MALE)public class User {private String name;public String getName() {return name;}public void setName(String name) {this.name = name;}}

package com.ahu.annotation.test.demo;public enum EnumSex {MALE,FEMALE}

主函数入口测试类

package com.ahu.annotation.test.demo;import java.lang.annotation.Annotation;public class Test {public static void main(String []args){try {Class<?> c=Class.forName("com.ahu.annotation.test.demo.User");//获取类中标记中的所有类的标记 ，如何在类中标记可以class直接获取注解//如果在方法中标记可以通过获取方法拿到注解Annotation[] annotations=c.getAnnotations();for(Annotation a:annotations){//判断是否是自己所指定的注解if(c.isAnnotationPresent(MyAnnotation.class)){MyAnnotation my=(MyAnnotation)a; //强制转换System.out.println(my.name()); //输出注解内容System.out.println(my.info());}}} catch (ClassNotFoundException e) {// TODO Auto-generated catch blocke.printStackTrace();}}}

注解离开了反射，它就变成了一个空架子。