SpringBoot 基础入门：路由、视图、请求与会话详解

4. 路由

4.1 定义路由

使用注解定义 RESTful 控制器：

package com.example.demo;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.GetMapping;

@RestController
public class Controller {
    @GetMapping("")
    public String main() {
        return "hello Spring";
    }
    
    @GetMapping("/user")
    public String user() {
        return "user";
    }
}

也可组合使用：

@RequestMapping("path")
@RestController
class test03 {
    @GetMapping("")
    @PostMapping("")
    public String f1() {
        return "hello world";
    }
}

4.2 路由传参

路径变量 (@PathVariable)：参数嵌入 URL 路径，适用于资源标识。

@GetMapping("/user/{userid}")
public String User(@PathVariable String userid) {
    return "hello User" + userid;
}

请求参数 (@RequestParam)：从查询列表提取参数。

@GetMapping("query")
public String Query(@RequestParam(value="name", defaultValue="张三") String name) {
    return "hello" + name;
}

4.3 多级路由

通过类上和方法上的注解组合实现多级路径：

@RequestMapping("user")
@RestController
class Controller {
    @GetMapping("/username")
    public String Name(@RequestParam(name="name", defaultValue="无") String name) {
        return "姓名：" + name;
    }
    
    @GetMapping("/userId/{Id}")
    public String Id(@PathVariable String Id) {
        return "编号：" + Id;
    }
}

5. 视图 (Thymeleaf)

5.1 模板引擎简介

Java Web 常用模板引擎：

1. Thymeleaf：现代主流，Spring 官方推荐，支持自然模板。
2. FreeMarker：功能强大，模板与 Java 解耦。
3. JSP：老牌经典，逐步淘汰。

本教程采用 Thymeleaf。需在 pom.xml 引入依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

HTML 文件放在 resources/template 下，静态资源（CSS/JS/图片）放在 static 下。

5.2 配置与渲染

使用 @Controller 返回视图名称：

@Controller
class ShowView {
    @GetMapping("/u1")
    public String F1() {
        return "test01";
    }
}

@Controller vs @RestController：

• @Controller：默认返回视图（HTML），配合 Model 传递数据。
• @RestController：默认返回数据（JSON），用于前后端分离。

5.3 静态资源绑定

使用 th:href 和 th:src 绑定资源：

<link th:href="@{/test01.css}" type="text/css" rel="stylesheet">
<script th:src="@{/test01.js}" type="text/javascript"></script>
<img th:src="@{/pic.png}">

5.4 缓存配置

开发期可禁用模板缓存：

spring.thymeleaf.cache=false

5.5 数据渲染

使用 Model 对象传递数据：

@GetMapping("showData")
public String showData(Model model) {
    model.addAttribute("name", "张三");
    model.addAttribute("score", 85);
    model.addAttribute("isMan", true);
    return "showData";
}

模板中使用 ${key} 取值：

<span th:text="${name}"></span>
<span th:text="${isMan ? '男' : '女'}"></span>

5.6 条件与列表渲染

条件渲染：

<h2 th:if="${isMan}">是纯爷们</h2>
<h2 th:unless="${isMan}">不是纯爷们</h2>

列表渲染 (th:each)：

List<String> arr = new ArrayList<>();
arr.add("高等数学");
model.addAttribute("arr", arr);

<li th:each="item,state :${arr}" th:text="|${state.index+1}-----${item}|"></li>

自定义对象渲染： 需确保类有 getter/setter 和无参构造。

<ul th:object="${user}">
    <li th:text="${user.name}"></li>
</ul>

5.7 表单与校验

GET vs POST：

• GET：只读，参数在 URL 中。
• POST：提交数据，参数在请求体中。

Bean 校验： 引入 spring-boot-starter-validation 和 lombok。

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

实体类添加校验注解：

@Data
public class User {
    @NotBlank(message="不能为空")
    private String name;
    @NotNull(message="不能为空")
    private boolean man;
    @NotNull(message="不能为空")
    private int score;
}

控制器处理校验：

