Java 注解：不止 @Override，这篇讲透

2302_79432188

1451人浏览 · 2025-09-06 10:23:39

2302_79432188 · 2025-09-06 10:23:39 发布

在 Java 编程的世界里，注解（Annotation）是一个非常重要却又容易被初学者忽视的知识点。它就像代码的 “标签”，能够为代码提供额外的信息，并且在编译、运行等阶段发挥着关键作用。无论是日常开发中常见的@Override，还是框架开发里不可或缺的@Controller，注解都无处不在。今天，我们就来一起深入探索 Java 注解，全方位揭开它的神秘面纱。

一、Java 注解是什么？—— 认识注解的本质

注解，又称标注，是 Java 语言从 JDK5.0 开始引入的一种新的语法元素。它主要用于为 Java 代码提供元数据（描述数据的数据），这些元数据不会直接影响代码的执行逻辑，但会被编译器、虚拟机或者其他工具（如框架）读取和使用，从而实现一些特定的功能。

简单来说，注解有以下几个核心特点：

无直接执行性：注解本身不会像方法一样被调用执行，也不会像变量一样存储数据，它更像是一种 “附加信息”。

可被工具识别：编译器、IDE（如 IntelliJ IDEA）、框架（如 Spring）等工具可以通过解析注解，获取其中的信息，并做出相应的处理。例如，编译器通过@Override注解检查方法是否正确重写了父类方法。

可自定义：除了 Java 内置的注解，开发者还可以根据自己的需求定义专属的注解，满足特定场景下的功能需求。

二、如何定义和使用 Java 注解？—— 注解的核心语法

要掌握注解，首先需要了解它的定义语法和使用方式。下面我们将一步步讲解如何创建一个自定义注解，并在代码中使用它。

2.1 定义注解：使用 @interface 关键字

定义注解与定义类、接口类似，不过需要使用@interface关键字。一个基本的注解定义包含注解名称、注解属性（可选）以及元注解（可选，用于描述注解本身）。

2.1.1 最简单的自定义注解

// 定义一个名为MyAnnotation的注解

public @interface MyAnnotation {

// 此处可定义注解属性（可选）

}

上述代码中，@interface表明这是一个注解，MyAnnotation是注解的名称。此时，这个注解还没有任何属性，只能作为一个 “标记” 使用。

2.1.2 带有属性的自定义注解

注解的属性类似于类的成员变量，定义方式为 “属性类型 + 属性名 ()”，并且可以指定默认值（通过default关键字）。

public @interface MyAnnotation {

// 定义一个String类型的属性，名为value，无默认值

String value();

// 定义一个int类型的属性，名为age，默认值为21

int age() default 21;

// 定义一个String数组类型的属性，名为hobbies，无默认值

String[] hobbies();

}

注意：如果注解中只有一个属性，且属性名是value，那么在使用注解时可以省略属性名，直接赋值；如果有多个属性，或者属性名不是value，则必须显式指定属性名和值。

2.2 使用注解：在目标元素上添加注解

注解可以作用在多个目标元素上，如类、方法、字段、参数等。使用注解的方式是在目标元素前加上@注解名，并根据注解属性的要求赋值。

2.2.1 使用无属性的注解

// 在类上使用MyAnnotation注解（假设MyAnnotation无属性）

@MyAnnotation

public class MyClass {

// 在方法上使用MyAnnotation注解

@MyAnnotation

public void myMethod() {

// 方法体

}

}

2.2.2 使用带属性的注解

根据注解属性是否有默认值，使用方式略有不同：

public class MyClass {

// 1. 注解属性有默认值时，可省略该属性的赋值

@MyAnnotation(value = "张三", hobbies = {"读书", "运动"})

public void method1() {}

// 2. 注解只有一个属性value时，可省略属性名

@MyAnnotation("李四") // 等价于 @MyAnnotation(value = "李四")

public void method2() {}

// 3. 数组类型的属性赋值，可使用大括号（多个值）或小括号（单个值）

@MyAnnotation(value = "王五", age = 20, hobbies = "编程") // 单个值时可省略大括号

public void method3() {}

}

2.2.3 注解的原理

注解本质是一个接口，Java中所有注解都是继承了Annotation接口的。

@注解（...）：其实就是一个匿名内部类对象，实现了该注解以及Annotation接口。

2.3 元注解：描述注解的注解

元注解是用于修饰注解的注解，它主要用于指定注解的作用范围（如作用在类上还是方法上）、生命周期（如编译期有效还是运行期有效）等。Java 内置了 4 个常用的元注解，分别是：

元注解	作用
@Target	指定注解可以作用的目标元素（如类，接口（TYPE）、成员变量（FIELD）、成员方法（METHOD）、方法参数（PARAMETER）、构造器（CONSTRUCTOR）、局部变量（LOCAL_VARIABLE））
@Retention	指定注解的生命周期（SOURCE：源码期；CLASS：编译期；RUNTIME：运行期）

