Spring 3.0 MVC注解详解与实例

"这篇文档是关于Spring 3.0 MVC框架中注解的使用，包含实际的示例项目，如PetClinic和imagedb，旨在帮助开发者理解如何在Web应用中利用注解进行控制器和请求处理。" Spring 3.0引入了强大的注解功能，使得基于Java配置的Web MVC开发变得更加简洁。以下将详细阐述Spring 3.0 MVC注解及其使用： 1. **@RequestMapping** 注解：这是Spring MVC中最重要的注解之一，用于映射HTTP请求到特定的处理方法。它可以应用于类级别和方法级别，以定义请求URL、HTTP方法（GET、POST等）以及处理这些请求的控制器方法。 - 类级别注解：应用于控制器类，表示类中的所有方法都处理特定的请求前缀。 - 方法级别注解：更具体地定义每个方法处理的请求路径和参数。 2. **@Controller** 注解：标记一个类作为Spring MVC的控制器。控制器类包含处理用户请求的方法，通常与视图层（如JSP、Thymeleaf等）交互。 3. **@GetMapping** 和 **@PostMapping**：这两个是Spring 3.0之后引入的简化版注解，分别用于处理GET和POST请求。它们是@RequestMapping的简化形式，只关注对应HTTP方法。 4. **@PathVariable**：用于从URL模板中提取变量。例如，`@GetMapping("/users/{id}")`，这里的`{id}`就是一个路径变量，可以通过`@PathVariable("id")`获取其值。 5. **@RequestParam**：用于从请求参数中获取值。例如，`@GetMapping("/search")`，`@RequestParam("query") String query`将获取查询字符串中的`query`参数。 6. **@ResponseBody**：此注解指示控制器方法的返回值应直接写入HTTP响应体，而不是用于视图解析。通常配合JSON序列化库（如Jackson或Gson）使用，返回JSON数据。 7. **@ModelAttribute**：在处理请求之前，可以使用此注解将请求参数绑定到模型对象。通常用于表单提交场景，将表单数据转换为业务对象。 8. **@ExceptionHandler**：用于声明异常处理器，可以捕获并处理特定的运行时异常。 9. **@InitBinder**：用于初始化数据绑定过程，可以自定义数据绑定规则，比如设置日期格式、校验规则等。 示例中的PetClinic项目展示了如何在实际应用中使用这些注解来处理宠物诊所相关的业务逻辑。imagedb示例则专注于处理无状态的multi-action控制器和多段文件上传。 为了启用注解支持，需要在Spring配置文件中声明`DefaultAnnotationHandlerMapping`和`AnnotationMethodHandlerAdapter`，这两个bean是Spring MVC处理注解的基础。 ```xml <bean class="org.springframework.web.servlet.mvc.DefaultAnnotationHandlerMapping"/> <bean class="org.springframework.web.servlet.mvc.AnnotationMethodHandlerAdapter"/> ``` 通过这样的配置，Spring MVC的DispatcherServlet会自动识别并处理带有注解的控制器方法。在实际开发中，可以根据项目需求自定义这些映射和适配器的配置，以实现更复杂的功能。