Spring MVC请求与响应全解析：从参数绑定到异常处理

一、请求映射的艺术：RequestMapping深度解析

1. 多级路径配置

@Controller
@RequestMapping("/order")  // 一级路径
public class OrderController {
    
    @GetMapping("/create")  // 二级路径
    public String createOrder() {
        return "order/create";
    }
}

访问路径：/order/create

2. 六大核心属性

典型配置示例

@RestController
@RequestMapping(value = "/api/v1/products", 
                produces = MediaType.APPLICATION_JSON_VALUE)
public class ProductController {
    
    @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE,
                 headers = "X-Request-Source=WEB")
    public ResponseEntity<Product> createProduct(
        @RequestParam("file") MultipartFile file,
        @RequestParam("name") String productName
    ) {
        // 业务逻辑...
    }
}

3. RESTful风格实践

@RestController
@RequestMapping("/api/products")
public class ProductController {
    
    @GetMapping("/{id}")
    public Product getProduct(@PathVariable Long id) {
        return productService.findById(id);
    }
    
    @PostMapping
    public ResponseEntity<Product> createProduct(@RequestBody Product product) {
        Product saved = productService.save(product);
        return ResponseEntity.created(URI.create("/products/"+saved.getId()))
                           .body(saved);
    }
}

二、参数绑定黑科技

1. 智能绑定机制

基础类型绑定

<!-- JSP表单 -->
<input type="text" name="age">

@PostMapping("/user")
public String createUser(int age) { 
    // 自动将age转换为int类型
}

对象嵌套绑定

public class User {
    private Address address;
    // getters/setters
}
public class Address {
    private String city;
    // getters/setters
}

<input type="text" name="address.city">

集合类型绑定

<!-- 绑定List集合 -->
<input type="text" name="accounts[0].accountNumber">
<input type="text" name="accounts[1].accountNumber">

2. 参数处理三剑客

核心特性对比

代码示例：

@PostMapping("/update")
public String updateUser(@RequestParam("uname") String username,
                        @PathVariable Long userId,
                        @RequestBody UserDTO dto) {
    // 业务逻辑
}

三、响应处理全攻略

1. 视图跳转三种模式

对比示例：

// 方式1：ModelAndView
public ModelAndView getUser() {
    ModelAndView mv = new ModelAndView();
    mv.addObject("user", userService.getCurrent());
    mv.setViewName("user/profile");
    return mv;
}

// 方式2：字符串返回
public String showPage(Model model) {
    model.addAttribute("data", fetchData());
    return "page/view";
}

// 方式3：Servlet API
public void download(HttpServletResponse response) {
    response.setHeader("Content-Disposition", "attachment;filename=file.txt");
    // 写入文件流
}

2. JSON交互实践

配置步骤：

1. 添加Jackson依赖
2. 启用注解驱动
3. 使用@ResponseBody

AJAX交互示例：

$.ajax({
    type: "POST",
    url: "/api/users",
    contentType: "application/json",
    data: JSON.stringify({name: "John", age: 30}),
    success: function(data) {
        console.log("创建用户成功:", data);
    }
});

@PostMapping(consumes = "application/json")
@ResponseBody
public User createUser(@RequestBody User user) {
    return userService.save(user);
}

四、文件操作实战

1. 上传配置三要素

<!-- 配置文件解析器 -->
<bean id="multipartResolver" 
      class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="10485760" /> <!-- 10MB -->
</bean>

<!-- 静态资源放行 -->
<mvc:resources mapping="/uploads/**" location="/uploads/"/>

2. 上传下载核心代码

@PostMapping("/upload")
public String handleUpload(@RequestParam("file") MultipartFile file) {
    if (!file.isEmpty()) {
        String fileName = file.getOriginalFilename();
        file.transferTo(new File("/uploads/" + fileName));
        return "上传成功";
    }
    return "上传失败";
}

@GetMapping("/download")
public void downloadFile(HttpServletResponse response) {
    File file = new File("/uploads/report.pdf");
    response.setHeader("Content-Disposition", "attachment; filename=report.pdf");
    Files.copy(file.toPath(), response.getOutputStream());
}

五、异常处理大师课

1. 异常处理金字塔

       ┌──────────────┐
       │   Controller │
       └──────┬───────┘
              ↓
       ┌──────────────┐
       │    Service   │
       └──────┬───────┘
              ↓
       ┌──────────────┐
       │     DAO      │
       └──────┬───────┘
              ↓
       ┌──────────────┐
       │    异常处理器  │
       └──────────────┘

2. 全局异常处理方案

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(SysException.class)
    public ResponseEntity<String> handleCustomException(SysException ex) {
        return ResponseEntity.status(500)
                             .body("系统异常: " + ex.getMessage());
    }

    @ExceptionHandler(Exception.class)
    public ModelAndView handleAllException(Exception ex) {
        ModelAndView mv = new ModelAndView("error/500");
        mv.addObject("errorMsg", "系统繁忙，请稍后再试");
        return mv;
    }
}

异常处理对比

总结

• 请求映射：合理使用多级路径规划API结构
• 参数绑定：善用Spring的智能绑定机制
• 响应处理：根据场景选择最佳响应方式
• 文件操作：注意安全性和性能优化
• 异常处理：建立统一的异常管理体系

性能优化小贴士：

• 使用@ResponseBody替代JSP视图
• 开启GZIP压缩减少数据传输量
• 对文件上传限制大小和类型
• 使用异步处理耗时操作

通过掌握这些核心技巧，您将能够构建出高效、健壮的Spring MVC应用系统。