Java中注解(annotation)的概念、示例、写法的一文详解。

Java 注解 @interface 详解

定义注解

public @interface Report {

int type() default 0;

String level() default "info";

String value() default "";

}

逐行解释

public @interface Report

定义了一个名字叫 Report 的注解。

它可以被用在类、方法、字段等地方（具体要看后续有没有加元注解 @Target、@Retention）。

int type() default 0;

定义了一个名为 type 的参数，类型是 int。

default 0 表示如果使用注解时不写 type，它的默认值就是 0。

String level() default "info";

定义了一个 String 类型的参数，名字是 level。

默认值是 "info"。

String value() default "";

定义了一个常用参数 value，类型是 String。

默认值是空字符串 ""。

在注解里，如果你定义了 value() 参数，使用注解时可以只写值，不写 value=。

使用示例

// 使用所有参数

@Report(type = 1, level = "warning", value = "检查数据合法性")

public class MyService {}

// 使用默认值

@Report

public class MyDefaultService {}

// 如果只设置 value，可以省略 "value="

@Report("只传入value参数")

public class MySimpleService {}

为什么注解参数写成方法形式？

很多人疑惑：既然是参数，为什么写成 type() 这种看起来像方法的形式？

本质原因

Java 注解（@interface）的语法设计，是基于接口的特殊语法糖。

例如：

public @interface Report {

int type() default 0;

}

编译器会生成：

public interface Report extends java.lang.annotation.Annotation {

int type(); // 一个抽象方法

}

所以：

type() 其实是一个抽象方法。

但在注解语法里，它表达的意义是“参数”。

default 0 就相当于给这个抽象方法一个默认返回值。

为什么不用变量？

Java 设计者考虑：

注解必须能在字节码层被反射机制识别。

注解的参数必须是编译期常量（int、String、Class、enum、注解、数组）。

语法上最简单的方式，就是复用接口里的抽象方法写法。

因此 type()、level()、value() 看似方法，实际上是 注解元素（annotation element）。

使用和反射读取

@Report(type = 2, level = "error", value = "严重错误")

public class Demo {}

反射读取：

Report r = Demo.class.getAnnotation(Report.class);

System.out.println(r.type()); // 2

System.out.println(r.level()); // "error"

System.out.println(r.value()); // "严重错误"

这里的 r.type() 真的是方法调用，但它返回的就是注解参数的值。

总结

注解里的参数写成“方法”的形式，是因为注解本质上就是接口。

type()、level()、value() 看似方法，实际是“注解元素定义”。

注解参数可以有默认值，并且可以通过反射读取。