从 0 到 1 认识 Spring MVC：核心思想与基本用法（下）

文章目录

- 📕4. 响应
- - - ✏️4.1 返回静态页面
    - ✏️4.2 返回数据@ResponseBody
    - ✏️4.3 返回HTML代码片段
    - ✏️4.4 返回JSON
    - ✏️4.5 设置状态码
    - ✏️4.6 设置Header（了解）
- 📕5. 案例练习
- - - ✏️5.1 加法计算器
    - ✏️5.2 用户登录
    - ✏️5.3 留言板
- 📕6. lombok介绍
- 📕7. 应用分层
- - - ✏️7.1 使用三层架构进行分层
    - ✏️7.2 应用分层的好处

上接：从 0 到 1 认识 Spring MVC：核心思想与基本用法（上）

📕4. 响应

在我们前面的代码例子中，都已经设置了响应数据，Http响应结果可以是数据，也可以是静态页面，也可以针对响应设置状态码，Header信息等。

✏️4.1 返回静态页面

创建前端页面 index.html(注意路径)
在这里插入图片描述

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Index页面</title>
</head>
<body>Hello,Spring MVC,我是Index页面.
</body>
</html>

@RestController
public class indexController(){@RequestMapping("/index")public String index(){return "/index.html";}
}

在这里插入图片描述
结果却发现, 页面未正确返回, http响应把"/index.html" 当做了http响应正文的数据那Spring MVC如何才能识别出来 index.html 是一个静态页面, 并进行返回呢?

我们需要把 @RestController 改为 @Controller

@RestController 和 @Controller 有着什么样的关联和区别呢?

之前我们介绍了MVC模式，后端会返回视图，这是早期时的概念。随着互联网的发展，目前项目开发流行"前后端分离"模式， Java主要是用来做后端项目的开发，所以也就不再处理前端相关的内容了。MVC的概念也逐渐发生了变化，View不再返回视图，而是返回显示视图时需要的数据。如果想返回视图的话, 只需要把@ResponseBody 去掉就可以了, 也就是@Controller

所以前面使用的@RestController 其实是返回的数据. @RestController = @Controller + @ResponseBody
@Controller : 定义一个控制器, Spring 框架启动时加载, 把这个对象交给Spring管理.
@ResponseBody : 定义返回的数据格式为非视图, 返回一个 text/html 信息

✏️4.2 返回数据@ResponseBody

@Controller
@ResponseBody
public class indexController(){@RequestMapping("/index")public String index(){return "/index.html";}
}

加上@ResponseBody 注解, 该方法就会把 “/index.html” 当做一个数据返回给前端.

在这里插入图片描述

@ResponseBody 既是类注解，又是方法注解。
如果作用在类上，表示该类的所有方法，返回的都是数据，如果作用在方法上，表示该方法返回的是数据。也就是说: 在类上添加@ResponseBody 就相当于在所有的方法上添加了@ResponseBody 注解。同样，如果类上有@RestController 注解时 : 表示所有的方法上添加了@ResponseBody 注解，也就是当前类下所有的方法返回值做为响应数据。

✏️4.3 返回HTML代码片段

后端返回数据时, 如果数据中有HTML代码, 也会被浏览器解析

@RestMapping("/return/html")
@ReponseBody
public class returnHtml(){public String return(){return "<h1>Hello,HTML~<h1>";}
}

在这里插入图片描述
通过Fiddler观察响应结果, Content-Type 为text/html

响应中的 Content-Type 常见取值有以下几种:

text/html : body 数据格式是 HTML
text/css : body 数据格式是 CSS
application/javascript : body 数据格式是 JavaScript
application/json : body 数据格式是 JSON

✏️4.4 返回JSON

Spring MVC 也可以返回JSON，后端方法返回结果为对象。

@RequestMapping("/m11")public Map<String,String> m11(){Map<String,String> hash = new HashMap<>();hash.put("name","zhuxulong");hash.put("name1","lijiufang");return hash;}

在这里插入图片描述
通过Fiddler观察响应结果, Content-Type 为 application/json

✏️4.5 设置状态码

Spring MVC会根据我们方法的返回结果自动设置响应状态码, 程序员也可以手动指定状态码。通过Spring MVC的内置对象HttpServletResponse 提供的方法来进行设置。

@RequestMapping("/m12")public String m12(HttpServletResponse response){response.setStatus(401);return "yes";}

状态码不影响页面的展示
我们通过Proxyman来抓包发现状态码是401

✏️4.6 设置Header（了解）

