Java学习手册：Spring 中常用的注解
一、组件注解
@Component：用于标记一个类为 Spring 管理的 Bean，是 Spring 的基本组件注解。Spring 会通过类路径扫描自动检测并注册标记了@Component的类为 Bean。@Service：是@Component的派生注解，用于标记服务层类，表示该类是一个业务逻辑组件。@Repository：是@Component的派生注解，用于标记数据访问层类，表示该类是一个数据访问组件，通常用于 DAO（Data Access Object）类。@Controller：是@Component的派生注解，用于标记控制层类，表示该类是一个 Web 控制器组件，通常用于 Spring MVC 中的控制器类。
二、依赖注入注解
@Autowired：用于自动注入依赖。Spring 会自动查找匹配的 Bean 并注入到指定的字段、构造方法或 setter 方法中。如果存在多个同类型的 Bean，可以通过@Qualifier来指定注入的具体 Bean。@Qualifier：用于指定注入的具体 Bean，当存在多个同类型的 Bean 时，可以通过@Qualifier来指定注入哪一个 Bean。它通常与@Autowired一起使用。@Resource：也是用于依赖注入的注解，它与@Autowired类似，但@Resource默认按照名称进行注入，如果找不到匹配的 Bean，则按照类型进行注入。
三、配置注解
@Configuration：用于标记一个配置类，表示该类是一个 Spring 配置类，可以替代传统的 XML 配置文件。@Bean：用于在配置类的方法上定义 Bean。被@Bean注解的方法会返回一个 Bean 实例，Spring 会自动注册该 Bean 到 IoC 容器中。@Import：用于导入其他配置类，可以将其他配置类中的 Bean 定义引入到当前配置类中。@PropertySource：用于指定属性文件的位置，可以加载.properties 文件中的配置属性到 Spring 的环境变量中。@Value：用于注入配置文件中的属性值到字段中。可以通过@Value注解将配置文件中的属性值绑定到 Bean 的字段上。
四、AOP 注解
@Aspect：用于标记一个切面类，表示该类是一个 AOP 切面，包含通知和切入点的定义。@Pointcut：用于定义切入点表达式，指定哪些连接点匹配该切入点。@Before：用于定义前置通知，表示在连接点之前执行的通知方法。@AfterReturning：用于定义后置通知，表示在连接点正常返回后执行的通知方法。@AfterThrowing：用于定义异常通知，表示在连接点抛出异常后执行的通知方法。@After：用于定义最终通知，表示在连接点执行完成后（无论是否抛出异常）执行的通知方法。@Around：用于定义环绕通知，表示在连接点之前和之后都执行的通知方法，可以手动控制连接点的执行。
五、MVC 注解
@Controller：用于标记控制层类，表示该类是一个 Web 控制器组件，用于处理 HTTP 请求。@RequestMapping：用于映射 HTTP 请求到处理方法上。可以通过 URL 模式、HTTP 方法等方式来指定请求的映射规则。@GetMapping：是@RequestMapping的派生注解，专门用于映射 HTTP GET 请求。@PostMapping：是@RequestMapping的派生注解，专门用于映射 HTTP POST 请求。@PutMapping：是@RequestMapping的派生注解，专门用于映射 HTTP PUT 请求。@DeleteMapping：是@RequestMapping的派生注解，专门用于映射 HTTP DELETE 请求。@RequestParam：用于绑定 HTTP 请求参数到方法参数上。可以指定参数是否必填、默认值等。@RequestBody：用于将 HTTP 请求体绑定到方法参数上，通常用于处理 JSON 或 XML 格式的请求数据。@ResponseBody：用于将方法的返回值作为 HTTP 响应体返回给客户端，通常用于返回 JSON 或 XML 格式的数据。@RestController：是@Controller和@ResponseBody的组合注解，用于标记 RESTful 风格的控制器类，表示该类中的所有方法的返回值都会作为 HTTP 响应体返回给客户端。
六、事务注解
@Transactional：用于声明式事务管理，可以标注在类或方法上。标注了@Transactional的方法会在执行时自动开启事务，并在方法执行完成后根据执行结果提交或回滚事务。
七、示例代码
以下是一些常用注解的示例代码：
- 组件注解示例 ：
@Component
public class Car {// 类内容
}@Service
public class UserService {// 类内容
}@Repository
public class UserRepository {// 类内容
}@Controller
public class UserController {// 类内容
}
- 依赖注入注解示例 ：
@Service
public class UserService {@Autowired@Qualifier("userRepository")private UserRepository userRepository;
}@Repository
public class UserRepository {// 类内容
}
- AOP 注解示例 ：
@Aspect
@Component
public class LogAspect {@Pointcut("execution(* com.example.service.*.*(..))")public void servicePointcut() {}@Before("servicePointcut()")public void beforeLog(JoinPoint joinPoint) {System.out.println("方法执行前：" + joinPoint.getSignature().getName());}
}
- MVC 注解示例 ：
@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;@GetMapping("/{id}")public User getUser(@PathVariable Long id) {return userService.getUserById(id);}@PostMappingpublic User createUser(@RequestBody User user) {return userService.createUser(user);}
}
- 事务注解示例 ：
@Service
public class UserService {@Autowiredprivate UserRepository userRepository;@Transactionalpublic void transferMoney(Account fromAccount, Account toAccount, Double amount) {userRepository.decreaseBalance(fromAccount, amount);userRepository.increaseBalance(toAccount, amount);}
}
八、总结
Spring 提供了大量的注解来简化开发和配置工作。通过使用这些注解，开发者可以更加方便地定义 Bean、管理依赖关系、配置 AOP、开发 Web 应用以及进行事务管理等。掌握这些常用注解的使用方法，可以提高开发效率，使代码更加简洁和直观。在实际开发中，合理运用 Spring 的注解功能，可以构建出更加高效、可维护的 Spring 应用。