1. 请求

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

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

1.1 传递单个参数

        接收单个参数，在Spring MVC中直接使用方法中的参数就可以了，比如以下代码：

<code>package com.example.zxslzw2014_8_11;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

@RequestMapping("user")

public class UserController {

@RequestMapping("/test01")

public String test(String name) {

return "接收到的参数name：" + name;

}

}

         使用postman发起请求：

        收到响应：

        可以看到, 后端程序正确拿到了name参数的值. Spring MVC 会根据⽅法的参数名, 找到对应的参数, 赋值给⽅法 ；如果参数不⼀致, 是获取不到参数的；

1.1.1 基础类型

        基础类型参数正常传递，代码如下：

<code>package com.example.zxslzw2014_8_11;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

@RequestMapping("user")

public class UserController {

@RequestMapping("/test01")

public String test(int age) {

return "接收到的参数age：" + age;

}

}

        postman返回参数如下：

1、基础类型不传递参数；

        状态码是500，由此可见是服务器代码出现了问题，观察日志查看问题：

        错误显示int类型的参数age，虽然为可选的，但由于被声明为基本类型，而不能转换为空值，考虑将其声明为对应基本类型的包装类型。

2、传字符串 

        post请求如下：

        状态码为400，说明在客户端出现问题，同时错误显示是错误请求，我们同时查看服务器的错误日志：

        错误显示说明基本类型int不能转换为字符串；

1.1.2 包装类型

         包装类参数传递的代码如下：

<code>package com.example.zxslzw2014_8_11;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

@RequestMapping("user")

public class UserController {

@RequestMapping("/test01")

public String test(Integer age) {

return "接收到的参数age：" + age;

}

}

1、正常传递数字类型参数，结果如下：

2、传递参数为空时：

          和基本类型不同，并没有报错，而是显示出null；对于包装类型，如果不传对应参数，Spring接收到的数据则为null，所以企业开发中，对于参数可能为空的数据，建议使用包装类型。

 3、传递字符串

        报错结果如上面类似：

        综上所述：

        对于方法里参数可能为null的数据，建议使用包装类型；而对于传递对象时（后面会讲到），对象（类）里面可以不使用包装类型，如果无法进行区分，那就都使用包装类型好了。 

1.2 传递多个参数

         代码逻辑和接收单个参数一样。代码如下所示：

<code>package com.example.zxslzw2014_8_11;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

@RequestMapping("user")

public class UserController {

@RequestMapping("/test01")

public String test(String name,Integer age) {

return "接收到的参数name：" + name + " 接收到的参数age：" + age;

}

}

         Postman观察结果如下：

        传参的时候，填入query string 的参数位置顺序可以任意的，结果不受这个顺序影响。 但是如果要传很多个，3个，4个，5个.....，这样进行传参代码就会显得很丑，所以，就可以引入对象，下面的内容介绍传对象。

1.3 传递对象

        现在有Student类，代码如下：

<code>public class Student {

private String name;

private int age;

private int id;

public String getName() {return name;}

public int getAge() {return age;}

public int getId() {return id;}

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

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

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

@Override

public String toString() {

return "Student{" +

"name='" + name + '\'' +code>

", age=" + age +

", id=" + id +

'}';

}

}

         传递对象的代码：

@RequestMapping("test02")code>

public Object test3(Student student) {

return student.toString();

}

        Postman发送请求，结果如下：

1、传递正常的对象参数

2、不传递任何参数

 

        由此可知，不会报错，原因就是在对象（类）中，成员属性会自动初始化，使用基础类型，也会进行初始化，如果没有传递这个参数，不会报错；但如果直接在接口方法中声明，使用int类型，没传参就会报错，就像上面介绍基础类型报错的例子。

 1.4 后端参数重命名（后端参数映射）

        某些特殊的情况下，前端传递的参数key和我们后端接收的key可以不一致，比如前端传递了一个time给后端，但后端是使用createtime字段来接收的，这样就会出现参数接收不到的情况，如果我们想前端传过来的参数，后端接收的参数是重命名后的，就可以使用@RequestParam来重命名后端等待参数值。

        代码如下：

<code>@RequestMapping("test03")

public String getTime(@RequestParam(value = "time") String newTime) {

return "接收到的参数newTime：" + newTime;

}

        收到请求结果如下： 

         可以看到，Spring可以正确的把浏览器传递的参数time绑定到后端参数newTime上 

        接下俩试试前端传参的参数改成newTime，看看有没有问题，postman页面如下：

 

         错误码400，说明客户端这边的请求有问题，看看报错日志如下：

        错误信息显示：请求参数“time”不存在，说明访问这个方法，必须要有参数，而我们传的newtTime参数，在这里没有，所以就报错了；

        我们也可以设置该参数不是必须的，代码如下：