Http响应报头也会向客户端传递一些附加信息，比如服务程序的名称，请求的资源已移动到新地址等，如: Content-Type，Local等。这些信息通过@RequestMapping 注解的属性来实现。

设置Content-Type

 @RequestMapping(value = "/m13",produces = "application/json")public String m13(){return "{\"success\":true}";}

如果不设置produces , 方法返回结果为String时, Spring MVC默认返回类型, 是text/html.

设置其他Header

设置其他Header的话, 需要使用Spring MVC的内置对象HttpServletResponse 提供的方法来进行设置

@RequestMapping(value = "/m14")public String m14(HttpServletResponse response){response.setHeader("myHeader","hahaha");return "yes";}

void setHeader(String name, String value) 设置一个带有给定的名称和值的 header. 如果 name 已经存在, 则覆盖旧的值.

在这里插入图片描述
通过Proxyman来查看我们设置的结果

📕5. 案例练习

✏️5.1 加法计算器

需求

输入两个整数, 点击"点击相加"按钮, 显示计算结果

定义接口

请求路径 : calc/sum
请求方式 : GET/POST
接口描述 : 计算两个整数相加

请求参数

参数名	类型	是否必须	备注
num1	Integer	是	参与计算的第一个数
num2	Integer	是	参与计算的第二个数

响应数据

Content-Type : text/html
响应内容 : 计算机计算结果:

前端代码

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title>
</head>
<body>
<form action="calc/sum" method="post"><h1>计算器</h1>数字1：<input name="num1" type="text"><br>数字2：<input name="num2" type="text"><br><input type="submit" value=" 点击相加 ">
</form>
</body></html>

后端代码

package xulong.com;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/calc")
public class CalcController {@RequestMapping("/sum")public String add(Integer num1,Integer num2){if(num1==null||num2==null){return "输入不合法";}return "计算机计算结果:"+(num1+num2);}
}

✏️5.2 用户登录

1.校验接口
需求

用户输入账号和密码, 后端进行校验密码是否正确

如果不正确, 前端进行用户告知
如果正确, 跳转到首页. 首页显示当前登录用户
后续再访问首页, 可以获取到登录用户信息

定义接口

请求路径 : /user/login
请求方式 : POST
接口描述 : 校验账号密码是否正确

请求参数

参数名	类型	是否必须	备注
userName	String	是	校验的账号
password	String	是	校验的密码

响应数据

Content-Type : text/html
响应内容 : true //账号密码验证成功 false//账号密码验证失败

2.查询接口

定义接口

请求路径 : /user/getLoginUser
请求方式 : GET
接口描述 : 查询当前登录的用户

响应数据

Content-Type : text/html
响应内容 : zhangsan

===================================================================================

后端代码

package xulong.com.Login;import jakarta.servlet.http.HttpSession;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/user")
public class LoginController {@RequestMapping("/login")public boolean login(String userName, String password, HttpSession session ){if(!StringUtils.hasLength(userName) || !StringUtils.hasLength(password)){return false;}if("zhangsan".equals(userName)&&"123456".equals(password)){session.setAttribute("username",userName);return true;}return false;}@RequestMapping("/getLoginUser")public String getLoginUser(HttpSession session){String username = (String)session.getAttribute("username");if(StringUtils.hasLength(username)) {return username;}return "";}}

前端代码

<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"><title>登录页面</title>
</head><body><h1>用户登录</h1>用户名：<input name="userName" type="text" id="userName"><br>密码：<input name="password" type="password" id="password"><br><input type="button" value="登录" onclick="login()"><script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.4/jquery.min.js"></script><script>function login() {$.ajax({type: "post",url: "/user/login",data: {"userName": $("#userName").val(),"password": $("#password").val()},success: function (result) {if (result) {location.href = "/index.html"} else {alert("账号或密码有误.");}}});}</script>
</body></html>

✏️5.3 留言板

需求

输入留言信息, 点击提交. 后端把数据存储起来.
页面展示输入的表白墙的信息

接口定义

获取全部留言
请求:GET /message/getList
响应: JSON 格式
浏览器给服务器发送一个 GET /message/getList 这样的请求, 就能返回当前一共有哪些留言记录. 结果以 json 的格式返回过来.

发表新留言
请求: body 也为 JSON 格式.
响应: JSON 格式.
我们期望浏览器给服务器发送一个 POST /message/publish 这样的请求, 就能把当前的留言提交给服务器.

前端代码

