目录

一、所有注解按照使用位置划分（类、方法、参数）

1. 类级别注解

2. 方法级别注解

3. 参数级别注解

4. 字段/返回值注解

二、按照使用层级划分（业务层、视图层、控制层） 

1、控制层（Controller Layer）

2、业务层（Service Layer）

3、数据层（Data Layer）

4、视图层（View Layer）

5、其他辅助注解

---

一、所有注解按照使用位置划分（类、方法、参数）

1. 类级别注解

作用范围：标记在类上，定义类的基本行为或全局配置。

注解	功能说明
@Controller	声明类为控制器，处理HTTP请求，通常配合视图解析器返回视图名称。
@RestController	@Controller + @ResponseBody，用于REST API，直接返回数据（JSON/XML）。
@RequestMapping	定义类的基础请求路径（如@RequestMapping("/api")），方法级路径继承此路径。
@ControllerAdvice	定义全局异常处理类，结合@ExceptionHandler处理多个控制器的异常。
@RestControllerAdvice	@ControllerAdvice + @ResponseBody，用于REST全局异常处理。
@CrossOrigin	允许类中所有方法的跨域请求（可指定来源、方法、头信息等）。
@SessionAttributes	声明类中需要跨请求共享的模型属性（如@SessionAttributes("user")）。
@EnableWebMvc	启用Spring MVC的默认配置（如消息转换器、视图解析器），通常用在配置类。
@ComponentScan	配置类上指定扫描的包路径，自动注册组件（如控制器、服务等）。

---

2. 方法级别注解

作用范围：标记在方法上，定义方法的行为或处理逻辑。

注解	功能说明
@RequestMapping	定义方法的请求路径和HTTP方法（如@RequestMapping(value="/test", method=RequestMethod.GET)）。
@GetMapping	简化GET请求映射（等价于@RequestMapping(method=GET)）。
@PostMapping	简化POST请求映射。
@PutMapping	简化PUT请求映射。
@DeleteMapping	简化DELETE请求映射。
@PatchMapping	简化PATCH请求映射。
@ExceptionHandler	在控制器或@ControllerAdvice类中定义异常处理方法。
@ResponseBody	方法返回值直接写入HTTP响应体（如返回JSON数据）。
@ResponseStatus	指定HTTP响应状态码（如@ResponseStatus(HttpStatus.NOT_FOUND)）。
@ModelAttribute	标记方法，在控制器方法执行前运行，向模型添加属性（如初始化表单对象）。
@InitBinder	自定义数据绑定逻辑（如注册属性编辑器）。
@Async	声明方法为异步执行（需配合@EnableAsync启用）。

---

3. 参数级别注解

作用范围：标记在方法参数上，用于绑定请求数据。

注解	功能说明
@RequestParam	从请求参数中提取值（支持默认值和别名）。
@PathVariable	从URL路径模板中提取变量（如/user/{id}中的id）。
@RequestBody	将请求体内容（如JSON）反序列化为Java对象。
@RequestHeader	从请求头中提取值。
@CookieValue	从Cookie中提取值。
@ModelAttribute	将请求参数绑定到模型对象（常用于表单提交）。
@Valid / @Validated	触发数据验证（如JSR 303校验）。
@SessionAttribute	从会话中提取已存在的属性值（需配合@SessionAttributes使用）。

---

4. 字段/返回值注解

作用范围：标记在字段或方法返回值上。

注解	功能说明
@ResponseBody	可标记方法，表示返回值直接写入响应体（与类级别@RestController等价）。
@ResponseStatus	也可标记异常类，指定抛该异常时的HTTP状态码。

二、按照使用层级划分（业务层、视图层、控制层） 

1、控制层（Controller Layer）

核心注解：处理 HTTP 请求和响应，定义路由和请求映射

注解	作用说明
@Controller	标记类为控制器，处理 HTTP 请求，通常与视图技术（如 JSP、Thymeleaf）结合使用
@RestController	@Controller + @ResponseBody 的组合，用于 RESTful API（直接返回数据）
@RequestMapping	通用请求映射（可指定 method、path 等参数）
@GetMapping	简化 GET 请求映射 (@RequestMapping(method = RequestMethod.GET))
@PostMapping	简化 POST 请求映射
@PutMapping	简化 PUT 请求映射
@DeleteMapping	简化 DELETE 请求映射
@PatchMapping	简化 PATCH 请求映射
@PathVariable	从 URI 路径中提取参数（如 /users/{id}）
@RequestParam	从 URL 查询参数中提取值（如 ?name=John）
@RequestBody	将 HTTP 请求体（如 JSON）绑定到方法参数对象
@ResponseBody	将方法返回值直接写入 HTTP 响应体（不经过视图解析器）
@ExceptionHandler	在控制器内定义异常处理方法
@CrossOrigin	配置跨域请求支持（CORS）
@InitBinder	自定义请求参数绑定规则

---

2、业务层（Service Layer）

核心注解：实现业务逻辑（由 Spring Core 管理）

注解	作用说明
@Service	标记类为业务逻辑组件（Service 层）
@Transactional	声明事务管理（通常加在 Service 层方法上）

---

3、数据层（Data Layer）

核心注解：数据访问和持久化（由 Spring Data/JPA 管理）

注解	作用说明
@Repository	标记类为数据访问组件（DAO 层）
@Entity	标记 JPA 实体类
@Table	指定实体类对应的数据库表
@Id	标记实体类的主键字段
@GeneratedValue	配置主键生成策略
@Column	配置实体类字段与数据库列的映射

---

4、视图层（View Layer）

核心注解：处理视图渲染和数据展示

注解	作用说明
@ModelAttribute	1. 将方法返回值添加到模型（用于视图渲染） 2. 从模型绑定数据到方法参数
@SessionAttributes	声明控制器使用的会话属性（跨请求共享数据）
@CookieValue	从 HTTP Cookie 中提取值
@RequestHeader	从 HTTP 请求头中提取值

---

5、其他辅助注解

注解	作用说明
@Component	通用组件标记（非 MVC 层，由 Spring Core 管理）
@Configuration	标记配置类（定义 Bean）
@Bean	声明方法返回的对象由 Spring 容器管理
@Autowired	自动注入依赖（按类型）
@Qualifier	按名称指定注入的 Bean
@Profile	指定配置或 Bean 生效的环境
@Value	注入配置文件中的属性值（如 @Value("${app.name}")）