学习Java注解Annotation

 1.概述

    注解可以定义到方法上，类上，一个注解相当与一个类，就相当于实例了一个对象，加上了注解，就相当于加了一个标志。

    常用的注解：

    @Override:表示重新父类的方法，

    这个也可以判断是否覆盖的父类方法，在方法前面加上此语句，如果提示的错误，那么你不是覆盖的父类的方法，要是提示的没有错误，那么就是覆盖的父类的方法。

    @SuppressWarnings（"deprecation"）：取消编译器的警告（例如你使用的方法过时了）

    @Deprecated:在方法的最上边也上此语句，表示此方法过时，了，或者使用在类上面

import java.util.ArrayList;
    import java.util.List;
    public class annotationDemo {
    /*
    * 对于集合，如果没有指定存储的类型，那么就会有安全警告，
    * 如果不想提示安全警告的话，那么就所在类或者方法上添加@SuppressWarnings（参数）
    */
    @SuppressWarnings（"unchecked"）
    public static void main（String[] args） {
    List list=new ArrayList（）；
    }
    }

 2.自定义注解

    1.格式

    权限 @interface 注解名称 { }

    步骤：

    定义注解类--->定义应用注解类的类--->对应用注解类的类进行反射的类（这个类可以另外定义，也可以是在应用注解类中进行测试）

import java.lang.annotation.Retention;
    importjava.lang.annotation.RetentionPolicy;
    //定义此注解保留在字节码中
    @Retention（RetentionPolicy.RUNTIME）
    public @interface MyAnnotation {
    }
    @MyAnnotation
    // 应用定义的注解类
    public class ApplyMyAnnotation {
    public static void main（String[] args） {
    if （ApplyMyAnnotation.class.isAnnotationPresent（MyAnnotation.class）） {// 判断此类上是否存在指定的注解类
    MyAnnotation annotation= （MyAnnotation） ApplyMyAnnotation.class
    .getAnnotation（MyAnnotation.class）；
    System.out.println（annotation）；
    }
   }
}

 2.声明周期

    格式：例如：@Retention（RetentionPolicy.CLASS）

    在自定一的注解类上定义周期，@Retention（参数类型） 参数类型是RetentionPolicy

    RetentionPolicy.CLASS:类文件上，运行时虚拟机不保留注解

    RetentionPolicy.RUNTIME:类文件上，运行时虚拟就保留注解

    RetentionPolicy.SOURCE:源文件上，丢弃注解

    SuppressWarnings和Override是RetentionPolicy.SOURCE,

    Deprecated是在RetentionPolicy.RUNTIME,要向运行时调用定义的一样，那么必须是RetentionPolicy.RUNTIME,

    默认的都是RetentionPolicy.CLASS:

3.指定目标

    格式：例如：方法上@Target（ElementType.METHOD）

    定义的注解可以注解什么成员。如果不声明此注解，那么就是可以放到任何程序的元素上。

    可以是包，接口，参数，方法，局部变量，字段…等。

//定义此注解保留在字节码中
    @Retention（RetentionPolicy.RUNTIME）
    @Target（{ElementType.METHOD,ElementType.TYPE}）//可以定义在方法上和类上接口，表示类型
    public @interface MyAnnotation {
    }
    @MyAnnotation
    // 应用定义的注解类
    public class ApplyMyAnnotation {
    @MyAnnotation//定义在方法上
    public static void main（String[] args） {
    if （ApplyMyAnnotation.class.isAnnotationPresent（MyAnnotation.class）） {// 判断此类上是否存在指定的注解类
    MyAnnotation annotation = （MyAnnotation） ApplyMyAnnotation.class
    .getAnnotation（MyAnnotation.class）；
    System.out.println（annotation）；
    }
    }
    }

  3.为注解添加属性

    1.类型

    注解的属性置可以是：8个基本数据类型，String,枚举，注解，Class,数组类型，

    2.注意点

    当注 解中只有一个属性或者是只有一个属性需要赋值的话，那么在调用的时候，就可以直接写入，不需要指定属性名，

    当注解的属性是数组类型并且赋值的时候只赋值一个值，那么就可以省略{}.

    3.示例

    3.1.属性类型（是String）

