Java-注解

 ----------------------java学习型技术博客、期待与您交流！！ ----------------------

1. Annotation:注解
是JDK5.0以上版本提供的可以添加到代码之上的修饰符，用来对该代码进行解释和说明。
   1) 可以放置在类的任何组成部分，如：包声明、类（或接口）声明、构造方法、普通方法、成员变量、参数和局部变量。
   2) 注解的使用不会影响代码的功能。
  
2. Java SE API中提供了三个内置注解类型：定义在java.lang包中。注解类型使用时要用@符来引用。
   1) Override：表示一个方法声明打算重写超类中的另一个方法声明。只能用在方法上。它只会保存在源文件中，编译成字节码时会被

丢弃。
   2) Deprecated：它修饰元素时表示不鼓励程序员使用这样的元素。它可以添加到类的任何位置。它会编译到字节码中，并且JVM可以获

取它的信息
   3) SupressWarnings：用来阻止编译器警告。它可用在除包以外的任何位置。它带有一个属性叫value,指定要阻止的警告集。

 

3. 自定义注解。注解的定义类似于接口。
   1) @interface来定义注解类型。
      public @interface MyAnno{}
   2) 通过定义一个同名方法可以在注解类型中添加一个属性，返回值类型就是这个属性的类型。
      public @interface MyAnno{
          String name();
          String[] value();
      }
   3) 默认创建的注解类型可以使用类的任何位置。
  
4. 注解的注解，也叫无注解。它用来指定自定义的注解类型可对放置的位置，保留多久，是否可文档化。内置的元注解定义在

java.lang.annotation包中：
  1) Target：指示注释类型所适用的程序元素的种类。它的属性value要指定为ElementType的枚举值之一：
        TYPE, //适用于 类,接口,枚举
        FIELD, //适用于 成员字段
        METHOD, //适用于 方法
        PARAMETER, //适用于 方法的参数
        CONSTRUCTOR, //适用于 构造方法
        LOCAL_VARIABLE, //适用于 局部变量
        ANNOTATION_TYPE, //适用于 注解类型
        PACKAGE          //适用于 包
  2) Retention：用来告诉编译器如何处理当前注解。它的属性value要指定为RetentionPolicy的枚举值之一：
        SOURCE, //编译器处理完后，并不将它保留到编译后的类文件中
        CLASS, //编译器将注解保留在编译后的类文件中，但是在运行时忽略它
        RUNTIME //编译器将注解保留在编译后的类文件中，并在第一次加载类时读取它。
                   如果需要通过反射来获取某个注解类型信息时，此注解类型在定义必须指定Retention为RetentionPolicy.RUNTIME

。
  3) Document：可以使被修饰的注解在使用到类元素时，会加入到Javadoc中。
     a) 定义为Documented的注解必须要设置Retention的值为RetentionPolicy.RUNTIME。
 
 
   
5. 通过反射机制来获取注解类型信息
  1) JDK5.0中的java.lang.reflect.AnnotatedElement接口中定义了4个反射性地读取注解信息的方法：
    public Annotation getAnnotation(Class annotationType); 如果存在该元素的指定类型的注解，则返回这些注解，否则返回

null
    public Annotation[] getAnnotations();返回此元素上存在的所有注解
    public Annotation[] getDeclaredAnnotations(); 返回直接存在于此元素上的所有注解
    public boolean isAnnotationPresent(Class annotationType); 如果指定类型的注解存在于此元素上，则返回 true，否则返回

false
  2) java.lang.Class类和java.lang.reflect包中的Constructor, Field, Method, Package类都实现了
    AnnotationElement接口，可以从这些类的实例上分别取得标注于其上的注解及相关信息。

  3) 示例:
   

下面我们给出一个注解的使用例子

package  Annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.METHOD)
public @interface AShow {//声明一个注解
 boolean value();//注解的成员可以是多个
}

以上就是一个自定义的注解类

我们再来定义一个使用这个注解的类

package  Annotation;

public class Student {
 @AShow(value=false)
 public void show1(){
  System.out.println("aaaa");
 }
 @AShow(value=true)
 public void show2(int i){
  System.out.println("bbbb");
 }
}

这是一个学生类,只有show1和show2两个方法,都应用了注解

那么由于前面注解类定义时我们使用了这样的声明

@Retention(RetentionPolicy.RUNTIME)

所以这个注解我们可以通过反射机制访问到

下面我们来试一下这个测试类

package  Annotation;

import java.lang.reflect.Method;


public class StuAshowTest {
 public static void main(String[] args) {
  Student student=new Student();
  Class stu=student.getClass();
  Method [] methods=stu.getMethods();
  for(Method method:methods){
   AShow a=method.getAnnotation(AShow.class);
   if(a!=null){
    System.out.print(method.getName()+"的注解值为:");
    System.out.println(a.value());
    if(a.value()){
     System.out.println("输出前需要打开连接");
    }else{
     System.out.println("输出前需要记录文件");
    }
   }
  }
 }
}

结果

 

show1的注解值为:false
输出前需要记录文件
show2的注解值为:true
输出前需要打开连接

输出前需要记录文件

 ---------------------- android培训、java培训、期待与您交流！ ----------------------