Spring Web MVC 核心概念与实战

• 类级注解：设置请求路径的前缀。
• 方法级注解：设置具体的请求路径。
• 路径规则：URL 路径最前是否加 / 不影响访问，Spring 会自动补全。

请求参数接收

@RequestParam：解决前后端参数名称不一致问题，可设置必传。

@RequestMapping("/r6")
public String r6(@RequestParam(value = "sa", required = false) String resouce) {
    return "接收到 resouce = " + resouce;
}

@PathVariable：从 URL 路径中提取参数，适用于 RESTful 风格。

@RequestMapping("/r11/{articleId}/{type}")
public String r11(@PathVariable("articleId") Integer id, @PathVariable String type) {
    return "articleId = " + id + ", type = " + type;
}

响应处理

• @ResponseBody：标识方法返回数据而非视图。
• @RestController：组合注解，等价于 @Controller + @ResponseBody，类中所有方法默认返回数据。

// 返回视图
@Controller
public class IndexController {
    @RequestMapping("/index")
    public String index() {
        return "/index.html";
    }
}

// 返回数据
@RestController
public class DataController {
    @RequestMapping("/data")
    public String getData() {
        return "这是返回的数据内容";
    }
}

请求处理全场景实战

基础参数传递

直接通过方法参数接收前端参数，名称需一致。

@RequestMapping("/r1")
public String r1(String name) {
    return "接收到参数 name = " + name;
}

支持多个参数同时接收，顺序不影响绑定结果：

@RequestMapping("/r4")
public String r4(String name, String password, Integer age) {
    return "name = " + name + ", password = " + password + ", age = " + age;
}

复杂参数处理

当参数较多时，可封装为实体类接收，Spring 会自动按属性名绑定。

public class Person {
    private String name;
    private String password;
    private int age;
    // getter/setter 省略
}

@RequestMapping("/r5")
public String r5(Person person) {
    return "接收到参数 person = " + person;
}

数组与集合参数： 数组参数可直接接收，集合参数需配合 @RequestParam。

@RequestMapping("/r7")
public String r7(String[] names) {
    return "names = " + Arrays.toString(names);
}

@RequestMapping("/r8")
public String r8(@RequestParam List<String> names) {
    return "names = " + names;
}

传递 JSON 数据

JSON 是一种轻量级的文本数据交互格式，基于 ECMAScript 规范，核心优势是跨平台兼容、结构灵活且安全性高。

JSON 语法要点：

• Key 必须用双引号包裹。
• 不同数据之间用逗号分隔，末尾不可加多余逗号。
• 字符串类型值需用双引号包裹，数字、布尔值无需包裹。

对象互转工具：Spring Web 依赖已集成 jackson-databind，使用 ObjectMapper 类。

package cn.overthinker.springboot;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;

public class JSONTests {
    private static ObjectMapper objectMapper = new ObjectMapper();

    public static void main(String[] args) throws JsonProcessingException {
        Person person = new Person();
        person.setName("zhangsan");
        person.setAge(18);
        
        // 对象转 json 字符串
        String s = objectMapper.writeValueAsString(person);
        System.out.println(s);
        
        // json 字符串转对象
        String json = "{\"name\":\"zhangsan\",\"age\":18}";
        Person person1 = objectMapper.readValue(json, Person.class);
        System.out.println(person1);
    }
}

后端接口实现：使用 @RequestBody 注解绑定请求正文。

@RequestMapping("/r9")
public String r9(@RequestBody Person person) {
    return "接收到的参数 person = " + person;
}

注意：发送 JSON 请求时需设置 Header Content-Type: application/json。

文件上传功能

使用 MultipartFile 处理文件上传。

@RequestMapping("/r12")
public String r12(MultipartFile file) throws IOException {
    // 获取原始文件名
    System.out.println("文件原始名称：" + file.getOriginalFilename());
    // 保存文件
    File destFile = new File("D:/temp/" + file.getOriginalFilename());
    file.transferTo(destFile);
    return "接受到文件，已保存至 D:/temp 目录";
}

Cookie 与 Session 会话管理

Cookie 存储在客户端，Session 存储在服务器端。

Cookie 操作： 可通过 HttpServletRequest 获取，或使用 @CookieValue 注解。

@RequestMapping("/getCookie")
public String getCookie(HttpServletRequest request) {
    Cookie[] cookies = request.getCookies();
    if (cookies != null) {
        for (Cookie cookie : cookies) {
            System.out.println(cookie.getName() + ":" + cookie.getValue());
        }
    }
    return "获取 Cookie 成功";
}

Session 操作： Session 数据存储在服务器内存，客户端通过 SessionID 关联。

@RequestMapping("/setSession")
public String setSession(HttpSession session) {
    session.setAttribute("name", "zhangsan");
    session.setAttribute("age", 20);
    return "设置 Session 成功";
}

@RequestMapping("/getSession")
public String getSession(HttpSession session) {
    String name = (String) session.getAttribute("name");
    return "name: " + name;
}

若交换 SessionID，对应的 Session 数据也会随之切换，说明 Session 是基于服务器端的会话标识来区分用户的。

响应处理高级应用

静态页面返回

需使用 @Controller 注解，静态页面放置在 resources/static 目录下。

@Controller
public class IndexController {
    @RequestMapping("/index")
    public Object index() {
        return "/index.html";
    }
}

JSON 数据响应

Spring MVC 可自动将对象转换为 JSON 格式响应。

@ResponseBody
@RequestMapping("/returnJson")
public HashMap<String, String> returnJson() {
    HashMap<String, String> map = new HashMap<>();
    map.put("Java", "Java Value");
    return map;
}

状态码与 Header 设置

@RequestMapping("/setStatus")
@ResponseBody
public String setStatus(HttpServletResponse response) {
    response.setStatus(401); // 未授权
    return "设置状态码成功";
}

综合项目实战

加法计算器

• 接口：/calc/sum
• 代码：

@RestController
@RequestMapping("/calc")
public class CalcController {
    @RequestMapping("/sum")
    public String sum(Integer num1, Integer num2) {
        Integer sum = num1 + num2;
        return "<h1>计算结果：" + sum + "</h1>";
    }
}

用户登录系统

核心功能包括账号校验、Session 保持及显示当前用户。

@RestController
@RequestMapping("/user")
public class LoginController {
    @RequestMapping("/login")
    public boolean login(String userName, String password, HttpSession session) {
        if (!StringUtils.hasLength(userName) || !StringUtils.hasLength(password)) {
            return false;
        }
        if ("zhangsan".equals(userName) && "123456".equals(password)) {
            session.setAttribute("userName", userName);
            return true;
        }
        return false;
    }
}

开发工具与效率提升

Postman 接口测试

Postman 是后端开发常用的接口测试工具，支持多种请求方式和参数类型，无需编写前端代码即可完成测试。

Lombok 简化开发

Lombok 通过注解自动生成 getter/setter 等冗余代码。

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Person {
    private int id;
    private String name;
    private String password;
}

企业开发规范

遵循规范可提升代码可读性和维护性：

1. 命名规范：类名大驼峰，方法名小驼峰，包名全小写。
2. 代码格式：缩进 4 个空格，关键逻辑添加注释。
3. 注解使用：优先使用组合注解（如 @RestController）。