@Controller 与 @RestController
@Controller用于标记类为Spring MVC控制器,处理HTTP请求并返回视图名称。方法返回值通常配合视图解析器使用,如返回"home"对应home.html。@RestController是@Controller与@ResponseBody的组合,直接返回JSON/XML数据而非视图,适用于RESTful API开发。
@RequestMapping 与衍生注解
@RequestMapping是通用请求映射注解,支持指定路径、方法类型(GET/POST等)、consumes/produces条件。衍生注解包括:
- @GetMapping:简化GET请求映射
- @PostMapping:简化POST请求映射
- @PutMapping:简化PUT请求映射
- @DeleteMapping:简化DELETE请求映射
- @PatchMapping:简化PATCH请求映射
示例代码:
@RestController @RequestMapping("/api/users") public class UserController { @GetMapping("/{id}") public User getUser(@PathVariable Long id) { return userService.findById(id); } }@PathVariable 与 @RequestParam
@PathVariable用于从URI模板中提取变量值,如/users/{id}中的id。@RequestParam用于获取查询参数,支持默认值设置和必填校验:
@GetMapping("/search") public List<User> searchUsers( @RequestParam(required = false, defaultValue = "") String name, @PathVariable String department) { // ... }@RequestBody 与 @ResponseBody
@RequestBody将HTTP请求体反序列化为Java对象,通常用于POST/PUT请求的JSON/XML数据绑定。@ResponseBody将方法返回值序列化为响应体,在@RestController中默认启用。
@Valid 与校验注解
@Valid触发JSR-380 Bean Validation校验,常与校验注解配合使用:
- @NotNull:非空校验
- @Size:字符串/集合长度校验
- @Email:邮箱格式校验
- @Pattern:正则校验
@PostMapping public ResponseEntity<User> createUser(@Valid @RequestBody User user) { return ResponseEntity.ok(userService.save(user)); }@ControllerAdvice 与 @ExceptionHandler
@ControllerAdvice定义全局异常处理类,结合@ExceptionHandler捕获特定异常:
@ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(ResourceNotFoundException.class) public ResponseEntity<ErrorResponse> handleNotFound(ResourceNotFoundException ex) { return ResponseEntity.status(HttpStatus.NOT_FOUND).body(new ErrorResponse(ex.getMessage())); } }@Transactional 事务管理
@Transactional声明式事务管理注解,可配置隔离级别、传播行为、超时等属性。Spring Boot默认对RuntimeException回滚:
@Service public class OrderService { @Transactional(isolation = Isolation.READ_COMMITTED, propagation = Propagation.REQUIRED) public Order createOrder(Order order) { return orderRepository.save(order); } }@Configuration 与 @Bean
@Configuration标记配置类,@Bean声明Spring容器管理的Bean。常用于第三方库集成:
@Configuration public class AppConfig { @Bean public RestTemplate restTemplate() { return new RestTemplateBuilder().build(); } }@Autowired 与依赖注入
@Autowired自动装配依赖,支持构造函数注入、字段注入、Setter方法注入。Spring推荐使用构造函数注入:
@Service public class UserService { private final UserRepository userRepository; @Autowired public UserService(UserRepository userRepository) { this.userRepository = userRepository; } }@Profile 环境配置
@Profile根据激活的profile条件化注册Bean,适用于多环境配置:
@Configuration @Profile("dev") public class DevConfig { @Bean public DataSource devDataSource() { return new EmbeddedDatabaseBuilder().setType(H2).build(); } }@Scheduled 定时任务
@Scheduled配置定时任务执行周期,支持cron表达式、固定延迟等模式:
@Service public class ReportService { @Scheduled(cron = "0 0 9 * * ?") public void generateDailyReport() { // 每天9点执行 } }