<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>留言板</title><style>.container {width: 350px;height: 300px;margin: 0 auto;/* border: 1px black solid; */text-align: center;}.grey {color: grey;}.container .row {width: 350px;height: 40px;display: flex;justify-content: space-between;align-items: center;}.container .row input {width: 260px;height: 30px;}#submit {width: 350px;height: 40px;background-color: orange;color: white;border: none;margin: 10px;border-radius: 5px;font-size: 20px;}</style>
</head><body><div class="container"><h1>留言板</h1><p class="grey">输入后点击提交, 会将信息显示下方空白处</p><div class="row"><span>谁:</span> <input type="text" name="" id="from"></div><div class="row"><span>对谁:</span> <input type="text" name="" id="to"></div><div class="row"><span>说什么:</span> <input type="text" name="" id="say"></div><input type="button" value="提交" id="submit" onclick="submit()"><!-- <div>A 对 B 说: hello</div> --></div><script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.4/jquery.min.js"></script><script>load();function load() {$.ajax({type: "get",url: "/message/getList",success: function (result) {for (var message of result) {var divE = "<div>" + message.from + "对" + message.to + "说:" +message.message + "</div>";$(".container").append(divE);}}});}function submit() {//1. 获取留⾔的内容var from = $('#from').val();var to = $('#to').val();var say = $('#say').val();if (from == '' || to == '' || say == '') {return;}$.ajax({type: "post",url: "/message/publish",data: {from: from,to: to,message: say},success: function (result) {if (result) {//2. 构造节点var divE = "<div>" + from + "对" + to + "说:" + say + "</div>";//3. 把节点添加到⻚⾯上$(".container").append(divE);//4. 清空输⼊框的值$('#from').val("");$('#to').val("");$('#say').val("");} else {alert("发表留⾔失败!");}}});}</script>
</body></html>

后端代码

package xulong.com.Message;import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping("/message")
public class MessageController {List<MessageInfo> list = new ArrayList<>();@RequestMapping("/getList")public List<MessageInfo> getList(){return list;}@RequestMapping("/publish")public boolean punish(@RequestBody MessageInfo messageInfos){if(StringUtils.hasLength(messageInfos.getFrom())&&StringUtils.hasLength(messageInfos.getTo())&&StringUtils.hasLength(messageInfos.getMessage())){list.add(messageInfos);return true;}return false;}
}

📕6. lombok介绍

Lombok是一个Java工具库,通过添加注解的方式,简化Java的开发.

引入依赖

<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional>
</dependency>

使用

lombok通过一些注解的方式, 可以帮助我们消除一些冗长代码, 使代码看起来简洁一些
比如之前的Person对象就可以改为

@Data
public class Person {private int id;private String name;private String password;
}

@Data 注解会帮助我们自动一些方法, 包含getter/setter, equals, toString等

更多使用

如果觉得@Data比较粗暴(生成方法太多), lombok也提供了一些更精细粒度的注解

注解	作用
@Getter	自动添加 getter 方法
@Setter	自动添加 setter 方法
@ToString	自动添加 toString 方法
@EqualsAndHashCode	自动添加 equals 和 hashCode 方法
@NoArgsConstructor	自动添加无参构造方法
@AllArgsConstructor	自动添加全属性构造方法,顺序按照属性的定义顺序
@NonNull	属性不能为 null
@RequiredArgsConstructor	自动添加必需属性的构造方法,final + @NonNull 的属性为必需

@Data = @Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor + @NoArgsConstructor 

📕7. 应用分层

通过上面的练习，我们学习了Spring MVC简单功能的开发，但是我们也发现了一些问题，目前我们程序的代码有点"杂乱"，然而当前只是"一点点功能"的开发。如果我们把整个项目功能完成呢? 代码会更加的"杂乱无章"(文件乱, 代码内容乱)。也基于此, 咱们接下来学习应用分层.

为什么需要应用分层?

在最开始的时候，为了让项目快速上线，我们通常是不考虑分层的。但是随着业务越来越复杂，大量的代码混在一起，会出现逻辑不清晰､各模块相互依赖､代码扩展性差､改动一处就牵一发而动全身等问题。所以学习对项目进行分层就是我们程序员的必修课了。

类似公司的组织架构
公司初创阶段, 一个人身兼数职, 既做财务, 又做人事, 还有行政.
随着公司的逐渐壮大, 会把岗位进行细分, 划分为财务部门, 人事部门, 行政部门等. 各个部门内部还会再进行细分.
项目开发也是类似, 最开始功能简单时, 我们前后端放在一起开发, 随着项目功能的复杂, 我们分为前端和后端不同的团队, 甚至更细粒度的团队. 后端开发也会根据功能再进行细分. MVC就是其中的一种拆分方式.
但是随着后端人员不再涉及前端, 后端开发又有了新的分层方式.