Spring Boot + MyBatis 项目中常用注解详解（万字长篇解读）

Spring Boot + MyBatis 项目中常用注解详解

在现代Java开发中，Spring Boot和MyBatis是两大热门框架，广泛应用于构建高效、可维护的企业级应用。两者结合使用，可以充分发挥各自的优势，提高开发效率和代码质量。在这个过程中，注解（Annotations）起到了关键作用。本文将详细、全面地讲解在Spring Boot + MyBatis项目中常用的注解及其含义和作用，并通过分类整理，帮助开发者更好地理解和运用这些工具。

Spring Boot 常用注解

Spring Boot 提供了丰富的注解来简化开发过程。以下将这些注解按照功能进行分类，便于理解和应用。

核心注解

@SpringBootApplication

含义与作用：@SpringBootApplication 是一个复合注解，包含了 @Configuration、@EnableAutoConfiguration 和 @ComponentScan。用于标注主类，启用Spring Boot的自动配置和组件扫描功能。

示例：

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

组件标识注解

这些注解用于标识不同层次的组件，便于Spring进行自动扫描和管理。

@RestController

含义与作用：@RestController 是 @Controller 和 @ResponseBody 的组合注解，用于标识控制器类，适用于构建RESTful Web服务。所有方法返回的对象会自动序列化为JSON或XML。

示例：

@RestController
@RequestMapping("/api")
public class UserController {
   
   

    @GetMapping("/users")
    public List<User> getAllUsers() {
   
   
        // 返回用户列表
    }
}

@Controller

含义与作用：@Controller 用于标识控制器类，通常与视图解析器（如Thymeleaf）配合使用，适用于传统的MVC模式。

示例：

@Controller
public class HomeController {
   
   

    @GetMapping("/")
    public String home(Model model) {
   
   
        model.addAttribute("message", "Hello World");
        return "home";
    }
}

@Service

含义与作用：@Service 用于标识业务逻辑层的组件，增强代码的可读性和可维护性。它也是一个 @Component，因此会被Spring扫描和管理。

示例：

@Service
public class UserService {
   
   

    @Autowired
    private UserRepository userRepository;

    public List<User> getAllUsers() {
   
   
        return userRepository.findAll();
    }
}

@Repository

含义与作用：@Repository 用于标识数据访问层的组件，通常与持久化技术（如JPA、MyBatis）结合使用。它还提供了异常转换功能，将持久层异常转换为Spring的统一异常。

示例：

@Repository
public class UserRepository {
   
   

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public List<User> findAll() {
   
   
        // 查询数据库
    }
}

@Component

含义与作用：@Component 是一个通用的Spring管理的组件注解，用于标识任何Spring管理的Bean。其他注解（如 @Service、@Repository、@Controller）都是 @Component 的特化。

示例：

@Component
public class Utility {
   
   

    public void performTask() {
   
   
        // 执行任务
    }
}

依赖注入注解

这些注解用于实现Spring的依赖注入机制，简化Bean的管理和使用。

@Autowired

含义与作用：@Autowired 用于自动装配Bean，可以应用于构造函数、字段或Setter方法。Spring会根据类型自动注入匹配的Bean。

示例：

@Service
public class OrderService {
   
   

    @Autowired
    private OrderRepository orderRepository;

    // 或者通过构造函数注入
    // private final OrderRepository orderRepository;
    //
    // @Autowired
    // public OrderService(OrderRepository orderRepository) {
   
   
    //     this.orderRepository = orderRepository;
    // }
}

@Qualifier

含义与作用：@Qualifier 与 @Autowired 一起使用，用于在多个Bean候选者中指定要注入的具体Bean。

示例：

@Service
public class PaymentService {
   
   

    @Autowired
    @Qualifier("creditCardPayment")
    private PaymentProcessor paymentProcessor;
}

@Inject

含义与作用：@Inject 是JSR-330规范的注解，与 @Autowired 类似，用于实现依赖注入。功能上与 @Autowired 基本相同，但不支持 required 属性。

示例：

@Service
public class NotificationService {
   
   

    @Inject
    private EmailService emailService;
}

配置注解

用于定义和管理应用的配置和Bean。

@Configuration

含义与作用：@Configuration 用于标识配置类，类似于传统的XML配置文件。可以在配置类中定义Bean，并进行依赖注入的配置。

示例：

@Configuration
public class AppConfig {
   
   

    @Bean
    public RestTemplate restTemplate() {
   
   
        return new RestTemplate();
    }
}

@Bean

含义与作用：@Bean 用于在 @Configuration 类中定义Bean，Spring会管理这些Bean的生命周期和依赖。

示例：

@Configuration
public class DataSourceConfig