2.3.1 常用元注解示例

import java.lang.annotation.*;

// @Target指定MyAnnotation只能作用在类和方法上

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

// @Retention指定MyAnnotation的生命周期为运行期（可通过反射获取）

@Retention(RetentionPolicy.RUNTIME)

public @interface MyAnnotation {

String value();

int age() default 18;

}

@Target：ElementType是一个枚举类，包含TYPE（类、接口）、METHOD（方法）、FIELD（字段）、PARAMETER（参数）等选项，多个选项用大括号包裹。

@Retention：RetentionPolicy也是一个枚举类，其中RUNTIME是最常用的生命周期，因为只有在运行期，我们才能通过反射获取注解信息，实现动态处理逻辑。

三、Java 内置注解有哪些？

除了自定义注解，Java 还内置了一些常用的注解，这些注解在日常开发中使用频率很高，我们需要熟练掌握它们的作用。

3.1 @Override

作用：用于标记方法，表示该方法是重写了父类（或实现了接口）中的方法。

作用场景：编译器会根据@Override注解检查方法是否正确重写，如果方法名、参数列表、返回值类型与父类方法不匹配，编译器会报错，避免开发者因拼写错误等问题导致重写失败。

示例：

public class Animal {

public void eat() {

System.out.println("动物吃饭");

}

}

public class Dog extends Animal {

// 重写父类的eat方法，添加@Override注解

@Override

public void eat() {

System.out.println("狗吃骨头");

}

}

3.2 @Deprecated

作用：用于标记类、方法、字段等元素，表示该元素已过时，不建议在新的代码中使用。

作用场景：当某个 API 由于设计缺陷或有更好的替代方案时，开发者可以用@Deprecated标记它，并通过 Javadoc 的@deprecated标签说明替代方案，提醒其他开发者避免使用过时元素。

示例：

public class OldUtils {

/**

* 该方法已过时，建议使用新的calculateSum方法

* @deprecated 请使用 {@link #calculateSum(int, int)} 方法

*/

@Deprecated

public static int add(int a, int b) {

return a + b;

}

// 新的替代方法

public static int calculateSum(int a, int b) {

return a + b;

}

}

使用过时方法时，IDE 会给出警告提示。

3.3 @SuppressWarnings

作用：用于抑制编译器产生的警告信息，如未使用变量警告、未检查类型转换警告等。

作用场景：当开发者确认某些警告信息不需要关注时（例如，在使用泛型时，明确知道类型转换是安全的），可以使用@SuppressWarnings注解消除警告，让代码更整洁。

示例：

public class WarningDemo {

@SuppressWarnings("unused") // 抑制“变量未使用”的警告

public void testUnusedVariable() {

int num = 10; // 虽然num未使用，但编译器不会报警告

}

@SuppressWarnings("unchecked") // 抑制“未检查类型转换”的警告

public List<String> testUncheckedCast() {

List list = new ArrayList();

list.add("hello");

// 此处将List转换为List<String>，编译器会有警告，通过注解抑制

return (List<String>) list;

}

}

注意：@SuppressWarnings的属性值需要根据具体的警告类型指定，常见的有unused（未使用）、unchecked（未检查）、rawtypes（原始类型）等。

3.4 @FunctionalInterface（JDK8+）

作用：用于标记接口，表示该接口是一个函数式接口（即只包含一个抽象方法的接口）。

作用场景：函数式接口是 Lambda 表达式的基础，@FunctionalInterface注解可以强制编译器检查接口是否符合函数式接口的定义，如果接口中包含多个抽象方法，编译器会报错。

示例：

// 正确的函数式接口

@FunctionalInterface

public interface MyFunction {

void doSomething(String str);

}

// 错误的函数式接口（包含两个抽象方法，编译器会报错）

@FunctionalInterface

public interface MyErrorFunction {

void method1();

void method2();

}

四、注解的实际应用：如何通过反射解析注解？

注解本身不会产生作用，真正让注解发挥价值的是 “注解解析”—— 即通过代码读取注解信息，并根据信息执行相应的逻辑。在 Java 中，解析注解最常用的方式是反射（因为只有在运行期，反射才能获取到类、方法等元素的注解信息）。

下面我们通过一个实战案例，演示如何自定义注解，并通过反射解析注解，实现一个简单的 “日志打印” 功能。

4.1 步骤 1：定义一个 “日志注解”

import java.lang.annotation.*;

// 该注解只能作用在方法上

@Target(ElementType.METHOD)

// 生命周期为运行期（便于反射解析）

@Retention(RetentionPolicy.RUNTIME)

public @interface LogAnnotation {

// 日志描述信息，无默认值

String description();

}

4.2 步骤 2：在目标方法上使用该注解

