Spring Boot 创建首个项目：Spring Web MVC 入门指南

可以看到，Spring Web 的介绍是: Build web, including RESTful, applications using Spring MVC. Uses Apache Tomcat as the default embedded container.

这时候可能有些学⽣就懵了，前⾯创建的不是 SpringBoot 项⽬吗？怎么⼜变成了 Spring MVC 项⽬？他们之间到底有着什么样的关系？

SpringBoot 是 2014 年发布的，Spring 是 2004 年发布的，在 2014 年发布之前，就不能⽤ Spring 实现 MVC 架构吗？显然不是了。

Spring Boot 只是实现 Spring MVC 的其中一种方式而已。 Spring Boot 可以添加很多依赖，借助这些依赖实现不同的功能。Spring Boot 通过添加 Spring Web MVC 框架，来实现 web 功能。

⽐如：厨房可以⽤来做饭，但真实实现做饭功能的是⽕以及各种做饭相关的⻝材和⼯具。厨房就好⽐是 SpringBoot，厨房可以装柜⼦，实现收纳功能，装燃⽓灶等，实现做饭功能。做饭这个事，就是 MVC，在⼏千年前，有⽕有⻝材就可以实现做饭。

不过 Spring 在实现 MVC 时，也结合⾃身项⽬的特点，做了一些改变，相对⽽⾔，下⾯这个图或许更加合适⼀些。

不过核⼼没变 ⽐如上⾯的例⼦中，去饭店吃饭。⼀些饭店是前厅来负责接待客⼾，帮助客⼾点餐，也就是 Controller 来负责接收⽤⼾的请求。

2.3 再次理解 MVC 和 SpringMVC

一个项目并不是单纯的是 SpringBoot 项目，也不是单纯的是 SpringMVC 项目，他们之间是有交集的。

SpringBoot 是帮助我们快速搭建一个项目；SpringMVC 是项目中的一个模块，是我们使用中的一个依赖，这个依赖就是下面的代码：

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

MVC 简单的来说就是把一个项目分成了三个部分：

现在的 SpringMVC 把 MVC 的模式改变了一些：

我们用一个例子：

SpringBoot 是创建 SpringMVC 的一种方式，创建 MVC 方式有很多

当前阶段，MVC 的概念发生了一些变化，后端开发人员不涉及前端的也页面开发，所以也就没有 view 层

所以 view 又有了一层解释：之前返回的是视图，现在返回的是试图所需要的数据 如下：

3.学习 Spring MVC

3.1 学习 SpringMVC 的重点

既然是 Web 框架，那么当⽤⼾在浏览器中输⼊了 url 之后，我们的 Spring MVC 项⽬就可以感知到⽤⼾的请求，并给予响应。

咱们学习 Spring MVC，重点也就是学习如何通过浏览器和⽤⼾程序进⾏交互。主要分以下三个⽅⾯:

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

对于 Spring MVC 来说，掌握了以上 3 个功能就相当于掌握了 Spring MVC.

3.2 项⽬准备

Spring MVC 项⽬创建和 Spring Boot 创建项⽬相同，在创建的时候选择 Spring Web 就相当于创建了 Spring MVC 的项⽬。

创建项⽬时，勾选上 Spring Web 模块即可，如下图所示：

3.3 建⽴连接

在 Spring MVC 中使⽤RequestMapping注解来实现 URL 路由映射，RequestMapping注解的作用就是浏览器连接程序，我们先来看看代码怎么写： 创建好一个 SpringBoot 项目后，再 main 路径下会有一个默认的 controller java 程序，实现了⽤⼾通过浏览器和程序的交互：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    //路由规则注解
    @ResponseBody
    public String hello(@RequestParam(name = "name", defaultValue = "unknown user") String name) {
        return "Hello " + name;
    }
    //......
}

上述的 @RequestMapping("/hello")中的 /hello 是一个子路径。

运行 main 路径下的主程序，再用浏览器搜索：127.0.0.1:8080/hello

大致流程如下：

3.3.1 RequestMapping 的路径使用

能够借助 @RequestMapping 注解为控制器类或者方法指定请求路径，进而让 Spring 知晓当接收到特定 URL 请求时该调用哪个方法。

RequestMapping的作用:

1. 放在方法上，修饰方法
2. 放在类上，修饰类

当我们在类上添加 RequestMapping后再按原来的路径搜索：

搜索结果：

添加类的路径：http://127.0.0.1:8080/basic/hello，再次搜索：

3.3.2 请求 RequestMapping 的方式

再浏览器中我们只能使用 GET 请求，想用更多的请求只能借助 Postman 工具。

使用 postman 进行测试后发现 RequestMapping 可以满足 Get、Post 等几乎所有请求。

怎么使用规定方式的请求呢？

在 RequestMapping 中使用 method 属性。

这时再用 postman 测试，发现只能 get 请求能拿到数据

3.4 请求

3.4.1 什么是路径请求？

访问不同的路径，就是发送不同的请求。在发送请求时，可能会带⼀些参数，所以学习 Spring 的请求，主要是学习如何传递参数到后端以及后端如何接收。

咱们主要是使⽤浏览器和 Postman 来模拟传递参数。

后端开发⼈员⽆需过度关注如何传递参数，了解即可，实际开发中以 Postman 测试为主。 ⽐如餐厅的厨师，不关注⽤⼾是在店⾥下单，还是外卖平台下单，或者⼩程序下单，只需要知道如何接收订单，根据订单做出对应的菜肴就可以了。

3.4.2 不传递参数

在上述的举例中如果没有传参设置的是默认值 @RequestParam(name = "name", defaultValue = "unknown user") String name

