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}

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

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：@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：文件上传处理接口；
• 使用 / 是通用的路径分隔符，Windows 系统下通常用 \，但在 Java 字符串中需注意转义。

此路径下没有文件

文件上传后的结果：

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