<code> @RequestMapping("test03")

public String getTime(@RequestParam(value = "time" ,required = false) String newTime) {

return "接收到的参数newTime：" + newTime;

}

        post请求返回的结果：

结论如下：

1、注解：@RequestParam 进行参数重命名时，请求参数只有和@RequestParam声明的名称一致，才能进行参数绑定和赋值。

2、注解：@RequestParam 默认访问此方法是必须要带参数的，也可以设置不再参数。

1.5 传递数组

        传递数组时，Spring MVC可以自动绑定数组参数的赋值，代码如下： 

<code> @RequestMapping("test04")

public String method(String[] str) {

return Arrays.toString(str);

}

         postman请求的返回结果：

1.5 传递集合

        集合参数，和数组类似，同一个请求参数名有多个，且需要使用@RequestParam注解绑定参数关系。

        默认情况下，请求中参数名相同的多个值，是封装到数组。如果要封装到集合，要使用@RequestParam绑定参数关系。

1.5.1 不加注解@RequestParam

        代码如下：

<code> @RequestMapping("test05")

public String method3(List<String> list) {

return "size:" + list.size() + ",list:" + list;

}

      可以看到，服务器这边报错了，看看日志：

        错误显示，说明传参的时候，出问题了，因为没有加注解@RequestParam，所以默认传的参数是数组，但接收的确实集合List，所以服务器这边代码就会报错。 

1.5.2 加注解@RequestParam

        代码如下：

<code>@RequestMapping("test05")

public String method3(@RequestParam List<String> list) {

return "size:" + list.size() + ",list:" + list;

}

        返回结果如下所示：

        因为加了注解@RequestParam后，客户端这边传的参数就不会是默认的数组了，而是List。

1.6 传递JSON数据 

1.6.1 JSON概念

        JSON：JavaScript Object Notation【JavaScript 对象表示法】

        简单来说：JSON就是一种数据格式，有自己的格式和语法，使用文本表示一个对象或数组的信息，因此JSON本质是字符串。主要负责在不同的语言中进行数据传递和交换。

        JSON于JavaScript的关系：

        二者没有关系，只是语法相似，js开发者能更快的上手而已；

1.6.2 JSON语法

        JSON是一个字符串，它的格式非常类似JavaScript对象字面量的格式，如下是一段JSON数据：

<code>{

"squadName": "Super hero squad",

"homeTown": "Metro City",

"formed": 2016,

"secretBase": "Super tower",

"active": true,

"members": [

{

"name": "Molecule Man",

"age": 29,

"secretIdentity": "Dan Jukes",

"powers": [

"Radiation resistance",

"Turning tiny",

"Radiationblast"

]

},

{

"name": "Madame Uppercut",

"age": 39,

"secretIdentity": "Jane Wilson",

"powers": [

"Million tonne punch",

"Damage resistance",

"Superhumanreflexes"

]

}

]

}

         也可以压缩表⽰；

1、JSON的语法

1、数据在键值对（Key / Value）中。

2、数据由逗号 " , " 分割。

3、对象用 " { } " 表示。

4、数组用 " [ ] " 表示。

5、值可以为对象，也可以为数组，数组中可以包含多个对象。

2、JSON的两种结构：

1、对象：大括号 " { } " 保存的对象是一个无序的 键值对 集合。一个对象以左括号 " { " 开始，右括号 " } " 结束。每个 "键" 后跟一个冒号 " : "，键值对使用逗号 " , " 分隔。

2、数组：中括号 " [ ] " 保存的数组是值（Value）的有序集合。一个数组以左中括号 " [ " 开始，右中括号 " ] "，值之间使用逗号 " , " 分隔。

         可以使用在线JSON格式化工具来进行校验和书写：在线JSON校验格式化工具（Be JSON）

 1.6.3 JSON字符串和Java对象互转

        JSON本质上是一个字符串，通过文本来存储和描述数据。

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

<code><dependency>

<groupId>com.fasterxml.jackson.core</groupId>

<artifactId>jackson-databind</artifactId>

<version>2.13.5</version>

</dependency>

        当前定义person类如下：

package com.example.zxslzw2014_8_11;

