Files

2026-05-20 11:26:38 +08:00

4.1 KiB

Raw Permalink Blame History

title, date

title	date
SpingBoot注解	2025-12-30

一、注解

1.1 定义

注解（Annotation）是 JDK5.0 引入的特性，可以理解为：给代码添加的 “元数据”（描述数据的数据），就像给代码贴标签，本身不直接影响代码执行，但可以被编译器、框架（如 SpringBoot）读取并做相应处理。

1.2 分类

类型	核心作用	典型示例
源码注解	仅在源码编译阶段生效，编译后注解消失	`@Override`
编译时注解	编译期生效，注解信息保留到class文件，但JVM运行时不加载	Lombok的`@Data`
运行时注解	整个生命周期都存在（源码→编译→运行），可通过反射动态获取注解信息	SpringBoot的`@RestController`、`@Service`、`@Transactional`

1.3 示例

import java.lang.annotation.*;

// 1. 注解的元注解（描述注解的注解）
@Target(ElementType.METHOD) // 注解作用在方法上
@Retention(RetentionPolicy.RUNTIME) // 运行时保留，可通过反射获取
@Documented // 生成Javadoc时包含该注解
public @interface MyAnnotation {
    // 注解的属性（类似方法，可设置默认值）
    String value() default "默认描述";
    int num() default 0;
}

// 2. 使用自定义注解
public class AnnotationTest {
    @MyAnnotation(value = "测试方法", num = 10)
    public void test() {
        System.out.println("执行测试方法");
    }

    // 3. 通过反射读取注解
    public static void main(String[] args) throws NoSuchMethodException {
        // 获取方法对象
        java.lang.reflect.Method method = AnnotationTest.class.getMethod("test");
        // 判断方法是否有该注解
        if (method.isAnnotationPresent(MyAnnotation.class)) {
            // 获取注解实例
            MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
            // 读取注解属性
            System.out.println("注解value：" + annotation.value()); // 输出：测试方法
            System.out.println("注解num：" + annotation.num()); // 输出：10
        }
    }
}

@Target：指定注解能作用的位置（如ElementType.METHOD= 方法、ElementType.TYPE= 类 / 接口、ElementType.FIELD= 字段）。
@Retention：指定注解的保留阶段（RUNTIME是 SpringBoot 注解最常用的）
首先定义注解的@Target和@Retention信息，然后设置注解的属性，类似于方法的参数，比如这里的value和num，需要在使用的时候通过命名参数的形式传递过来。如果是RUNTIME类型的注解，可以通过反射来获取方法和注解的参数，实现自定义逻辑功能。

二、SpringBoot核心注解

2.1 启动类注解

@SpringBootApplication为SpringBoot启动类注解，由以下三个注解组成：

@Configuration：标记类为配置类（替代 XML 配置）
@EnableAutoConfiguration：开启自动配置（SpringBoot 核心，自动配置 Tomcat、数据库连接等）
@ComponentScan：扫描当前包及子包下的 @Component、@Service 等注解的类，纳入 Spring 容器管理

2.2 组件注册注解

注解	作用	使用场景
@Component	通用组件注解	通用工具类、非业务层类
@Controller	控制器注解	MVC 的控制层（返回页面）
@RestController	REST 控制器	API 接口层（返回 JSON/XML，= @Controller + @ResponseBody）
@Service	服务层注解	业务逻辑层
@Repository	数据访问层注解	DAO 层 / 持久层（如 MyBatis 的 Mapper 接口）

4.1 KiB Raw Permalink Blame History Unescape Escape