一、初步认识Spring Web MVC

二、正式开始Spring MVC之旅

2.1 了解究竟要干嘛

Spring MVC重点就是如何通过浏览器和用户程序进行交互，主要为以下三个方面：

1. 建立连接：将用户（浏览器）和Java程序连接起来，也就是访问一个地址能够调用到我们的Spring程序。
2. 请求：用户请求时会带一些参数，在程序中要想办法获取到参数，所以请求主要目的是获取参数。
3. 响应：执行了业务逻辑之后，要把程序执行的结果返回给用户，就是响应。

2.2 建立链接

在Spring MVC中使用@RequestMapping来实现URL路由映射（链接程序的作用）

具体代码实现：

接下来在浏览器中输入：http://127.0.0.1:8080/hello/v1。

2.2.1 @RequestMapping注解介绍

@RequestMapping 是 Spring MVC 应用程序中最常被用到的注解之一，它是用来注册接口的路由映射的。表示服务收到请求时, 路径为 /hello/v1 的请求就会调用/hello/v1 这个方法的代码.

但需注意：这里需要加入@RestController

⼀个项目中, 会有很多类, 每个类可能有很多的方法, Spring程序怎么知道要执行哪个方法呢?Spring会对所有的类进行扫描, 如果类加了注解@RestController, Spring才会去看这个类里面的方法有没有加 @RequestMapping 这个注解, 当然他的作用还有很多，后面再详细介绍

路由映射: 当用户访问⼀个 URL 时, 将用户的请求对应到程序中某个类的某个方法的过程就叫路由映射.

2.2.2 @RequestMapping使用

2.2.3 @RequestMapping的请求模式

@RequestMapping 既支持Get请求, 又支持Post请求.如不指定method 属性，该接口会同时支持 GET、POST、PUT、DELETE 等所有 HTTP 请求方式

指定GET/POST方法类型，具体操作：

三、认识Postman

访问不同的路径，就是前端给后端发送不同的请求，再发送请求时，可能会带有一些参数，所以了解Spring的请求，需要借助Postman来模拟传参过程。

下面通过具体的例子，来看看到底怎么使用吧：

3.1 传递单个参数

@RequestMapping("h1")
public String v1(String name){
    return "名字是"+name;
}

【使用postman传递】传递前：

传递后：

【直接通过浏览器发送请求并传参】:http://127.0.0.1:8080?name=hhh

参数类型详解：int 与 Integer 的区别

在 Spring MVC 中接收单个参数时，参数类型的选择会影响程序：

• 基本类型 int：值类型，不能为 null。如果前端没有传递对应的参数，Spring 会尝试使用默认值（0），但如果参数是必须的且未传递，可能会导致类型转换异常，最终返回 500 错误。
• 包装类型 Integer：引用类型，可以为 null。适合可选参数场景，前端不传时接收到的值为 null，程序可以更灵活地处理。

示例对比：

// 使用 int 类型 - 必须传参
@RequestMapping("/intDemo")
public String intDemo(int id) {
    return "ID: " + id;  // 前端不传 id 会报错
}

// 使用 Integer 类型 - 可选参数
@RequestMapping("/integerDemo")
public String integerDemo(Integer id) {
    if (id == null) {
        return "ID 未提供";
    }
    return "ID: " + id;
}

1. 对于必填参数，可以使用 int 类型，但最好配合 @RequestParam(required = true) 明确要求。
2. 对于可选参数，推荐使用 Integer 等包装类型，避免因前端遗漏参数导致程序崩溃。
3. 使用包装类型时，注意在方法内部进行 null 值判断，确保逻辑正确性。

其他注意事项：

参数名匹配：Spring MVC 默认通过参数名进行匹配。前端传递的参数名必须与方法参数名一致（区分大小写）。例如，方法参数为 String userName，则前端必须传递 userName 参数。

使用 @RequestParam 注解：可以通过 @RequestParam 注解更精确地控制参数绑定：

• @RequestParam("name") String userName：将前端传递的 name 参数绑定到 userName 变量。
• @RequestParam(required = false) Integer age：将 age 参数设为可选，未传递时值为 null。
• @RequestParam(defaultValue = "18") int age：设置默认值，当参数未传递时使用默认值 18。