public class Person {

private int id;

private String name;

private String password;

public Person(){ };

public Person(int id, String name, String password) {

this.id = id;

this.name = name;

this.password = password;

};

@Override

public String toString() {

return "Person{" +

"id=" + id +

", name='" + name + '\'' +code>

", password='" + password + '\'' +code>

'}';

}

public int getId() {return id;}

public String getName() {return name;}

public String getPassword() {return password;}

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

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

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

}

         互转的代码如下：

        

package com.example.zxslzw2014_8_11;

import com.fasterxml.jackson.core.JsonProcessingException;

import com.fasterxml.jackson.databind.ObjectMapper;

public class JSONUtils {

private static ObjectMapper objectMapper = new ObjectMapper();

public static void main(String[] args) throws JsonProcessingException {

Person person = new Person(10, "shengmengyao", "123456");

//对象转为JSON字符串

String jsonStr = objectMapper.writeValueAsString(person);

System.out.println("JSON字符串为：" + jsonStr);

//JSON字符串转为对象

Person p = objectMapper.readValue(jsonStr, Person.class);

System.out.println("转换的对象为：" + person.toString());

}

}

        运行结果如下：

1.6.4 JSON优点

 1、简单易用：语法简单，易于理解和编写，可以快速地进行数据转换。

2、跨平台支持：JSON可以被多种编程语言解析和生成，可以在不同的平台和语言之间进行数据交换和传输。

3、轻量级：相较于XML格式，JSON数据格式更加轻量级，传输数据时占用的带宽较小，可以提高传输速度。

4、易于扩展：JSON的数据结构灵活，支持嵌套对象和数组等复杂的数据结构，便于扩展和使用。

5、安全性：JSON数据格式是一种纯文本格式，不包含可执行代码，不会执行恶意代码，因此具有较高的安全性。

        基于以上特点，JSON在Web应用程序中被广泛使用，如前后端数据交互、API接口数据传输等。

 1.6.5 传递JSON对象

        接收JSON对象，需要使用@RequestBody注解。

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

        后端代码如下：

<code>@RequestMapping("/test06")

public Object method1(@RequestBody Person person) {

return person.toString();

}

结果如下：

         如果后端代码去掉注解@RequestBody，代码如下：

<code> @RequestMapping("/test06")

