Java Web 开发：JSON 基础、@Test 测试与 Cookie Session 请求处理

语法规则

• JSON 的两个结构：JSON 的结构只能是对象或者数组，不能直接是字符串、数字等单个值；
• 键值必须是双引号，不能是单引号；
• 逗号分隔且无尾逗号：对象的键值对、数组的元素之间用逗号分隔，但是最后一个元素不能加逗号；
• JSON 不支持注释；
• 大小写敏感。

常见使用

对象

{
  "name": "张三",
  "age": 30,
  "isStudent": false,
  "hobbies": ["篮球", "编程"],
  "address": { "city": "上海", "street": "XX 路" },
  "score": null
}

数组

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

也可以压缩表示

{"name":"张三","age":30,"isStudent":false,"hobbies":["篮球","编程"],"address":{"city":"上海","street":"XX 路"},"score":null}

JSON 字符串和 Java 对象的互转

UserInfo 类

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 字符串

@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}
}

• throws JsonProcessingException：声明异常，因为 objectMapper.writeValueAsString() 可能抛出异常（序列化失败）
• objectMapper：负责 JSON 的序列化（对象->JSON）和反序列化（JSON->对象），用于序列化操作
• objectMapper.writeValueAsString()：用于对象转 JSON 字符串。

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

• objectMapper.readValue()：用于 JSON 转对象
• UserInfo.class：表示要转换的目标类

JSON 的优点

• 简洁易读，语法简单直观；
• 跨语言兼容，几乎所有编程语言都支持；
• 轻量高效，传输和解析速度快；
• 与 JavaScript 无缝集成，适合 Web 开发；
• 结构化能力强，可灵活表示复杂数据，且易于扩展，安全性较高。

传递 JSON

接收 JSON 对象，需要用到 @RequestBody 注解。 @RequestBody：就是'桥梁'，把前端请求体里面的 JSON 数据，自动变成你能用的 JSON 对象，如果没有 @RequestBody，那么就无法接收到数据。

获取 URL 中的参数

获取 URL 中的参数，需要使用 @PathVariable 注解。 @PathVariable（路径变量）

• 语法：{变量名} 表示 url 的动态部分；
• 作用：在一个 url 下可以进行多种类似的请求

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

• @PathVariable("userid") 中的 userid 参数：指定要绑定的路径变量名称，可写可不写
• @PathVariable("userid") 中指定的名称需要与 url 模版中的 {userid} 一致

上传文件：@RequestPart

@RequestPart：用于接收 multipart/form-data 类型请求中的文件或复杂对象的文件，常用于文件上传场景

@RequestMapping("/13")
public String method13(@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：文件上传处理接口；
• 使用 / 是通用的路径分隔符

Cookie 和 Session

Cookie

什么是 Cookie？

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

Cookie 的工作流程

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

就好像，你第一次去超市买东西，办了一张卡，这张卡里面记录着你的积分和消费信息，随后放进钱包保存起来，你第二次去该超市买东西结账的时候，直接出示卡，就可以。收银员刷卡，就可以看到你的相关消费信息。会员卡到期了就无法使用或者失效。

Cookie 的获取

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

// 简洁写法
@RequestMapping("/15")
public String method15(@CookieValue("username") String name) {
    return "name" + name;
}

• HttpServletRequest：表示客户端发给服务器的 HTTP 请求。

既然有请求就有响应。

• HttpServletResponse：表示服务器给客户端返回的 http 响应

Session

什么是 Session？

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

Session 工作流程

1. 创建 Session：用户首次访问服务器时，服务器会生成一个唯一的 SessionId，并在服务器端创建对应的 Session 数据存储；
2. 传递 SessionId：服务器通过 Cookie 将 Session Id 发送给客户端，客户端会将其保存在本地；
3. 后续交互验证：用户再次访问服务器时，客户端会自动携带 Cookie 中的 SessionId，服务器通过这个 SessionId 找到对应的 Session 数据，确认用户身份和上下文，提供个性化服务；
4. 销毁 Session：当用户主动退出登录，Session 超时或服务器重新启动，数据就会被删除。

就好像，你（客户端）去一家酒店吃饭，让服务员点菜或者扫码点菜，就会生成一份属于自己的菜单（session 数据），服务员可以根据你的取餐码（sessionId），知道你点的有哪些东西。

Cookie 和 Session 之间的关系

Session 的存储

@RequestMapping("/16")
public String method16(HttpServletRequest request) {
    // 获取 Session 对象：从 cookie 中获取 SessionId，再根据 SessionId 获取 session 对象
    HttpSession session = request.getSession();
    // 往 Session 里面存储数据
    session.setAttribute("name", "lisi");
    session.setAttribute("age", "11");
    return "存储 Session 成功";
}

Session 的获取

// 写法 1：
@RequestMapping("/17")
public String method17(HttpServletRequest request) {
    // 获取 Session 对象，但不自动创建（如果客户端没有有效的 Session，返回 null）
    HttpSession session = request.getSession(false);
    if (session == null) {
        return "用户未登录";
    } else {
        // 获取 Session 对象：将 Object 类型强制转换为 String
        // getAttribute：根据键名获取对应的值
        String username = (String) session.getAttribute("name");
        String userage = (String) session.getAttribute("age");
        return "用户名：" + username + " 年龄：" + userage;
    }
}

// 写法 2：
@RequestMapping("/18")
// HttpSession：当前用户的会话对象
public String method18(HttpSession session) {
    String username = (String) session.getAttribute("name");
    String userage = (String) session.getAttribute("age");
    return "用户名：" + username + " 年龄：" + userage;
}

// 写法 3：
@RequestMapping("/19")
public String method19(@SessionAttribute("name") String name, @SessionAttribute("age") String age) {
    return "用户名：" + name + " 年龄：" + age;
}

获取 header

header（请求头/响应头）：通信双方传递的'额外说明信息'，就像点外卖上面的备注。

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

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