Java学习-----SpringBoot的常用注解（上）

        在 SpringBoot 开发中，注解是简化配置、提高开发效率的核心工具。这些注解封装了复杂的底层逻辑，让开发者能够专注于业务实现。本文将解析 SpringBoot 中最常用的几类注解，从定义、作用、原理到实际应用场景，点明其的优缺点及代码示例。​

        （一）启动类相关注解​

（1）@SpringBootApplication​

        定义：@SpringBootApplication是 SpringBoot 的核心注解，用于标识应用程序的入口类，是一个组合注解。​

        作用：替代传统 Spring 应用中繁琐的 XML 配置，自动完成组件扫描、自动配置和配置类注册，实现 "零配置" 启动 Spring 应用。​

        原理：该注解组合了三个核心注解：​

        1.@Configuration：标识当前类为配置类​

        2.@ComponentScan：自动扫描当前类所在包及子包下的所有组件​

        3.@EnableAutoConfiguration：开启自动配置功能，根据类路径下的依赖自动配置 Bean​

        应用场景：仅用于 SpringBoot 应用的主启动类上。​

        其主要的优点有：​

        1.简化配置，无需手动编写 XML 或大量 Java 配置​

        2.自动整合依赖，减少开发者对框架细节的关注​

        其缺点有：​

        1.自动配置逻辑复杂，出现问题时排查难度较大​

        2.过度依赖自动配置可能导致资源浪费

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

        （二）组件注册相关注解

        主要有这4个：@Controller、@Service、@Repository、@Component​

        定义：这组注解用于标识不同层的组件，是 Spring IoC 容器管理 Bean 的基础注解。​

        作用：告诉 Spring 容器哪些类需要被管理，同时区分不同的业务层次。​

        原理：通过@ComponentScan扫描带有这些注解的类，自动将其注册为 Spring 容器中的 Bean。​

        这4个注解的应用场景分别是：​

（1）@Controller：用于控制器类，处理 HTTP 请求​

（2）@Service：用于业务逻辑层类​

（3）@Repository：用于数据访问层类，还会自动转换数据库操作异常​

（4）@Component：通用组件注解，适用于无法归类到其他三层的组件​

        它们的主要优点有：​

（1）清晰划分业务层次，提高代码可读性​

（2）无需手动配置 Bean，减少配置工作量​

        其缺点主要为：​

（1）过度使用可能导致组件职责不清晰​

（2）必须在扫描路径下才能被识别（即启动类必须要与其在同一个文件夹或与其父文件夹在同一个文件夹）

@Controller
public class UserController { ... }

@Service
public class UserService { ... }

@Repository
public class UserRepository { ... }

@Component
public class UserUtil { ... }

        （三）依赖注入相关注解​

（1）@Autowired​

        定义：@Autowired是 Spring 中用于自动依赖注入的注解。​

        作用：自动将 Spring 容器中的 Bean 注入到需要的地方，无需手动创建对象。​

        原理：通过类型匹配（byType）查找合适的 Bean，如果存在多个同类型 Bean 则通过名称匹配（byName），最终通过反射机制完成注入。​

        应用场景：用于类的字段、构造方法或 setter 方法上，实现 Bean 之间的依赖注入。​

        其主要优点位：​

        1.减少手动创建对象的代码，降低耦合度​

        2.支持构造方法注入，有利于进行单元测试​

        其缺点有：​

        1.过度使用会导致依赖关系不明显，增加代码理解难度​

        2.非必须依赖可能导致注入失败，需要配合required=false使用

@Service
public class UserService {
    // 字段注入
    @Autowired
    private UserRepository userRepository;
    
    // 构造方法注入（推荐）
    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}

（2）@Resource​

        定义：@Resource是 JDK 提供的依赖注入注解，与@Autowired功能类似。​

        作用：实现 Bean 的自动注入，可指定名称进行注入。​

        原理：默认通过名称匹配（byName）查找 Bean，若找不到则通过类型匹配（byType）。​

        应用场景：与@Autowired类似，但更适合需要按名称注入的场景。​

        其优点有：​

        1.属于 JDK 标准，不依赖 Spring 框架​

        2.支持 name 属性，可明确指定注入的 Bean 名称​

        其缺点位：​

        1.不支持构造方法注入​

        2.不支持required=false属性

@Service
public class UserService {
    @Resource(name = "userRepositoryImpl")
    private UserRepository userRepository;
}

        （四）请求处理相关注解​

（1）@RequestMapping​

        定义：@RequestMapping是用于映射 HTTP 请求到控制器方法的注解。​

        作用：建立 URL 路径与控制器方法之间的映射关系，支持多种 HTTP 方法。​

        原理：SpringMVC 通过处理器映射器（HandlerMapping）解析该注解，将请求分发到对应的控制器方法。​

        应用场景：用于类或方法上，定义请求的访问路径和方式。​

        其主要优点有：​

        1.灵活配置请求路径和方法​

        2.支持 Ant 风格的路径匹配​

        而缺点主要有：​

        1.配置相对繁琐，需要指定 method 属性​

        2.在 RESTful 风格接口中不如专用注解清晰

@Controller
@RequestMapping("/users")
public class UserController {
    @RequestMapping(value = "/{id}", method = RequestMethod.GET)
    public String getUser(@PathVariable Long id) {
        // 业务逻辑
        return "user";
    }
}

（2）@GetMapping、@PostMapping 等 HTTP 方法注解​

        定义：这些注解是@RequestMapping的简化版，分别对应不同的 HTTP 方法。​

        作用：简化特定 HTTP 方法的请求映射配置。​

        原理：本质上是@RequestMapping的组合注解，例如@GetMapping等价于@RequestMapping(method = RequestMethod.GET)。​

        应用场景：RESTful 风格的接口开发，明确区分不同 HTTP 方法的请求。​

        它们的优点主要有：​

        1.代码更简洁，语义更清晰​

        2.避免重复指定 method 属性​

        缺点则有：​

        2.功能相对单一，复杂场景仍需使用@RequestMapping​

@RestController
@RequestMapping("/users")
public class UserController {
    @GetMapping("/{id}")//获取资源，查询数据
    public User getUser(@PathVariable Long id) { ... }
    
    @PostMapping//创建资源，新增数据
    public User createUser(@RequestBody User user) { ... }
    
    @PutMapping("/{id}")//全量更新资源，替换整个资源
    public User updateUser(@PathVariable Long id, @RequestBody User user) { ... }
    
    @DeleteMapping("/{id}")//删除资源，删除数据
    public void deleteUser(@PathVariable Long id) { ... }
}