Spring Boot 常用注解

在开始之前，推荐大家阅读一篇文章《『学习笔记』WebLogic 中的多域配置与管理》（https://cloud.tencent.com/developer/article/2468589），该文章介绍了 WebLogic 多域配置管理，包括目标、架构、过程、问题解决及实施建议等内容，有兴趣的朋友可以去了解下。

一、引言

Spring Boot 以其简洁高效的特性，成为众多 Java 开发者的首选框架。其中，注解起到了至关重要的作用，极大地简化了配置和开发流程。本文将详细介绍 Spring Boot 中常用注解的功能与使用场景。

二、核心注解

（一）@SpringBootApplication

• 概述：这是 Spring Boot 项目的核心注解，它是一个组合注解，实际上整合了@Configuration、@EnableAutoConfiguration和@ComponentScan这三个重要注解的功能。
• 作用：
  • @Configuration部分：表明该类是一个配置类，在这个类中可以通过@Bean注解来定义各种 Spring 管理的 Bean 对象。例如，我们可以在一个带有@SpringBootApplication注解的类中这样定义一个简单的 Bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@SpringBootApplication
public class MyApplication {
    @Bean
    public MyService myService() {
        return new MyServiceImpl();
    }
}

这里定义了一个名为myService的 Bean，它的实现类是MyServiceImpl，Spring 会管理这个 Bean 的生命周期，其他组件可以通过依赖注入的方式使用它。

• @EnableAutoConfiguration部分：它能够根据项目中引入的依赖自动配置 Spring 应用上下文。比如，当我们在项目的pom.xml（Maven 项目）中引入了spring-boot-starter-web依赖，Spring Boot 会自动配置诸如 Tomcat 服务器、Spring MVC 等相关组件，无需我们手动去配置繁杂的 web 相关配置项，极大地简化了开发流程。
• @ComponentScan部分：用于扫描指定包及其子包下带有@Component、@Service、@Repository、@Controller等注解的类，并将它们注册为 Spring 容器中的 Bean。默认情况下，它会扫描与带有@SpringBootApplication注解的类所在的包及其子包。例如，如果我们的项目结构如下：

com
└── example
    └── myproject
        ├── MyApplication.java  // 带有@SpringBootApplication注解的启动类
        └── service
            └── MyServiceImpl.java  // 带有@Service注解的业务类

那么MyServiceImpl类会被自动扫描并注册为 Spring 容器中的 Bean，因为它在com.example.myproject及其子包下。

（二）@RestController

1. 功能
   • 是@Controller和@ResponseBody的组合注解，用于处理 HTTP 请求并将返回值直接写入响应体。
2. 示例

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, World!";
    }
}

（三）@ConfigurationProperties

1. 功能
   • 将配置文件中的属性值绑定到 Java 类的属性上，方便配置管理。
2. 示例

@Component
@ConfigurationProperties(prefix = "myapp")
public class MyAppConfig {
    private String name;
    private int age;
    // 省略getter和setter
}

三、请求映射注解

（一）@GetMapping、@PostMapping 等

1. 功能
   • 分别对应 HTTP 请求方法，简化请求路径与方法的映射。
   • @GetMapping处理GET请求。
   • @PostMapping处理POST请求等。
2. 示例

@RestController
public class UserController {
    @GetMapping("/user/{id}")
    public User getUser(@PathVariable Long id) {
        // 根据id获取用户逻辑
        return user;
    }

    @PostMapping("/user")
    public void createUser(@RequestBody User user) {
        // 创建用户逻辑
    }
}

四、依赖注入注解

（一）@Autowired

1. 功能
   • 按类型自动装配 Spring 容器中的 Bean 到需要的地方。
2. 示例

@Service
public class UserServiceImpl implements UserService {
    // 业务逻辑
}

@RestController
public class UserController {
    @Autowired
    private UserService userService;
    // 调用userService的方法处理请求
}

（二）@Service、@Repository、@Component

1. 功能
   • 将类标记为 Spring 容器中的 Bean，@Service用于业务逻辑层，@Repository用于数据访问层，@Component为通用注解。
2. 示例

@Service
public class UserServiceImpl implements UserService {
    // 业务逻辑
}

@Repository
public class UserDaoImpl implements UserDao {
    // 数据访问逻辑
}

@Component
public class MyUtils {
    // 工具方法
}

五、总结

Spring Boot 的常用注解涵盖了应用启动、请求处理、配置管理、依赖注入等多个方面。熟练掌握这些注解，能够大幅提升开发效率，让开发者更加专注于业务逻辑的实现。在实际项目中，根据具体需求合理运用这些注解，构建出高效、灵活的应用程序。