public class UserService {

// 在addUser方法上使用LogAnnotation，描述“添加用户”

@LogAnnotation(description = "添加用户")

public void addUser(String username) {

System.out.println("添加用户：" + username);

}

// 在deleteUser方法上使用LogAnnotation，描述“删除用户”

@LogAnnotation(description = "删除用户")

public void deleteUser(String username) {

System.out.println("删除用户：" + username);

}

}

4.3 步骤 3：通过反射解析注解，实现日志打印

import java.lang.reflect.Method;

public class LogUtils {

// 解析注解并打印日志的方法

public static void parseAnnotation(Object obj) throws Exception {

// 1. 获取目标对象的Class对象

Class clazz = obj.getClass();

// 2. 获取类中所有的方法

Method[] methods = clazz.getDeclaredMethods();

// 3. 遍历方法，检查是否有LogAnnotation注解

for (Method method : methods) {

// 判断方法是否包含LogAnnotation注解

if (method.isAnnotationPresent(LogAnnotation.class)) {

// 4. 获取注解实例

LogAnnotation logAnnotation = method.getAnnotation(LogAnnotation.class);

// 5. 获取注解的description属性值（日志描述）

String logDesc = logAnnotation.description();

// 6. 打印日志（实际场景中可写入日志文件、数据库等）

System.out.println("【日志】" + logDesc + "，方法名：" + method.getName());

// 7. （可选）调用该方法（如果需要）

method.invoke(obj, "张三"); // 此处传入方法的参数（示例中方法需要String类型参数）

}

}

}

// 测试

public static void main(String[] args) throws Exception {

UserService userService = new UserService();

LogUtils.parseAnnotation(userService);

}

}

4.4 运行结果

【日志】添加用户，方法名：addUser

添加用户：张三

【日志】删除用户，方法名：deleteUser

删除用户：张三

从运行结果可以看出，我们通过反射成功解析了LogAnnotation注解，获取到了方法的日志描述信息，并实现了日志打印功能。这种方式在框架开发中非常常见，例如 Spring 框架的@Controller、@Service等注解，就是通过类似的原理实现 Bean 的扫描和创建。

五、总结与扩展

通过本文的讲解，我们已经掌握了 Java 注解的基础概念、定义与使用方法、内置注解以及通过反射解析注解的实战技巧。总结一下，Java 注解的核心价值在于：

简化代码：通过注解替代繁琐的配置文件（如 Spring 的注解配置替代 XML 配置）。

提高开发效率：通过注解实现自动化处理（如日志打印、参数校验），减少重复代码。

增强代码可读性：通过注解为代码添加清晰的元数据，让其他开发者更容易理解代码意图。

在实际开发中，注解的应用远不止本文提到的内容。例如：

在 Spring Boot 中，@RestController、@RequestMapping等注解实现接口开发；

在 MyBatis 中，@Select、@Insert等注解实现 SQL 语句映射；

在 JUnit 中，@Test注解标记测试方法。

如果你想进一步深入注解，可以尝试实现更复杂的场景，如 “参数校验注解”（校验方法参数是否为空、是否符合格式）、“缓存注解”（标记方法结果需要缓存）等。相信通过不断实践，你对注解的理解会更加深刻！下一章更精彩，我们不见不散！！！

亚马逊云科技技术品牌专区

更多推荐

害虫检测和识别3：基于深度学习YOLO26神经网络实现害虫检测和识别(含训练代码、数据集和GUI交互界面）

亚马逊云科技技术品牌专区

大硬仗14小时：用2009年的上古亮机卡跑完深度学习，CPU满载但代码没崩

亚马逊云科技技术品牌专区

《人工智能基础及应用》全套PPT课件2026（工科版）

亚马逊云科技技术品牌专区

所有评论(0)

查看更多评论

2302_79432188

@2302_79432188

已为社区贡献4条内容

Java 注解：不止 @Override，这篇讲透

2302_79432188

一、Java 注解是什么？—— 认识注解的本质

二、如何定义和使用 Java 注解？—— 注解的核心语法

2.1 定义注解：使用 @interface 关键字

2.1.1 最简单的自定义注解

2.1.2 带有属性的自定义注解

2.2 使用注解：在目标元素上添加注解

2.2.1 使用无属性的注解

2.2.2 使用带属性的注解

2.2.3 注解的原理

2.3 元注解：描述注解的注解

2.3.1 常用元注解示例

三、Java 内置注解有哪些？

3.1 @Override

3.2 @Deprecated

3.3 @SuppressWarnings

3.4 @FunctionalInterface（JDK8+）

四、注解的实际应用：如何通过反射解析注解？

4.1 步骤 1：定义一个 “日志注解”

4.2 步骤 2：在目标方法上使用该注解

4.3 步骤 3：通过反射解析注解，实现日志打印

4.4 运行结果

五、总结与扩展

所有评论(0)

温馨提示：您尚未绑定手机号

2302_79432188