Java 注解详解：原理、分类与 Spring Boot 应用

注解的分类

1. 内置注解

@Override // 检查方法重写
@Deprecated // 标记过时的方法
@SuppressWarnings("unchecked") // 抑制警告

2. 元注解（注解的注解）

@Target(ElementType.METHOD) // 注解可以用在哪里
@Retention(RetentionPolicy.RUNTIME) // 注解保留到什么时候
@Documented // 包含在 Javadoc 中
@Inherited // 子类可以继承

3. 自定义注解

// 曼波教你创建自己的注解！
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ManboAnnotation {
    String value() default "曼波默认值"; // 注解属性
    int priority() default 1;
}

Spring Boot 中的注解魔法

核心原理：反射 + 注解 = 魔法！

// Spring 是怎么知道 @RestController 是控制器的呢？
// 1. 扫描所有类
// 2. 检查是否有 @RestController 注解
// 3. 如果有，就创建实例并管理起来
@RestController // ← Spring 看到这个就知道要特殊处理！
public class HelloController {
    // 魔法发生在这里～
}

常用 Spring 注解分类：

// 🌸 声明 Bean 的注解
@Component // 通用组件
@Repository // 数据访问层
@Service // 业务层
@Controller // 控制层
@RestController // REST 控制层

// 🔗 依赖注入
@Autowired // 自动装配
@Resource // 按名称装配

// 🌐 Web 相关
@RequestMapping
@GetMapping
@PostMapping
@PathVariable
@RequestParam

// ⚙️ 配置相关
@Configuration
@Bean
@Value
@PropertySource

曼波带你写个自定义注解！

// 1. 定义注解：记录方法执行时间
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface TimeLog {
    String name() default "";
}

// 2. 使用注解
public class Calculator {
    @TimeLog(name = "加法计算")
    public int add(int a, int b) {
        return a + b;
    }
    
    @TimeLog(name = "乘法计算")
    public int multiply(int a, int b) {
        return a * b;
    }
}

// 3. 处理注解（通过反射）
public class AnnotationProcessor {
    public static void process(Object obj) throws Exception {
        Class<?> clazz = obj.getClass();
        for (Method method : clazz.getDeclaredMethods()) {
            if (method.isAnnotationPresent(TimeLog.class)) {
                TimeLog annotation = method.getAnnotation(TimeLog.class);
                System.out.println("开始执行：" + annotation.name());
                long start = System.currentTimeMillis();
                method.invoke(obj, 10, 20); // 调用方法
                long end = System.currentTimeMillis();
                System.out.println("执行耗时：" + (end - start) + "ms");
            }
        }
    }
}

不用注解会出什么问题？

注解可不仅仅是'提醒一下'的小标签哦！它是有实际功能的！

1. Spring 不认识的类（最严重！）

// ❌ 没有注解 - Spring 完全无视这个类
public class UserService {
    public void saveUser() {
        System.out.println("保存用户");
    }
}

// ✅ 有注解 - Spring 会管理这个类
@Service // ← 这个注解告诉 Spring：请管理我！
public class UserService {
    public void saveUser() {
        System.out.println("保存用户");
    }
}

问题：没有 @Service，Spring 根本不知道这个类的存在，不会创建实例，其他类也无法注入它！

2. 依赖注入失败

// ❌ 没有 @Autowired - Spring 不知道要注入
public class UserController {
    private UserService userService; // 这里是 null！
    public void addUser() {
        userService.saveUser(); // ❌ 空指针异常！
    }
}

// ✅ 有 @Autowired - Spring 自动注入
public class UserController {
    @Autowired // ← 告诉 Spring：请把 UserService 给我！
    private UserService userService;
    public void addUser() {
        userService.saveUser(); // ✅ 正常执行
    }
}

3. URL 映射失效

// ❌ 没有注解 - 浏览器访问不到
public class HelloController {
    public String hello() {
        return "Hello 曼波！";
    }
}

// ✅ 有注解 - 可以正常访问
@RestController
public class HelloController {
    @GetMapping("/hello") // ← 告诉 Spring：/hello 请求找我！
    public String hello() {
        return "Hello 曼波！";
    }
}

问题：访问 http://localhost:8080/hello 会得到 404 错误！

注解 vs 普通标签

让曼波用对比表格说明：

// 这个只是给人看的提示，程序完全忽略
// TODO: 这里需要改成 Service
public class UserService {
    // ...
}

// 这个是给 Spring 看的指令，必须执行！
@Service // ← Spring 看到这个就会行动！
public class UserService {
    // ...
}

注解的实际工作机制

注解背后有强大的机制在运作：

生动的比喻

比喻 1：餐厅点餐

// ❌ 没有注解 = 默默坐在餐厅，没人理你
顾客 小明;
// 结果：饿肚子！

// ✅ 有注解 = 举手喊'服务员！'
@叫服务员 // ← 就像 @Autowired
顾客 小明;
// 结果：服务员过来为你服务！

比喻 2：快递包裹

// ❌ 没有注解 = 包裹没写地址
包裹 我的包裹;
// 结果：快递员不知道送到哪里

// ✅ 有注解 = 包裹写了详细地址
@地址("北京市海淀区") // ← 就像 @RequestMapping
包裹 我的包裹;
// 结果：准确送达！

比喻 3：工厂生产

// ❌ 没有注解 = 原料堆在仓库
原料 钢材;
// 结果：不会自动变成产品

// ✅ 有注解 = 原料贴上'加工指令'
@加工成("汽车零件") // ← 就像 @Component
原料 钢材;
// 结果：流水线自动加工！

总结：注解的重要性

三句话总结：

1. 注解是指令，不是提醒（程序会执行它）
2. 没有注解 = 程序不知道要做什么（会出错或无效）
3. Spring 依赖注解来管理整个应用

实际后果：

• ❌ 类不被 Spring 管理 → 无法注入 → 空指针异常
• ❌ URL 不注册 → 404 错误
• ❌ 事务不生效 → 数据不一致
• ❌ 缓存不工作 → 性能差

建议：

// 记住这些必须加的注解！
@SpringBootApplication // 启动类必须加
@Component/@Service/@Repository // 业务类必须加
@Autowired // 注入依赖必须加
@RestController + @GetMapping // 控制器必须加

所以记住，注解就像是给 Spring 的工作指令，没有指令，Spring 就不知道该做什么了！就像没有菜谱，厨师也不知道怎么做菜一样。

进阶建议

1. 动手实验：自己写个 @ManboLog 注解，记录方法调用日志
2. 深入 Spring：看看 Spring 是怎么通过注解实现自动配置的
3. 注解处理器：学习编译时注解处理（APT 技术）
4. 组合注解：把多个注解组合成一个，比如 @ManboRestController

注解的本质是'约定大于配置'，Spring Boot 通过注解让开发变得超级简单！就像搭积木一样，标注一下，功能就有了。

记住：注解不是魔法，是聪明的设计！ 理解了反射机制，你就看透了注解的本质！