Spring Boot 常用注解详解与使用最佳实践建议
更新时间:2025年05月09日 14:34:00 作者:上官箫羽
这篇文章主要介绍了Spring Boot 常用注解详解与使用最佳实践建议,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
一、核心启动注解
1. @SpringBootApplication
- 作用:Spring Boot应用的入口注解,组合了@Configuration、@EnableAutoConfiguration和@ComponentScan
- 使用场景:主启动类上必须使用
- 示例:
@SpringBootApplication public class MyApplication { public static void main(String[] args) { SpringApplication.run(MyApplication.class, args); } }
2. @EnableAutoConfiguration
- 作用:启用Spring Boot的自动配置机制
- 使用场景:当需要自定义自动配置时使用
- 注意:通常不需要单独使用,@SpringBootApplication已包含
3. @Configuration
- 作用:标记类为配置类,替代XML配置
- 使用场景:定义Bean配置时使用
- 示例:
@Configuration public class AppConfig { @Bean public MyService myService() { return new MyServiceImpl(); } }
4. @ComponentScan
- 作用:自动扫描并注册Bean到Spring容器
- 使用场景:需要自定义扫描路径时使用
- 示例:
@SpringBootApplication @ComponentScan({"com.example.main", "com.example.controllers"}) public class MyApplication { // ... }
二、Bean定义与管理
1. @Bean
- 作用:声明方法返回的对象由Spring管理
- 使用场景:配置类中定义第三方库组件的Bean
- 示例:
@Configuration public class AppConfig { @Bean public RestTemplate restTemplate() { return new RestTemplate(); } }
2. @Component/@Service/@Repository/@Controller
- 作用:将类标记为Spring组件,分别对应通用组件、服务层、数据层和控制层
- 使用场景:开发业务组件时根据分层选择对应注解
- 示例:
@Service public class UserServiceImpl implements UserService { // 业务逻辑 } @Repository public class UserRepositoryImpl implements UserRepository { // 数据访问逻辑 }
3. @ConfigurationProperties
- 作用:将配置文件属性绑定到Bean
- 使用场景:需要集中管理配置属性时
- 示例:
@ConfigurationProperties(prefix = "app") public class AppProperties { private String name; private String version; // getters/setters }
4. @Scope
- 作用:定义Bean的作用域(singleton, prototype等)
- 使用场景:需要非单例Bean时
- 示例:
@Bean @Scope("prototype") public MyPrototypeBean myPrototypeBean() { return new MyPrototypeBean(); }
三、依赖注入
1. @Autowired
- 作用:按类型自动注入依赖
- 使用场景:需要注入依赖时首选
- 示例:
@Service public class UserService { @Autowired private UserRepository userRepository; }
2. @Qualifier
- 作用:指定注入的Bean名称(解决多个同类型Bean冲突)
- 使用场景:有多个同类型Bean时
- 示例:
@Autowired @Qualifier("primaryDataSource") private DataSource dataSource;
3. @Value
- 作用:注入属性值
- 使用场景:注入简单配置值
- 示例:
3. @Value 作用:注入属性值 使用场景:注入简单配置值 示例:
四、Web MVC开发
1. @RestController/@Controller
- 作用:标记类为Web控制器
- 使用场景:开发REST API或传统MVC控制器
- 示例:
@RestController @RequestMapping("/api/users") public class UserController { @GetMapping("/{id}") public User getUser(@PathVariable Long id) { // ... } }
2. @RequestMapping/@GetMapping/@PostMapping等
- 作用:映射HTTP请求路径和方法
- 使用场景:定义API端点
- 示例:
@PostMapping("/create") public ResponseEntity<User> createUser(@RequestBody UserDto userDto) { // ... }
3. @RequestBody/@ResponseBody
- 作用:请求体绑定和响应体转换
- 使用场景:REST API开发
- 示例:
@PostMapping public User create(@RequestBody User user) { return userService.save(user); }
4. @PathVariable/@RequestParam
- 作用:从URL路径或参数中获取值
- 使用场景:需要获取URL中的变量或查询参数
- 示例:
@GetMapping("/search") public List<User> searchUsers(@RequestParam String keyword) { // ... }
五、数据访问
1. @Entity/@Table
- 作用:定义JPA实体类和对应表
- 使用场景:数据库表映射
- 示例:
@Entity @Table(name = "users") public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; // ... }
2. @Transactional
- 作用:声明事务
- 使用场景:需要事务管理的方法或类
- 示例:
@Service public class UserService { @Transactional public void updateUser(User user) { // ... } }
3. @RepositoryRestResource
作用:将JPA仓库暴露为REST端点
使用场景:快速开发RESTful数据服务
示例:
@RepositoryRestResource(path = "users") public interface UserRepository extends JpaRepository<User, Long> { }
六、测试相关
1. @SpringBootTest
- 作用:加载完整应用上下文进行集成测试
- 使用场景:集成测试
- 示例:
@SpringBootTest class MyIntegrationTests { @Autowired private MyService myService; // 测试方法 }
2. @WebMvcTest
- 作用:仅测试Web层
- 使用场景:控制器单元测试
- 示例:
@WebMvcTest(UserController.class) class UserControllerTests { @Autowired private MockMvc mockMvc; // 测试方法 }
七、高级特性
1. @EnableCaching/@Cacheable
- 作用:启用缓存和声明可缓存方法
- 使用场景:需要方法结果缓存时
- 示例:
@Service public class UserService { @Cacheable("users") public User getUser(Long id) { // 只有第一次会执行,后续从缓存获取 } }
2. @EnableScheduling/@Scheduled
- 作用:启用定时任务和定义任务执行时间
- 使用场景:需要定时执行任务时
- 示例:
@Component public class MyScheduler { @Scheduled(fixedRate = 5000) public void doTask() { // 每5秒执行一次 } }
3. @Async
- 作用:标记方法为异步执行
- 使用场景:需要异步执行耗时操作时
- 示例:
@Service public class AsyncService { @Async public void asyncMethod() { // 异步执行 } }
最佳实践建议
- 分层清晰:严格遵循Controller-Service-Repository分层,使用对应注解
- 合理使用自动配置:优先使用Spring Boot的自动配置,必要时通过@ConfigurationProperties自定义
- 依赖注入选择:构造函数注入优于字段注入(特别是必选依赖)
- 事务管理:在Service层使用@Transactional,保持事务边界清晰
- 测试策略:根据测试目标选择合适的测试注解(单元测试用@WebMvcTest,集成测试用@SpringBootTest)
- REST API开发:优先使用@RestController和HTTP方法特定注解(@GetMapping等)
到此这篇关于Spring Boot 常用注解详解与使用指南的文章就介绍到这了,更多相关Spring Boot 常用注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
相关文章
spring data jpa开启批量插入、批量更新的问题解析
这篇文章主要介绍了spring data jpa开启批量插入、批量更新问题,本文通过图文实例相结合给大家介绍的非常详细,需要的朋友可以参考下2021-07-07基于SpringBoot和Vue3的博客平台的用户注册与登录功能实现
本教程将指导您如何使用Spring Boot和Vue3实现用户注册与登录功能。我们将使用Spring Boot作为后端框架,Vue3作为前端框架,同时使用MySQL作为数据库,感兴趣的朋友可以参考一下2023-04-04Spring Cloud Data Flow初体验以Local模式运行
这篇文章主要介绍了Spring Cloud Data Flow初体验以Local模式运行,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2020-08-08
最新评论