java框架解析注解_【框架基础】：全面解析Java注解(一)

Java注解概述

要了解Java注解要先知道Java的反射，反射是运行时获取类的成员，注解也是类的成员，以此达到动态编码的效

果，多用在框架，或者使用框架时候添加注解让框架调用。

注解定义：注解(Annotation)，也叫元数据。Java提供了一种原程序中的元素关联任何信息和任何元数据的途

径和方法，一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可

以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

Annotation(注解)是JDK1.5及以后版本引入的。它可以用于创建文档，跟踪代码中的依赖性，甚至执行基本编译

时检查。注解是以‘@注解名’在代码中存在的，根据注解参数的个数，我们可以将注解分为：标记注解、单值注

解、完整注解三类。它们都不会直接影响到程序的语义，只是作为注解(标识)存在，我们可以通过反射机制编程实

现对这些元数据(用来描述数据的数据)的访问。另外，你可以在编译时选择代码里的注解是否只存在于源代码级，

或者它也能在class文件、或者运行时中出现(SOURCE/CLASS/RUNTIME)。

注解的作用

如果要对于注解的作用进行分类，还没有明确的定义，不过我们可以根据它所起的作用，大致可分为三类：

编写文档：通过代码里标识的元数据生成文档【生成文档doc文档】

代码分析：通过代码里标识的元数据对代码进行分析【使用反射】

编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】

为什么学习注解

1、能够读懂别人写的代码，特别是框架相关的代码，增加代码的阅读性；

2、让编程更加简洁，代码更加清晰，理清自己的思路；

3、生成API文档；

Java中的常见注解

JDK内置注解

@Override

它的作用是对覆盖超类中方法的方法进行标记，如果被标记的方法并没有实际覆盖超类中的方法，则编译器会发

出错误警告。下面的例子是实现类Child实现了接口Person的方法   使用了@Override。

package com.demo.annotation;

/**

* 测试@Override注解

* @author Administrator

* @date 2016年12月9日

*/

public interface Person {

public String name();

public int age();

public void sing();

}

class Child implements Person {

@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() {

// TODO Auto-generated method stub

}

}

@Deprecated

它的作用是对不应该再使用的方法添加注解，当编程人员使用这些方法时，将会在编译时显示提示信息，它与

javadoc里的@deprecated标记有相同的功能，准确的说，它还不如javadoc @deprecated，因为它不支持参数，

使用@Deprecated的示例代码示例如下：

package com.demo.annotation;

/**

* 测试@Deprecated注解

* @author Administrator

* @date 2016年12月9日

*/

public interface Person {

public String name();

public int age();

@Deprecated

public void sing();

}

class Child implements Person {

@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() {

// TODO Auto-generated method stub

}

}

class Test {

@SuppressWarnings("deprecation")

public void sing(){

Person person = new Child();

person.sing();//sing()方法已经过时

}

}

Person接口使用了@Deprecated修饰了一个已经过时的方法，此时强行调用超类继承来的方法就会有个代码过

时的横线，并且报一个代码过时的警告，但不会影响正常使用。如果要去掉警告可以使用

@suppressWarings("deprecation")  来忽略这个警告。

@SuppressWarnings

其参数有：

deprecation：使用了过时的类或方法时的警告

unchecked：执行了未检查的转换时的警告

fallthrough：当 switch 程序块直接通往下一种情况而没有 break 时的警告

path：在类路径、源文件路径等中有不存在的路径时的警告

serial：当在可序列化的类上缺少serialVersionUID 定义时的警告

finally ：任何 finally 子句不能正常完成时的警告

all：关于以上所有情况的警告

这里的演示在上面已经出现过。

常见的第三方注解

在这里只是简单的演示一下，在学习框架的过程中再详细说明。

按照过去的方式就是写一个配置文件：

使用注解方式不再使用配置文件：

Java注解的分类

按照运行机制分类

源码注解：注解只在源码中存在，编译成.class文件就不存在了；

编译时注解：注解在源码和.class文件中都存在，比如@SuppressWarnings、@Override和@Deprecated只在

编译时刻起作用；

运行时注解：源码、编译后以及运行时都存在的注解，在运行阶段还起作用，甚至会影响运行逻辑的注解，比如

spring框架的@Autowired注解。

按照来源分类

来自JDK的注解：@SuppressWarnings、@Override和@Deprecated

来自第三方的注解：比如spring框架的@Autowired注解

自定义注解：我们自己定义的注解。

元注解

注解的注解：自定义注解中比较常见。

Java自定义注解