1. 参数类型转换：Spring MVC 会自动进行基本类型转换（如 String 转 int、long、boolean 等）。如果转换失败（例如传递 "abc" 给 int 类型），会抛出 TypeMismatchException 并返回 400 错误。
2. 中文参数处理：如果传递中文参数出现乱码，需要在配置中设置字符编码过滤器（如 CharacterEncodingFilter），或在请求头中指定 Content-Type: application/x-www-form-urlencoded; charset=UTF-8。
3. GET vs POST：GET 请求的参数通过 URL 传递（如 ?name=value），POST 请求的参数通常在请求体中。Spring MVC 对两种方式都支持，但需要注意 POST 请求的 Content-Type。
4. 参数验证：对于重要参数，建议使用校验注解（如 @NotNull、@Size、@Min、@Max）配合 @Valid 进行参数校验，确保数据合法性。

3.2 传递多个参数

@RequestMapping("h2")
public String v2(String name,Integer age){
   return "名字是"+name+"今年"+age;
}

对比两个图可以发现，前后端进行参数匹配时，参数的位置不影前后端获取参数结果

3.3 传递对象

public class Student {
    private int id;
    private String name;
    private String password;

    public Student(int id) {
        this.id = id;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "Student{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}

3.4 后端参数重命名

 @RequestMapping("/h4")
    public Object h(@RequestParam("age") String userage) {
        return "接收到的参数userage是"+userage;
    }

RequestMapping("/h5")
    public Object h1(@RequestParam(value="age", required = false) String userage) {
        return "接收到的参数userage是"+userage;
    }

3.5 传递数组

 @RequestMapping("/h6")
 public String h6(String[] array) {
   return Arrays.toString(array);
 }

3.6 传递集合

集合参数：和数组类似, 同⼀个请求参数名有为多个, 且需要使用@RequestParam 绑定参数关系

@RequestMapping("/h7")
public String h7(@RequestParam List<String> list) {
    return "list:"+list+"  size: "+list.size();
}

3.7 传递JSON数据

JSON是一种在客户端和服务端进行交互的轻量级的数据交互格式，有自己的格式和语法，使用文本表示一个对象或数组的信息，因此JSON本质是字符串，主要负责在不同的语言中数据传递和交换。

JSON字符串和Java对象互转：

Spring MVC框架也集成了JSON的转换工具, 我们可以直接使用, 来完成JSON字符串和Java对象的互转 本质上是jackson-databind提供的功能, Spring MVC框架中已经把该工具包引⼊了进来, 可直接使用, 但如果脱离Spring MVC使⽤, 需要引⼊相关依赖

<dependency>
 <groupId>com.fasterxml.jackson.core</groupId>
 <artifactId>jackson-databind</artifactId>
 <version>2.13.5</version>
</dependency>

传递JSON对象：接受JSON对象，需要使用 @RequestBody 注解

RequestBody: 请求正文，意思是这个注解作用在请求正文的数据绑定，请求参数必须在写在请求正文中

 @RequestMapping("/h8")
 public Object h8(@RequestBody Student s) {
     return s.toString();
 }

3.8 获取URL中的参数@PathVariable

这个注解主要作用在请求URL路径上的数据绑定

默认传递参数写在URL上，SpringMVC就可以获取到

  @RequestMapping("/h9/{id}/{name}")
    public String method8(@PathVariable Integer id, @PathVariable("name") String userName) {
        return "解析参数id:"+id+",name:"+userName;
    }

• 如果方法参数名称和需要绑定的URL中的变量名称⼀致时, 可以简写, 不用给@PathVariable的属性赋值, 如上述例子中的id变量
• 如果方法参数名称和需要绑定的URL中的变量名称不⼀致时, 需要@PathVariable的属性value赋值, 如上述例子中的userName变量.

3.9 上传文件 @RequestPart

@RequestMapping("/h10")
      public String getfile(@RequestPart("file") MultipartFile file) throws IOException {
        //获取⽂件名称
         String fileName = file.getOriginalFilename();
        //⽂件上传到指定路径
        file.transferTo(new File("D:/code/" + file.getOriginalFilename()));
         return "接收到⽂件名称为: "+fileName;
    }

检查是否传递成功：

四、小结

谁敢信，我最近一天不吃手抓饼都不行，哈哈哈哈哈。这一节学的时候有点迷迷糊糊的，但是写博客的时候感觉还好，其实spring boot配置也应该写，但是我实在是懒得在创建一遍慢慢截图了，后面在创建项目时在更新吧。请大家动动发财的小手给我点点赞哦