Java Web 实战：JSON 处理、单元测试与会话管理

数组结构

[
  { "id": 1, "name": "苹果", "price": 5.99 },
  { "id": 2, "name": "香蕉", "price": 3.5 },
  { "id": 3, "name": "橙子", "price": 4.2 }
]

单元测试与 JSON 验证

@Test 注解的作用

@Test 是 JUnit 提供的单元测试注解，用于标记'测试方法'，让测试框架自动执行该方法以验证代码逻辑。在开发中，我们常用它来测试 JSON 序列化/反序列化是否正常，或者从文件读取数据的功能是否稳定。

public class JsonTest {
    @Test
    void test1() {
        System.out.println(111);
    }

    @Test
    void test2() {
        System.out.println(222);
    }
}

测试方法可以单个窗口执行，也可以多个窗口同时运行，互不干扰。

@Test 与 main 方法的区别

JSON 与 Java 对象互转

在实际开发中，我们经常需要在 JSON 字符串和 Java 对象之间进行转换。这里推荐使用 Jackson 库的 ObjectMapper 类。

实体类定义

首先定义一个简单的用户信息类，确保包含 Getter/Setter 方法。

public class UserInfo {
    private String name;
    private int age;

    public UserInfo() {}

    public UserInfo(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }

    @Override
    public String toString() {
        return "UserInfo{" + "name='" + name + '\'' + ", age=" + age + '}';
    }
}

对象转 JSON 字符串

使用 writeValueAsString() 方法将对象序列化为 JSON 字符串。

@Test
void test3() throws JsonProcessingException {
    // 创建 ObjectMapper 实例
    ObjectMapper objectMapper = new ObjectMapper();
    // 构建 UserInfo 对象
    UserInfo userInfo = new UserInfo("小熊", 3);
    // 对象转 Json 字符串
    String s = objectMapper.writeValueAsString(userInfo);
    System.out.println(s); // 输出：{"name":"小熊","age":3}
}

注意：writeValueAsString() 可能会抛出异常，因此方法签名通常需要声明 throws JsonProcessingException。

JSON 字符串转对象

使用 readValue() 方法将 JSON 字符串反序列化为 Java 对象。

@Test
void test4() throws JsonProcessingException {
    ObjectMapper objectMapper = new ObjectMapper();
    // 定义一个字符串
    String s = "{\"name\":\"小熊\",\"age\":3}";
    // Json 转对象
    UserInfo userInfo = objectMapper.readValue(s, UserInfo.class);
    System.out.println(userInfo);
}

这里的 UserInfo.class 指定了要转换的目标类类型。

HTTP 请求处理

在 Spring MVC 中，处理前端传来的数据有多种方式，根据数据来源不同选择相应的注解。

接收 JSON 对象 (@RequestBody)

当需要接收前端发送的 JSON 格式的请求体数据时，使用 @RequestBody 注解。它充当桥梁，把前端请求体里面的 JSON 数据自动绑定到后端对象上。

@RequestMapping("/api/user")
public String handleUser(@RequestBody UserInfo user) {
    // 此时 user 对象已包含前端传来的 JSON 数据
    return "收到用户：" + user.getName();
}

如果没有 @RequestBody，Spring 将无法正确解析请求体中的 JSON 内容。

获取 URL 路径参数 (@PathVariable)

对于动态路径中的参数，例如 /user/123/info，需要使用 @PathVariable。

@RequestMapping("/11/{id}/{name}")
public String method10(@PathVariable("id") Integer id, @PathVariable("name") String name) {
    return "获取文章 id:" + id + " 获取文章 name:" + name;
}

• {变量名} 表示 URL 的动态部分。
• @PathVariable("userid") 指定的名称需要与 URL 模版中的 {userid} 一致，虽然有时可以不写名称，但显式指定更清晰。

上传文件 (@RequestPart)

处理文件上传通常涉及 multipart/form-data 类型请求，可以使用 @RequestPart 配合 MultipartFile。

