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.ModelAttribute;
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) // @RequestParam 注解
    {
        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 注解中的名字。