@PostMapping("add")
public String PostAdd(@Valid User user, BindingResult res, Model model) {
    if (res.hasErrors()) {
        model.addAttribute("user", user);
        return "test01111";
    } else {
        return "redirect:/test02";
    }
}

前端绑定：

<form th:action="@{/test02/add}" method="post" th:object="${user}">
    <input th:field="*{name}">
    <span th:errors="*{name}"></span>
</form>

5.8 模板分离技术

使用 th:fragment 定义复用片段，th:replace 或 th:insert 引用。

<!-- header.html -->
<div th:fragment="header">...</div>

<!-- 主页面 -->
<div th:replace="header::header"></div>

6. 响应和请求

6.1 ResponseEntity

封装 HTTP 响应的完整工具，可定制状态码、头和体。

@GetMapping("ok")
public ResponseEntity<?> ok() {
    return ResponseEntity.ok("Ok");
}

@GetMapping("notFound")
public ResponseEntity<?> notFound() {
    return ResponseEntity.notFound().build();
}

6.2 请求头

使用 @RequestHeader 获取请求头信息：

@GetMapping("header")
public ResponseEntity<?> showHeader(@RequestHeader Map<String, Object> headers) {
    return ResponseEntity.ok(headers);
}

常见请求头：

• Content-Type：媒体类型。
• Authorization：身份认证。
• User-Agent：客户端信息。

6.3 请求体

JSON 数据：使用 @RequestBody。

@PostMapping("body")
public ResponseEntity<?> f3(@RequestBody Person person) {
    return ResponseEntity.ok(person);
}

表单数据：使用 @ModelAttribute。

文件上传：使用 MultipartFile。

@PostMapping("file")
public ResponseEntity<?> dealFile(@RequestParam("file") MultipartFile file) {
    // 保存文件逻辑
    return ResponseEntity.ok("success");
}

6.4 响应头设置

使用 HttpHeaders 设置响应头：

@GetMapping("")
public ResponseEntity<?> f1() {
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_JSON);
    return ResponseEntity.ok().headers(headers).body(new HashMap<>());
}

文件下载：

@GetMapping("download/{filename}")
public ResponseEntity<?> download(@PathVariable String filename) {
    Path filePath = Paths.get("uploads", filename);
    byte[] fileData = Files.readAllBytes(filePath);
    Resource resource = new ByteArrayResource(fileData);
    HttpHeaders headers = new HttpHeaders();
    headers.setContentDisposition(ContentDisposition.attachment().filename(filename).build());
    return ResponseEntity.ok().headers(headers).body(resource);
}

6.5 原生 Servlet 对象

使用 HttpServletRequest 和 HttpServletResponse 获取底层信息：

@GetMapping("yuansheng")
public ResponseEntity<?> f1(HttpServletRequest request, HttpServletResponse response) {
    String ip = request.getRemoteAddr();
    response.setStatus(200);
    return ResponseEntity.ok("IP: " + ip);
}

7. 会话管理

7.1 Cookie

Cookie 是客户端存储的小型键值对数据。

设置 Cookie：

@GetMapping("set")
public ResponseEntity<?> set(HttpServletResponse response) {
    Cookie cookie = new Cookie("username", "张三");
    cookie.setMaxAge(86400); // 1 天
    response.addCookie(cookie);
    return ResponseEntity.ok("设置成功");
}

删除 Cookie：

@GetMapping("del")
public ResponseEntity<?> del(HttpServletResponse response) {
    Cookie cookie = new Cookie("username", "");
    cookie.setMaxAge(0);
    response.addCookie(cookie);
    return ResponseEntity.ok("删除成功");
}

7.2 Session

Session 是服务端存储的用户上下文。

设置 Session：

@GetMapping("set")
public ResponseEntity<?> set(HttpSession session) {
    session.setAttribute("key", "value");
    return ResponseEntity.ok("设置成功");
}

获取 Session：

@GetMapping("get")
public ResponseEntity<?> get(HttpSession session) {
    Object val = session.getAttribute("key");
    return ResponseEntity.ok(val);
}

销毁 Session：

@GetMapping("del")
public ResponseEntity<?> del(HttpSession session) {
    session.invalidate();
    return ResponseEntity.ok("销毁成功");
}