@RequestMapping("/upload")
public String methodUpload(@RequestPart("file") MultipartFile file) throws IOException {
    // 获取文件名称
    String filename = file.getOriginalFilename();
    System.out.println(filename);
    
    // 创建文件对象 (注意路径分隔符在不同系统下的差异)
    File file1 = new File("D:/.temp/" + file.getOriginalFilename());
    
    // 文件保存
    file.transferTo(file1);
    return "文件上传成功";
}

MultipartFile 是 Spring 提供的文件上传处理接口，transferTo 方法负责将流写入磁盘。

Cookie 与 Session 管理

Web 开发中，HTTP 协议本身是无状态的，为了保持用户状态，我们需要借助 Cookie 和 Session。

Cookie 详解

Cookie 是 Web 服务器保存在用户浏览器上的小型文本文件。

工作流程

1. 首次访问网站，浏览器发送请求；
2. 服务器生成 Cookie 信息，通过 Set-Cookie 响应头返回；
3. 浏览器接收并保存 Cookie；
4. 再次访问该网站时，浏览器自动在请求头中携带 Cookie；
5. 服务器识别 Cookie，返回对应内容；
6. Cookie 过期或被清除后失效。

这就好比去超市办了一张会员卡，第一次存入积分，第二次结账出示卡片即可识别身份。

获取 Cookie

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

// 简洁写法
@RequestMapping("/getCookieValue")
public String method15(@CookieValue("username") String name) {
    return "用户名：" + name;
}

Session 详解

Session 是指客户端与服务器之间为完成特定交互而建立的临时、有状态的连接或数据存储机制，核心作用是在无状态的 HTTP 下保护用户的身份信息和操作上下文。

工作流程

1. 创建 Session：用户首次访问，服务器生成唯一的 SessionId 并在服务端创建存储；
2. 传递 SessionId：服务器通过 Cookie 将 SessionId 发送给客户端；
3. 后续交互验证：客户端携带 Cookie 中的 SessionId，服务器找到对应的 Session 数据确认身份；
4. 销毁 Session：用户退出登录、超时或服务器重启后删除。

这就像在酒店吃饭，服务员为你生成一份专属菜单（Session 数据），凭取餐码（SessionId）就能知道你的订单。

Session 存储与获取

// 存储数据
@RequestMapping("/setSession")
public String method16(HttpSession session) {
    session.setAttribute("name", "lisi");
    session.setAttribute("age", "11");
    return "存储 Session 成功";
}

// 获取数据 - 写法 1：手动检查
@RequestMapping("/getSession1")
public String method17(HttpSession session) {
    if (session == null) {
        return "用户未登入";
    }
    String username = (String) session.getAttribute("name");
    String userage = (String) session.getAttribute("age");
    return "用户名：" + username + " 年龄：" + userage;
}

// 获取数据 - 写法 2：直接注入（若不存在可能报错或需配置）
@RequestMapping("/getSession2")
public String method18(HttpSession session) {
    String username = (String) session.getAttribute("name");
    return "用户名：" + username;
}

// 获取数据 - 写法 3：直接绑定属性
@RequestMapping("/getSession3")
public String method19(@SessionAttribute("name") String name) {
    return "用户名：" + name;
}

Cookie 与 Session 的关系

获取请求头 (Header)

Header 是通信双方传递的'额外说明信息'，类似于点外卖时的备注。

// 写法 1：通过 HttpServletRequest 获取
@RequestMapping("/getHeader1")
public String method20(HttpServletRequest request) {
    String agent = request.getHeader("User-Agent");
    return "agent:" + agent;
}

// 写法 2：使用 @RequestHeader 注解
@RequestMapping("/getHeader2")
public String method21(@RequestHeader("User-Agent") String agent) {
    return "agent:" + agent;
}

通过这种方式，我们可以轻松获取客户端的设备信息、语言偏好等细节。