当前位置：首页 > 文章列表 > 文章 > java教程 > 手把手教你玩转Java注解，轻松实现自定义注解

手把手教你玩转Java注解，轻松实现自定义注解

2025-06-13 08:19:38 0浏览收藏

**Java注解怎么用？手把手教你自定义注解，提升代码可读性与框架扩展性**。本文深入讲解Java注解的使用与自定义，Java注解作为一种元数据，为代码添加额外信息，在编译和运行时发挥作用。文章详细介绍了注解的三大作用：编译时检查、代码生成和运行时处理，并以实例展示了如何通过`@interface`定义自定义注解，以及`@Target`和`@Retention`的使用。此外，还探讨了自定义注解在权限验证、数据校验及框架简化配置等方面的应用，并针对不同场景，指导开发者如何选择合适的注解保留策略（SOURCE、RUNTIME、CLASS）。通过本文，你将掌握自定义注解的核心技术，提升代码的灵活性和可维护性。

Java 注解是一种元数据，提供为代码添加额外信息的方式，不影响执行但可在编译或运行时使用。1. 作用包括编译检查如@Override、代码生成如Lombok的@Data、运行时处理如Spring的@Autowired；2. 自定义注解通过@interface定义，需指定@Target和@Retention；3. 使用场景如权限验证、数据校验及框架简化配置；4. 保留策略选择：SOURCE用于编译检查，RUNTIME用于运行时反射处理，CLASS较少用。自定义注解提升了代码可读性与框架扩展性。

Java中注解的作用及自定义注解实现方法

Java 注解，本质上是一种元数据，可以理解为代码的标签。它们提供了一种为代码添加额外信息的方式，这些信息可以在编译时、运行时被读取和使用，但本身并不直接影响代码的执行。自定义注解则允许我们根据特定需求创建自己的标签，扩展 Java 的元数据能力。

解决方案

Java 注解的作用主要体现在以下几个方面：

编译时检查： 比如 @Override 注解，它可以告诉编译器，被注解的方法必须覆盖父类的方法。如果方法名写错了，编译器会报错。
代码生成： 很多框架利用注解在编译时生成代码，例如 Lombok，通过 @Data 注解自动生成 getter、setter 等方法，减少了大量的样板代码。
运行时处理： 框架可以在运行时读取注解信息，并根据这些信息执行相应的操作。例如 Spring 框架，通过 @Autowired 注解实现依赖注入。

自定义注解的实现方法如下：

定义注解： 使用 @interface 关键字定义注解。例如：
```
import java.lang.annotation.*;

@Target(ElementType.METHOD) // 注解可以用于方法
@Retention(RetentionPolicy.RUNTIME) // 注解在运行时保留
public @interface MyAnnotation {
    String value() default "default value"; // 注解的属性，可以设置默认值
    int number() default 0;
}
```
- @Target：指定注解可以应用在哪些元素上，例如类、方法、字段等。常见的取值有 ElementType.TYPE (类、接口)、ElementType.METHOD (方法)、ElementType.FIELD (字段) 等。
- @Retention：指定注解的保留策略，即注解在哪个阶段有效。常见的取值有 RetentionPolicy.SOURCE (源代码级别，编译器会丢弃)、RetentionPolicy.CLASS (编译时，但 JVM 不可见)、RetentionPolicy.RUNTIME (运行时，JVM 可见，可以通过反射获取)。

使用注解： 在代码中使用定义的注解。

public class MyClass {
    @MyAnnotation(value = "hello", number = 123)
    public void myMethod() {
        // ...
    }
}

处理注解： 通过反射在运行时获取注解信息并进行处理。

import java.lang.reflect.Method;

public class AnnotationProcessor {
    public static void main(String[] args) throws Exception {
        Class<?> clazz = MyClass.class;
        Method method = clazz.getMethod("myMethod");

        if (method.isAnnotationPresent(MyAnnotation.class)) {
            MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
            System.out.println("value: " + annotation.value());
            System.out.println("number: " + annotation.number());
        }
    }
}

为什么需要自定义注解？

自定义注解是为了满足特定场景的需求。Java 提供的标准注解有限，无法覆盖所有情况。例如，我们可能需要自定义注解来标记某些方法需要进行权限验证，或者标记某些字段需要进行数据校验。通过自定义注解，我们可以将这些信息嵌入到代码中，并在运行时进行处理，从而实现更灵活、可扩展的功能。

自定义注解在框架开发中的应用

在框架开发中，自定义注解可以极大地简化配置和代码编写。例如，一个 ORM 框架可以使用自定义注解来标记实体类的字段与数据库表的列之间的映射关系。这样，开发者只需要在实体类上添加注解，框架就可以自动完成数据库操作，而无需编写大量的 SQL 代码。Spring Boot 也是大量使用了注解来简化配置，例如 @RestController, @RequestMapping 等等。