public Object method1(Person person) {

return person.toString();

        结果如下：

        可以看到没有给person赋值成功；

1.7 获取URL中参数@PathVariable

        path variable：路径变量，和字面表达的意思一样，这个注解主要作用在请求URL路径上的数据绑定（默认传递参数写在URL上，Spring MVC就可以获取到）。

        后端代码如下所示：

        由上图所示，后端接受了url上的参数，并且返回；

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

        如果方法参数名称和需要绑定的URL的变量名称不一致时，需要给@PathVariable的属性赋值，如上述例子中的userName变量。

1.8 上传文件@RequestPart

        使用注解RequestPart，后端代码如下：

<code> @RequestMapping("test08")

public String getFile(@RequestPart("file") MultipartFile file) throws IOException {

//获取文件名称

String fileName = file.getOriginalFilename();

//文件上传到指定路径

file.transferTo(new File("C:\\Users\\缘客扫\\Desktop\\图集\\图集\\tmp" + file.getOriginalFilename()));

return "接收到的文件名称为: " + fileName;

}

postman观察结果如下：

2. 获取Cookie / Session 

        HTTP协议自身是属于 “无状态” 协议。“无状态” ：默认情况下，HTTP协议的客户端和服务器的这次通信，和下次通信之间没有直接的联系（也可以理解成 “无记忆”）；在计算机领域，我们认为 “无状态” 是好的，相反，“有状态” 就不好。

        但是实际开发中，很多时候是需要知道请求之间有关联的关系，例如我登录第三方网站，第一次登录成功后，后续的访问就不用继续输入账户密码，可以直接登录成功，所以这时候服务器就需要知道我之前是登录过了的。

2.1 初识Cookie

        Cookie本质是浏览器这边，本地化永久存储数据的机制，是一个身份标识，相当于令牌。客户端和服务器之间的登录请求交互，大概流程图如下：

        客户端这边有了Cookie这个 “令牌”，那服务器这边也就需要记录 这个 “令牌” 的信息；因为一个网站，会有很多客户，大型网站无时无刻都有很多请求访问过来，那么就会带有非常多的Cookie，这也就意味着，服务器这边也要对 这些 “令牌” 进行管理，这些工作也就是下面要介绍的 Session 来负责了。

2.2 了解Session

        了解Session之前，我们先谈谈会话（会话：对话的意思），现实中的会话如下图：

        

        在计算机领域中，会话是一个客户端与服务器的不中断的请求响应。对于服务器来说，客户端发来的请求，服务器能识别出请求来自同一个客户端。当一个未知的客户端向Web应用程序发送第一个请求，此时就开始了一个会话。当客户明确结束会话或者服务器在一个时限（时间阈值，Session默认的超时时间是30min，但这也是可以进行设置）没有接收到客户端发来的任何请求，此时会话就结束了

        服务器同⼀时刻收到的请求是很多的. 服务器需要清楚的区分每个请求是从属于哪个用户, 也就是属于 哪个会话, 就需要在服务器这边记录每个会话以及与用户的信息的对应关系. Session是服务器为了保存⽤⼾信息⽽创建的⼀个特殊的对象，其运行逻辑如下：

        Session的本质就是一个 “哈希表”，存储了一些键值对结构。Key就是SessionID，Value就是用户信息（用户信息可以根据需求灵活设计）。结构大概如下图：

         SessionId 是由服务器生成的一个 “唯一性字符串”，从Session机制的角度来看，这个唯一性字符串称为 “SessionId”。但是站在整个登录流程中看待，也可以把这个唯一性字符串称为：“token”。

        上述例子中的令牌ID，就可以看做是SessionId，只不过令牌除了 ID 之外，还会带一些其他信息，比如时间、签名等，sessionid的使用如下所示：

 1、当用户登录的时候，服务器在Session会新增一个新记录，并把SessionID，返回给客户端（通过HTTP响应中是Set-Cookie字段返回）。

2、客户端后续再给服务器发送请求的时候，需要在请求中带上SessionId（通过HTTP请求中的Cookie字段带上）。

3、服务器接收到请求后，根据请求中的SessionId，找到对应的Session中，获取到对应的用户信息，再进行后续的操作。如果找不到，就重新创建Session，再把SessionId返回给客户端。

        Session默认是保存在内存中的，如果重启服务器，Session数据就像消失

Cookie和Session的工作流程流程如下：

2.3 Cookie 和 Session 的区别 

1、Cookie是客户端保存用户信息的一种机制，Session是服务器保存用户信息的一种机制。

2、Cookie和Session之间是通过SessionId关联起来的（并没有什么直接关系），SessionId是Cookie和Session之间的桥梁。

3、Cookie和Session经常会搭配在一起使用，但不是必须搭配的。

        1）、完全可以用Cookie保存一些数据在客户端；这些数据并不一定是用户身份信息（SessionId）。

        2）、Session的SessionId也不是非得通过Cookie / Set-Cookie传递，也有其他方式，比如通过URL传递。

2.4 获取Cookie

2.4.1 传统获取Cookie

        代码如下：

<code>@RequestMapping("/get")

public String getCookie(HttpServletRequest request, HttpServletResponse response) {

//获取参数

//String name = request.getParameter("name");

//获取所有参数

Cookie[] cookies = request.getCookies();

//1、不使用lambda表达式

// StringBuilder stringBuilder = new StringBuilder();

// if (cookies != null) {

// for (Cookie ck : cookies) {

// stringBuilder.append(ck.getName() + ":" + ck.getValue());

// }

// }

//return "获取Cookie信息:" + stringBuilder;

//2、使用lambda表达式

if (cookies != null) {

Arrays.stream(cookies).forEach(ck -> System.out.println(ck.getName() + ":" + ck.getValue()));

}

return "获取Cookie";

}

        结果如下：

 因为没有设置Cookie，现在Cookie是null，控制台也不会打印Cookie；

        在应用程序里面手动添加cookie：

再次运行程序，如下图所示：

        从这个例⼦中, 也可以看出Cookie是可以伪造的, 也就是不安全的, 所以使⽤Cookie时, 后端需要进⾏ Cookie校验

        也可以使用Postman设置Cookie，如图：

        运行程序结果如下：

1、Spring MVC是基于Servlet API构建的原始Web框架，也是在Servlet的基础上实现的，HttpServletRequest、HttpServletResponse 是Servlet提供的两个类，是Spring MVC方法的内置对象。需要时直接在方法中添加声明即可（例如注解@CookieValue，下面会介绍）。

2、HttpServletRequest 对象代表客户端的请求。当客户端通过HTTP协议访问服务器时，HTTP请求头的所有信息都封装在这个对象中，通过这个对象提供的方法，可以获取到客户端请求的所有信息。

3、HttpServletResponse 对象代表服务器的响应。HTTP响应的信息都在这个对象中，比如向客户端发送的数据、响应头、状态码等等。通过这个对象提供的方法，可以获得服务器响应的所有内容。

        Spring MVC在这两个对象的基础上进行了封装，给我们提供了更简单的使用方法（使用注解）。下面介绍简洁获取Cookie的使用方法。 

2.4.2 简洁获取Cookie

        后端代码如下：

<code>@RequestMapping("/get2")

public String getCookie2(@CookieValue("name") String newName) {

return "从Cookie中获取值，name:" + newName;

结果如下：

2.5 获取session 

2.5.1 Session 存储

        因为Session是服务器这边存储的信息，所以要获取到到Session前要先有它。Session也是基于HttpServletRequest来存储和获取的，下面是存储Session的后端代码：

<code>@RequestMapping("/set")

public String setSess(HttpServletRequest request) {

//从Cookie中获取到SessionId，根据SessionId获取Session对象，如果没有，就会创建一个

HttpSession session = request.getSession();

session.setAttribute("name", "yuanyiqi");

return "设置Session成功";

}

         这个代码中虽然看不到SessionId这样的概念，但是getSession操作内部会提取到请求中的Cookie的SessionId，然后根据SessionId获取到对应的Session对象，Session对象用HttpSession来描述。如图： 

 运行代码后浏览器页面如下：

        可以看到我们的cookie多了一个；

下面来看我们的postman界面：

 

        也是多了一个，和浏览器一样的Cookie。

2.5.2 传统获取Session

        获取Session有两种方式，getSession的不同参数有两种情况，如下两种：

HttpSession getSession(boolean create);

HttpSession getSession();

        HttpSession getSession(boolean create)，参数如果为true，则当不存在会话是，会新建会话；参数如果不为false，则当不存在会话时，返回null，不新建会话。

        后端代码如下：

<code> @RequestMapping("getses1")

public String getsSess(HttpServletRequest request) {

//从cookie中获取到了sessionID, 根据sessionID获取Session对象取Session对象,如果session不存在，不会自动创建

HttpSession session = request.getSession(false);

String userName = (String) session.getAttribute("name");

return "name: " + userName;

}

         Object getAttribute(String name)：返回该session会话中具有指定名称的对象，如果没有指定名称的对象，则返回 null。前面我们已经存储了Session：session.setAttribute("name", "yuanyiqi");   

        现在获取一下session，浏览器访问：http:127.0.0.1:8080/user/getses1 ，页面如下：

        注意：因为session是存储在内存中的，一般来说重启一次程序就会刷新，所以我们在进行查找session之前尽量在设置一次session；

         可以看到，客户端发送HTTP请求时，SessionId通过Cookie传递给了服务器。这里如果我们修改一下Cookie的值，就会拿不到了，如图：

        因为修改了Cookie，也就是伪造的，Cookie里的SessionId也就会改变，但服务器这边没有这个对应的SessionId，就拿不到Session了。

2.5.3 简洁获取 Session(1)

        后端代码如下：

<code>@RequestMapping("getses2")

public String getSess2(HttpSession session) {

String name = (String)session.getAttribute("name");

return "从Session中获取name: " + name;

}

        结果如下：

2.5.4 简洁获取 Session(2) 

        代码如下：

<code>@RequestMapping("getses3")

public String getSess3(@SessionAttribute("name") String name) {

return "从Session中获取name: " + name;

}

        结果与之前一样；

        上面三个代码，分别进行一步步地简化，特别是第三个代码使用注解，大大的减少了代码的行数，提高了使用效率；

3. 获取Header

3.1 传统获取Header

        后端代码如下：

@RequestMapping("getHeader1")

public String getHeader1(HttpServletRequest request) {

String userAgent = request.getHeader("User-Agent");

return "从Header获取信息，userAgent:" + userAgent;

}

        浏览器页面如下：

 3.2 简洁获取Header

        后端代码如下：

<code>@RequestMapping("getHeader2")

public String getHeader2(@RequestHeader("User-Agent") String userAgent) {

return "从Header获取信息，userAgent:" + userAgent;

}

        浏览器页面如下：

ps：本次的内容就到这里了，如果对你有所帮助的话，就请一键三连哦！！！

本文的封面来自：bilibili苏杉杉的pv，侵权删 url：https://www.bilibili.com/video/BV1vo4y167eh/?spm_id_from=333.999.0.0&vd_source=866da5be2ef0ddd213b053523da53138

————————————————

电子签名：上嘉路