java注解（基础）

一、认识注解

1、注解的定义：

java提供了一种原程序中的元素关联任何信息和元数据的途径和方法。

2、学习注解的目的：

（1）能够读懂别人写的代码，特别是框架相关的代码（框架中使用注解是非常方便的）

（2）让编程更加简洁，代码更为清晰。

3、java注解分类

（按照运行机制分）

（1）源码注解：注解只有在源码中存在，编译成.class文件就不存在了。

（2）编译时注解：注解在源码和.class文件中都存在

（3）运行时注解：在运行阶段还起作用，甚至会影响运行逻辑的注解

（按照来源分）

（1）来自jdk的注解

（2）来自第三方注解

（3）我们自己定义的注解

4、JDK注解（常见）

（1）@Override 表明此方法覆盖了父类的方法（使用的最多）

（2）@Deprecated 表明此方法过时了

（3）@SuppressWarnings("deprecation") 表明忽略deprecation警告

代码示例

 package Reflect;

  abstract class Father{
     public abstract String name();
     public abstract int age();

     @Deprecated//声明此方法过时
     public abstract void sing();
 }
 public class Test extends Father{
     @Override
     public String name() {
         // TODO Auto-generated method stub
         return null;
     }

     @Override
     public int age() {
         // TODO Auto-generated method stub
         return 0;
     }

     @Override//表明覆盖了父类的方法
     public void sing() {
         System.out.println("Father is singing...");

     }
     public static void main(String[] args) {

         @SuppressWarnings("deprecation")//表示忽略deprecation的警告
         Test t=new Test();
         t.sing();

     }
 }

运行结果：

Father is singing...

5、常见第三方注解

spring框架、mybatis框架和hibernate框架中有大量的注解

二、自定义注解

1、元注解

（1）@Target 指明注解的作用域

@Target({ElementType.METHOD,ElemenType.TYPE})   红色部分表示作用域列表

作用域值表

作用域值	描述
CONSTRUCTOR	构造方法声明
FIELD	字段声明
LOCAL_VARIABLE	局部变量声明
METHOD	方法声明
PACKAGE	包声明
PARAMETER	参数声明
TYPE	类、接口

（2）@Retention  指明注解的生命周期

@Retention(RetentionPolicy.RUNTIME)

生命周期值表

生命周期值	描述
SOURCE	只在源码显示，编译时会丢弃
CLASS	编译时会记录到class中，运行时忽略
RUNTIME	运行时存在，可以通过反射读取

（3）@Inherited   指明注解允许自助借来继承

（4）@Documented   生成javadoc时会包含注解

2、自定义注解的语法要求

（1）成员以无参和没有异常方式声明

（2）可以用defualt为成员指定一个默认值

（3）成员类型是受限的，合法的类型包括原始类型（基本数据类型）及String，Class，Annotation，Enumeration。

（4）如果注解只有一个成员，则成员名必须取名为value，在使用的时候可以忽略成员名和赋值号（=）

（5）注解类可以没有成员，没有成员的注解称为标识注解

代码示例：（自定义一个注解）

package ANNOTATION;

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

//先定义元注解的@Target坠儿，指明作用域是方法和类接口
@Target({ElementType.METHOD,ElementType.TYPE})
//指明注解的生命周期，运行时存在
@Retention(RetentionPolicy.RUNTIME)
//指明能够被子注解继承
@Inherited
//指明生成javadoc时会包含注解
@Documented
public @interface MyAnnotation {

    String desc();  //成员以无参和没有异常方式声明
    String author();
    int age() default 18;//可以用defualt为成员指定一个默认值
}

3、使用自定义注解

使用自定义注解的语法：

@<注解名>(<成员名1>=<成员值1>,<成员名2>=<成员值2>,....)

代码示例：

package ANNOTATION;

@ MyAnnotation(desc="I am a boy",author="tom",age=21)
public class AnnotationTest {

    @ MyAnnotation(desc="I am a girl",author="mary",age=18)
    public void girlSing(){
        System.out.println("girl is singing...");
    }
}

三、解析注解（读取注解中的信息，并对进行一些操作）

概念：通过反射获取类，函数或成员变量上的运行时注解信息，从而实现动态的控制程序运行的逻辑

注解只会继承类上的注解，当一个类去继承一个类时，可以继承该父类已有的注解，但不能继承其父类上的注解，且接口的注解不能被继承。

代码实现：

 package ANNOTATION;

 import java.lang.annotation.Annotation;
 import java.lang.reflect.Field;
 import java.lang.reflect.Method;

 public class Test {

     public static void main(String[] args) throws ClassNotFoundException {
         //使用类加载器加载类
         Class c=Class.forName("ANNOTATION.AnnotationTest");
         //找到类上面的注解
         boolean isExist=c.isAnnotationPresent(MyAnnotation.class);
         if(isExist){
         //拿到注解实例
         MyAnnotation m=(MyAnnotation) c.getAnnotation(MyAnnotation.class);
         System.out.println("类注解的信息："+"desc:"+m.desc()+" author:"+m.author()+" age:"+m.age());
         }
         //1、获取方法上面的注解及其信息(知道方法上注解的名称）
         //获取类中的所有声明的方法
         Method[] method= c.getDeclaredMethods();
         for (Method method2 : method) {
             boolean isExist1=method2.isAnnotationPresent(MyAnnotation.class);
             if(isExist1){
                 MyAnnotation m1=(MyAnnotation) method2.getAnnotation(MyAnnotation.class);
                 System.out.println(method2.getName()+"方法上注解的信息："+"desc:"+m1.desc()+" author:"+m1.author()+" age:"+m1.age());
             }
         }
         //2获取方法上面的所有注解及其信息
         for (Method method2 : method) {
             //获取方法上的所有注解
             Annotation []at=method2.getAnnotations();
             for (Annotation annotation : at) {
                 //开始解析MyAnnotation的成员值
                 if(annotation instanceof MyAnnotation){
                     MyAnnotation m3=(MyAnnotation) annotation;
                     System.out.println(method2.getName()+"方法上注解的信息："+"desc:"+m3.desc()+" author:"+m3.author()+" age:"+m3.age());
                 }
             }
             /*
              * 不知道方法上有哪些注释，下面代码可以获取注释的一些信息
              */
             for (Method method4 : method) {
                 //获取方法上的所有注解
                 Annotation []at1=method4.getAnnotations();
                 for (Annotation annotation : at) {
                     //获取注解的Class类对象（反射）
                     Class c3=annotation.annotationType();
                     //打印注解的名称
                     System.out.println("注解名称："+c3.getName());
                     //获取注解所有成员变量
                     Method [] m2=c3.getDeclaredMethods();
                     for (Method method3 : m2) {
                         System.out.println("注解的成员名称："+method3.getName());
                     }
                 }
             }
         }
     }
 }

运行结果：

 类注解的信息：desc:I am a boy author:tom age:21
 girlSing方法上注解的信息：desc:I am a girl author:mary age:18
 girlSing方法上注解的信息：desc:I am a girl author:mary age:18
 注解名称：ANNOTATION.MyAnnotation
 注解的成员名称：desc
 注解的成员名称：author
 注解的成员名称：age

个人关于注解的应用理解：其实质就是对类、方法、成员变量上的注解，通过反射机制获得并进行解析，从而进一步进行操作。