Java 注解介绍

2017-12-28 craneyuan 更多博文 » 博客 » GitHub »

Java

原文链接 https://crane-yuan.github.io/2017/12/28/java-annotations-introduction/
注:以下为加速网络访问所做的原文缓存,经过重新格式化,可能存在格式方面的问题,或偶有遗漏信息,请以原文为准。


定义

Java注解又称Java标注,是Java语言5.0版本开始支持加入源代码的特殊语法元数据(元数据 Metadata:描述数据的数据)。

Java语言中的类、方法、变量、参数和包等都可以被标注。和Javadoc不同,Java标注可以通过反射获取标注内容。在编译器生成类文件时,标注可以被嵌入到字节码中。Java虚拟机可以保留标注内容,在运行时可以获取到标注内容。 当然它也支持自定义Java标注

内置的注解

Java 5 定义了一套注解,共有 7 个,3 个在 java.lang 中,剩下 4 个在 java.lang.annotation 中。

<!--more-->

作用在代码的注解(java.lang包中)

  • @Override - 检查该方法是否是重载方法。如果发现其父类,或者是引用的接口中并没有该方法时,会报编译错误。
  • @Deprecated - 标记过时方法。如果使用该方法,会报编译警告。
  • @SuppressWarnings - 指示编译器去忽略注解中声明的警告。

作用在其他注解的注解(或者说 元注解,java.lang.annotation包中)

  • @Retention - 标识这个注解怎么保存,是只在代码中,还是编入class文件中,或者是在运行时可以通过反射访问。
  • @Documented - 标记这些注解是否包含在用户文档中。
  • @Target - 标记这个注解应该是哪种 Java 成员。
  • @Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

从 Java 7 开始,额外添加了 3 个注解

  • @SafeVarargs - Java 7 开始支持,忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
  • @FunctionalInterface - Java 8 开始支持,标识一个匿名函数或函数式接口。
  • @Repeatable - Java 8 开始支持,标识某注解可以在同一个声明上使用多次。

功能

注解可以用于许多不同的目的,最常见的是:

  • 给编译器提供信息:编译器可以使用注解来产生警告,甚至根据不同的规则产生错误。 这种用法的一个例子是Java 8 的 @FunctionalInterface 注解。 这使编译器验证注释类,并检查它是否是一个正确的功能接口。
  • 文档化:软件应用程序可以使用注解来测量代码的质量,如FindBugs或PMD,或者像Jenkins,Jira或Teamcity一样自动生成报告。
  • 代码生成:使用注解可以使用代码中存在的元数据信息自动生成代码或XML文件。 JAXB库就是一个很好的例子。
  • 运行时处理:在运行时检查的注解可用于不同的目标,如单元测试(Junit),依赖注入(Spring),验证,日志记录(Log4J),数据访问(Hibernate)等。

实际例子

讲个 Java 官方提供的例子,用注解实现简单的测试框架。

@MyTest 注解

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 MyTest {

}

FooTest 测试类

public class FooTest {

    @MyTest
    public static void m1() {
    }

    public static void m2() {
    }

    @MyTest
    public static void m3() {
        throw new RuntimeException("Boom");
    }

    public static void m4() {
    }

    @MyTest
    public static void m5() {
    }

    public static void m6() {
    }

    @MyTest
    public static void m7() {
        throw new RuntimeException("Crash");
    }

    public static void m8() {
    }
}

RunMyTests 测试执行类

import java.lang.reflect.Method;

public class RunMyTests {
    public static void main(String[] args) throws Exception {
        int passed = 0;
        int failed = 0;

        if (args.length < 1) {
            System.out.println("please give test class.");
            System.exit(1);
        }

        for (Method method : Class.forName(args[0]).getMethods()) {
            if (method.isAnnotationPresent(MyTest.class)) {
                try {
                    method.invoke(null);
                    passed++;
                } catch (Throwable ex) {
                    System.out.printf("Test %s failed: %s %n", method, ex.getCause());
                    failed++;
                }
            }
        }
        System.out.printf("Passed: %d, Failed %d%n", passed, failed);
    }
}

编译、运行测试执行类

> javac FooTest.java MyTest.java RunMyTests.java
> java RunMyTests FooTest
Test public static void FooTest.m3() failed: java.lang.RuntimeException: Boom
Test public static void FooTest.m7() failed: java.lang.RuntimeException: Crash
Passed: 2, Failed 2

参考