先来看一个模板：

自定义注解语法要求

1)使用@Interface关键字定义注解；

2)成员以无参无异常方式声明；

3)可以用default为成员指定一个默认值；

4)成员类型是受限的，合法的类型包括原始类型及String、Class、Annotation、Enumeration；

5)如果注解只有一个成员，则成员必须取名为value()，在使用时可以忽略成员名和赋值号(=)；

6)注解类可以没有成员，没有成员的注解称为标识注解；

注解的注解(元注解)

@Target({ElementType.METHOD,ElementType.TYPE})

CONSTRUCTOR：构造方法声明

FIELD：字段声明

LOACL_VARIABLE：局部变量声明

METHOD：方法声明

PACKAGE：包声明

PARAMETER：参数声明

TYPE：类或者接口声明

@Retention(RetentionPolicy.RUNTIME)

SOURCE：只在源码显示，编译时会丢弃

CLASS：编译时会记录到class中，运行时忽略

RUNTIME：运行时存在，可以通过反射读取

@Inherited

允许子类继承

@Documented

生成javadoc时会包含注解

使用自定义注解

使用注解的语法：@(=,=,...)

一个简单的例子：

定义@Description注解：

package com.demo.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({ElementType.METHOD,ElementType.TYPE})

@Retention(RetentionPolicy.RUNTIME)

@Inherited

@Documented

public @interface Description {

String desc();

String author();

int age() default 18;

}

使用注解：

package com.demo.annotation;

@Description(desc="I am class annotation",author="Mooc boy",age=18)

public class AnnotationTest {

@Description(desc="I am method annotation",author="Mooc boy",age=18)

public String eyeColor(){

return "red";

}

}

@Description注解在eyeColor()方法上使用，可以在类或者接口上使用

解析注解

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

对于@RetentionRetention表示作用范围，我们知道：SOURCE表示只在源码显示，编译时会丢弃；

CLASS表示编译时会记录到class中，运行时忽略；RUNTIME表示运行时存在，可以通过反射读取。前两个都不会显

示结果，只有最后一个会显示结果。

一个例子：

package com.demo.annotation;

import java.lang.annotation.Annotation;

import java.lang.reflect.Method;

/**

* 解析注解

* @author Administrator

* @date 2016年12月9日

*/

public class Demo {

public static void main(String[] args) {

//1.使用类加载器加载类

try {

Class< ?> clazz = Class.forName("com.demo.annotation.AnnotationTest");

//2.找到类上面的注解

boolean flag1 = clazz.isAnnotationPresent(Description.class);

if(flag1){

//3.拿到注解实例

Description description1 = (Description)clazz.getAnnotation(Description.class);

System.out.println(description1.desc());

System.out.println(description1.author());

System.out.println(description1.age());

}

//4.解析找到方法上的注解

Method[] methods = clazz.getMethods();

for (Method method : methods) {

boolean flag2 = method.isAnnotationPresent(Description.class);

if(flag2){

//5.拿到注解实例

Description description2 = (Description)method.getAnnotation(Description.class);

System.out.println(description2.desc());

System.out.println(description2.author());

System.out.println(description2.age());

}

}

//另外一种解析方法

for (Method method : methods) {

Annotation[] annotations = method.getAnnotations();

for (Annotation annotation : annotations) {

if(annotation instanceof Description){

Description description3 = (Description)annotation;

System.out.println(description3.desc());

System.out.println(description3.author());

System.out.println(description3.age());

}

}

}

} catch (ClassNotFoundException e) {

e.printStackTrace();

}

}

}

运行结果：

关于@Inherited元注解

父子类继承注解这块分两种情况，一个是注解定义了@Inherited，一个是没定义。在每种情况中又分类上的注

解，子类实现父类抽象方法，继承了父类方法，覆盖了父类方法这四种情况，具体继承规则如下：

编写自定义注解时未写@Inherited的运行结果：

子类的类上能否继承到父类的类上的注解？    否

子类方法，实现了父类上的抽象方法，这个方法能否继承到注解？    否

子类方法，继承了父类上的方法，这个方法能否继承到注解？    能

子类方法，覆盖了父类上的方法，这个方法能否继承到注解？    否

编写自定义注解时写了@Inherited的运行结果：

子类的类上能否继承到父类的类上的注解？     能

子类方法，实现了父类上的抽象方法，这个方法能否继承到注解？      否

子类方法，继承了父类上的方法，这个方法能否继承到注解？      能

子类方法，覆盖了父类上的方法，这个方法能否继承到注解？      否

仅供参考！