import java.lang.annotation.ElementType;
    import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    import java.lang.annotation.*;
    //定义此注解保留在字节码中
    @Retention（RetentionPolicy.RUNTIME）
    public @interface MyAnnotation {
    String value（） ;
    String Color（）default "red";//设置默认值是"red"
    }
    @MyAnnotation（"java"）
    public class ApplyMyAnnotation {
    public static void main（String[] args） {
    /**
    * 这是获得类上的注解，也可以获得方法上的注解，下面就以获得类上的注解为例
    */
    if （ApplyMyAnnotation.class.isAnnotationPresent（MyAnnotation.class）） {// 判断此类上是否存在指定的注解类
    MyAnnotation annotation = （MyAnnotation） ApplyMyAnnotation.class
    .getAnnotation（MyAnnotation.class）；
    System.out.println（"value="+annotation.value（））；
    System.out.println（"Color="+annotation.Color（））；
    }
    }
  }

 结果：

    value=java

    Color=red

    从调用的程序中，也可以看出，只有一个属性可以需要赋值的话，可以省略属性名。否则@注解类（属性名=值）

    3.2.综合类型

/*枚举类*/
    public enum Week{
    SUN,MON;
    }
    /**
    * 注解类
    */
    public @interface annotationText {
    String value（）；
    }
    import java.lang.annotation.ElementType;
    import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    import java.lang.annotation.*;
    //定义此注解保留在字节码中
    @Retention（RetentionPolicy.RUNTIME）
    public @interface MyAnnotation {
    String value（） ;
    String Color（）default "red";//设置默认值是"red"
    Week week（） default Week.MON;//枚举类型
    int [] array（） default {1,2,3};//数组类型
    annotationText annotation（） default @annotationText（"MY"）；//注解类型
    Class classDemo（） default Integer.class;//Class类型
    }
    @MyAnnotation（value="java",Color="green",week=Week.SUN,array=5,annotation=@annotationText（"YOU"），classDemo=String.class）//数组array={4,5,6}
    public class ApplyMyAnnotation {
    public static void main（String[] args） {
    /**
    * 这是获得类上的注解，也可以获得方法上的注解，下面就以获得类上的注解为例
    */
    if （ApplyMyAnnotation.class.isAnnotationPresent（MyAnnotation.class）） {// 判断此类上是否存在指定的注解类
    MyAnnotation annotation= （MyAnnotation） ApplyMyAnnotation.class
    .getAnnotation（MyAnnotation.class）；
    System.out.println（"value="+annotation.value（））；
    System.out.println（"Color="+annotation.Color（））；
    System.out.println（"week="+annotation.week（））；
    System.out.println（"array长度="+annotation.array（）。length）；
    System.out.println（"注解类型值="+annotation.annotation（）。value（））；
    System.out.println（"Class类型值="+annotation.classDemo（））；
    }
    }
    }

 结果：

    value=java

    Color=green

    week=SUN

    array长度=1

    注解类型值=YOU

    Class类型值=classjava.lang.String

    4.Method上的注解

 import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    /**
    * 注解类
    */
    @Retention（RetentionPolicy.RUNTIME）
    public @interface annotationText {
    String value（）；
    }
    public class ApplyMyAnnotation {
    public static void main（String[] args） throws Exception {
    Method methodshow = ApplyMyAnnotation.class.getMethod（"show"）；
    annotationText anno = methodshow.getAnnotation（annotationText.class）；
    System.out.println（anno.value（））；
    }
    @annotationText（"java"）
    public void show（） {
    System.out.println（"hello"）；
    }
    }

 结果：

    java

评论

2 楼 QuarterLifeForJava 2013-10-27  

从public @interface annotationText 里的@interface就可以看出，写法应该和接口类似：

public @interface Test {
	public String s();
	int x();
	abstract String get();
}

1 楼 jacking124 2013-10-25  

总结归纳的不错的！！