Spring 注解开发指南

@Target(ElementType.TYPE)       // 只能用在类上
@Retention(RetentionPolicy.RUNTIME) // 运行时仍保留（反射可读）
public @interface MyAnnotation {
    String value() default "";
}

@Service  // 标注当前类是 Service 层的 Bean
public class UserService {
    public String getUser() {
        return "用户信息";
    }
}

@RestController
public class UserController {

    @Autowired
    private UserService userService;  // Spring 自动注入 UserService 的实例

    @GetMapping("/user")
    public String getUser() {
        return userService.getUser();
    }
}

@Service
public class UserServiceImpl implements UserService {
    // 方式一：字段注入（最简洁，最常用）
    @Autowired
    private UserMapper userMapper;

    // 方式二：Setter 注入
    private RoleMapper roleMapper;
    @Autowired
    public void setRoleMapper(RoleMapper roleMapper) {
        this.roleMapper = roleMapper;
    }

    // 方式三：构造器注入（Spring 官方推荐，便于测试和不可变设计）
    private final LogMapper logMapper;
    @Autowired  // 如果类只有一个构造器，可以省略 @Autowired
    public UserServiceImpl(LogMapper logMapper) {
        this.logMapper = logMapper;
    }
}

@Autowired(required = false)  // 找不到 Bean 时不报错（字段保持 null）
private MailService mailService;

@Component
public class SmsSender implements MessageSender { }

@Component("emailSender")  // 自定义 Bean 名称
public class EmailSender implements MessageSender { }

@RestController
public class NotificationController {

    @Autowired
    @Qualifier("emailSender")  // 指定注入名为 "emailSender" 的 Bean
    private MessageSender messageSender;
}

@Component
@Primary  // 没有 @Qualifier 时默认注入这个
public class SmsSender implements MessageSender { }

@Resource(name = "userService")  // 按名称注入
private UserService userService;

// 不指定 name 时，以字段名作为查找名称
@Resource
private UserService userService; // 先按名称查找，找不到再按类型

@Component
@Scope("singleton")     // 单例（默认），整个容器只创建一个实例
// @Scope("prototype")  // 原型，每次获取都创建新实例
// @Scope("request")    // 每个 HTTP 请求创建一个（Web 容器中）
// @Scope("session")    // 每个 HTTP Session 创建一个（Web 容器中）
public class UserService { }

@Component
@Lazy  // 第一次使用时才创建，而不是容器启动时就创建
public class HeavyService { }

@RestController  // = @Controller + @ResponseBody（所有方法返回值直接作为响应体）
public class UserController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello World";  // 直接返回字符串，不解析为视图
    }
}

@Controller  // 传统 MVC：返回视图页面
public class PageController {
    @GetMapping("/index")
    public String index(Model model) {
        model.addAttribute("name", "张三");
        return "index";  // 解析为 index.html 模板
    }
}

@RestController
@RequestMapping("/users")  // 类级别：统一前缀
public class UserController {

    @GetMapping("/{id}")        // GET /users/1
    public User get(@PathVariable Long id) { return ...; }

    @PostMapping                // POST /users
    public User create(@RequestBody User user) { return ...; }

    @PutMapping("/{id}")        // PUT /users/1
    public User update(@PathVariable Long id, @RequestBody User user) { return ...; }

    @DeleteMapping("/{id}")     // DELETE /users/1
    public void delete(@PathVariable Long id) { ... }
}

@RestController
public class DemoController {

    // @RequestParam: 处理 ?page=1&size=10
    @GetMapping("/list")
    public String list(@RequestParam(defaultValue = "1") int page,
                       @RequestParam(defaultValue = "10") int size) {
        return "page=" + page + ", size=" + size;
    }

    // @PathVariable: 处理 /users/123
    @GetMapping("/users/{id}")
    public String getUser(@PathVariable Long id) {
        return "userId=" + id;
    }

    // @RequestBody: 接收 JSON 请求体
    @PostMapping("/users")
    public String createUser(@RequestBody User user) {
        return "created: " + user.getName();
    }

    // @RequestHeader: 获取请求头
    @GetMapping("/info")
    public String info(@RequestHeader("User-Agent") String userAgent) {
        return "UA=" + userAgent;
    }

    // @SessionAttribute: 获取 Session 中的用户信息
    @GetMapping("/profile")
    public String profile(@SessionAttribute(value = "currentUser", required = false) User user) {
        return user != null ? user.getName() : "未登录";
    }
}

@Controller
public class UserController {
    @GetMapping("/user")
    @ResponseBody  // 不加的话会去查找 user.html 视图
    public User getUser() {
        return new User("张三", 18);
    }
}

@ResponseStatus(HttpStatus.CREATED)  // 返回 201
@PostMapping("/users")
public User create(@RequestBody User user) { ... }

@RestControllerAdvice  // = @ControllerAdvice + @ResponseBody
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public Result handleArithmetic(ArithmeticException e) {
        return Result.error("数学运算异常：" + e.getMessage());
    }

    @ExceptionHandler(Exception.class)  // 兜底处理
    public Result handleException(Exception e) {
        return Result.error("服务器内部错误");
    }
}

@SpringBootApplication
@ServletComponentScan  // 扫描 Filter、Servlet 等
public class Application { }

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    @Autowired
    private LogMapper logMapper;

    @Transactional  // 该方法中的所有数据库操作在同一个事务中执行
    public void transfer(Long fromId, Long toId, BigDecimal amount) {
        userMapper.deduct(fromId, amount);    // 扣钱
        userMapper.add(toId, amount);         // 加钱
        logMapper.insert(new Log("转账成功")); // 记录日志
        // 如果任意一步失败，所有操作回滚
    }
}

@Transactional(
    propagation = Propagation.REQUIRED,  // 事务传播行为（默认：有则加入，无则新建）
    isolation = Isolation.READ_COMMITTED, // 事务隔离级别
    timeout = 30,                        // 超时秒数
    rollbackFor = Exception.class        // 遇到哪些异常时回滚（默认只回滚 RuntimeException）
)
public void doSomething() { ... }

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Controller
@ResponseBody
public @interface MyRestController {
    @AliasFor(annotation = Controller.class, attribute = "value")
    String value() default "";
}