当前位置：首页 > 文章列表 > 文章 > java教程 > Java注解不会用？手把手教你轻松打造属于你的自定义注解！

Java注解不会用？手把手教你轻松打造属于你的自定义注解！

2025-06-12 21:37:06 0浏览收藏

还在为繁琐的 Java 代码配置头疼吗？本文将带你深入了解 Java 注解，这是一种强大的元数据工具，能为代码添加额外信息，实现编译检查、代码生成和运行时处理等功能。通过手把手教学，你将学会如何自定义注解，包括使用 `@interface` 定义注解、指定 `@Target` 和 `@Retention` 等关键要素。掌握自定义注解，能让你在权限验证、数据校验和框架配置等场景中游刃有余，显著提升代码可读性和框架扩展性。选择合适的保留策略，如 `SOURCE`、`RUNTIME` 或 `CLASS`，将直接影响注解的使用效果。快来学习如何利用 Java 注解简化开发，提升代码质量吧！

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 等等。