精弘网络 Java 后端微课 - EP1 控制器的编写和数据绑定

新建工程#

若无法连接到官方 Spring Initializr，可更换到国内站点 https://start.springboot.io/

Spring Web
Spring Validation
MySQL Driver
Lombok

1
<maven.compiler.source>17</maven.compiler.source>
2
<maven.compiler.target>17</maven.compiler.target>
3
<parameters>true</parameters>
4
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
5
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

编写一个控制器#

什么是“控制器”（Controller）#

在 Spring Boot 中，控制器是处理用户请求的入口。

你可以把它想象成一个网站或接口的“接待员”： 👉 用户发来请求，控制器接收、处理，然后返回响应。

@RestController 是什么#

1
@RestController = @Controller + @ResponseBody

用来告诉 Spring 这个类是一个控制器（用来接收 Web 请求），并且返回的是 JSON 数据（而不是 HTML 页面）

@RequestMapping 是什么#

告诉 Spring，这个类负责处理哪个 URL 请求

常用方法：加在类上，定义“公共前缀”

数据绑定#

Query 参数绑定#

1
@GetMapping("/get")
2
public String get(@RequestParam("name") String name) {
3
    return name;
4
}

路径参数绑定#

1
@GetMapping("/get/{name}")
2
public String get(@PathVariable("name") String name) {
3
    return name;
4
}

绑定 Query 或表单到对象#

1
@Data
2
public class User {
3
    private String name;
4
    private Integer age;
5
}
6

7
@GetMapping("/get")
8
public String get(User user) {
9
    return user.toString();
10
}

绑定 JSON 到对象#

1
@Data
2
public class User {
3
    @JsonProperty("first_name")
4
    private String firstName;
5
    private Integer age;
6
}
7

8
@PostMapping("/post")
9
public String post(@RequestBody User user) {
10
    return user.toString();
11
}

参数校验#

1
@NotNull、@NotEmpty、@NotBlank
2

3
@Size、@Email
4

5
@Min、@Max

统一 JSON 响应体#

1
@Data
2
@AllArgsConstructor
3
public class AjaxResult<T> {
4
    public static final String SUCCESS_MSG = "OK";
5
    private Integer code;
6
    private String msg;
7
    private T data;
8

9
    public static <N> AjaxResult<N> success() {
10
        return new AjaxResult<>(HttpStatus.OK.value(), SUCCESS_MSG, null);
11
    }
12

13
    public static <N> AjaxResult<N> success(N data) {
14
        return new AjaxResult<>(HttpStatus.OK.value(), SUCCESS_MSG, data);
15
    }
16

17
    public static <N> AjaxResult<N> fail(Integer code, String msg) {
18
        return new AjaxResult<>(code, msg, null);
19
    }
20
}