// http://127.0.0.1:8080/hello?name=
@RequestMapping("/hello")
@ResponseBody
public String hello(String name) {
    return "接受到的参数是：" + name;
}

如果不传递参数，name 的默认值为 unknown user

为了方便演示，设置以下的类和方法：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(String name) {
        return "接受到的参数是：" + name;
    }
}

引用类型不传参：搜索的路径为 127.0.0.1:8080/basic/hello

显然，不传参是默认传的是 null

如果我们把方法改成以下的类型的参数：

// http://127.0.0.1:8080/hello?name=
@RequestMapping("/hello")
@ResponseBody
public String hello(int age) {
    return "接受到的参数是：" + age;
}

搜索结果：

这是为什么呢？

答：int 是基本数据类型，基本数据类型是值类型，它们不能接受 null 值。像 byte、short、long、float、double、char、boolean 都是基本数据类型，都不能接受 null。

解决办法：

1. 可以将基本数据类型替换为对应的包装类，包装类可以接受 null 值

@GetMapping("/hello")
@ResponseBody
public String hello(Integer age) {
    if (age == null) {
        // 处理 age 为 null 的情况
        age = 0;
        // 或者其他默认值
    }
    // 处理逻辑
    return "接受到的参数是：" + age;
}

2. 使用 @RequestParam 的 defaultValue 属性为参数设置默认值。

@GetMapping("/hello")
@ResponseBody
public String hello(@RequestParam(value = "age", defaultValue = "0") int age) {
    // 处理逻辑
    return "接受到的参数是：" + age;
}

3.4.3 传递单个参数

引用类型接收单个参数，在 Spring MVC 中直接⽤⽅法中的参数就可以，⽐如以下代码：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(String name) {
        return "接受到的参数是：" + name;
    }
}

搜索地址：127.0.0.1:8080/basic/hello?name=zhangsan

解释：

3.4.4 传递 2 个参数

方法如下：

// http://127.0.0.1:8080/hello?name=
@RequestMapping("/hello")
@ResponseBody
public String hello(String name, Integer age) {
    return "接受到的 name 参数是：" + name + ",接受到的 age 参数是：" + age;
}

（1）搜索地址：127.0.0.1:8080/basic/hello?name=zhangsan

（2）搜索地址：127.0.0.1:8080/basic/hello?age=20

（3）搜索地址：127.0.0.1:8080/basic/hello?age=20&name=zhangsan

（4）搜索地址：127.0.0.1:8080/basic/hello?name=zhangsan&age=20

由（3）（4）可得，传参的顺序不影响接受参数。

3.4.5 传递对象

创建一个 User 类:

public class User {
    private String name;
    private Integer age;

    public String getName() {
        return name;
    }

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

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" + "name='" + name + '\'' + ", age=" + age + '}';
    }
}

在 BasicController 类中添加如下方法：

@RequestMapping("/save_user")
@ResponseBody
public String saveUser(User u) {
    return u.toString();
}

在浏览器中搜索：127.0.0.1:8080/basic/save_user?name=lisi&age=20

结果：

传递参数被包装成了 User 类型的对象。

3.4.6 传递一个数组

方法如下：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(String[] arrayName) {
        return "接收到的参数是：" + Arrays.toString(arrayName);
    }
}

在浏览器搜索：127.0.0.1:8080/basic/hello?arrayName=zhangsan,lisi,wangwu

当我们请求时，同一个参数赋值多个时，浏览器会帮我们封装为数组，然后传参。

运行后，在浏览器搜索：127.0.0.1:8080/basic/hello?arrayName=zhangsan&arrayName=lisi&arrayName=wangwu

当我们请求时，同一个参数有多个时，浏览器会帮我们封装为数组，然后传参。

3.4.7 传递一个集合

方法如下：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(List<String> listName) {
        return "接收到的参数 listName 是：" + listName.toString();
    }
}

在浏览器搜索：127.0.0.1:8080/basic/hello?listName=zhangsan,lisi,wangwu

结果：

这是什么原因呢？ 看一看程序运行的控制面板：

翻译：未找到接口 java.util.List 的主构造函数或单个唯一构造函数。 通俗一点：浏览器把传递的参数封装成了数组，列表接收不了数组类型的参数

解决办法 - 使用 @RequestParam 注解：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(@RequestParam List<String> listName) // @RequeatParam 注解
    {
        return "接收到的参数 listName 是：" + listName.toString();
    }
}

再次搜索：127.0.0.1:8080/basic/hello?listName=zhangsan,lisi,wangwu

再次搜索：127.0.0.1:8080/basic/hello?listName=zhangsan&listName=lisi&listName=wangwu

3.4.8 后端参数重命名

看如下代码：

// http://127.0.0.1:8080/hello?name=
@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam("name") String username) {
    return "接受到的 name 参数是：" + username;
}

浏览器搜索：127.0.0.1:8080/basic/hello?name=lisi

结果：

传参的是 name，为什么 username 也有值呢？

答：name 的值复制给了 username。

浏览器搜索：127.0.0.1:8080/basic/hello?username=lisi

结果：

不是传 username 的值了吗，为什么会报错呢？

看一看 RequestParam 的源码：

把 required 属性改为 false 后就可以使用 username 了

代码如下：

@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam(value = "name", required = false) String username) {
    return "接受到的 name 参数是：" + username;
}

浏览器搜索：127.0.0.1:8080/basic/hello?username=lisi

结果：

可以看到，username 自己得不到传的值，username 只能复制 user 的值。

如果进行了重命名，就必须要使用 @RequestParam 注解中的名字。