SpringBootWeb（接收请求数据，返回响应结果，分层解耦，Spring的IOCDI）【详解】

一、接收请求数据

1. 接收表单参数

1.原始方式【了解】

2.SpringBoot方式

3.参数名不一致@RequestParam

2.实体参数

1.简单实体对象

2.复杂实体对象

3.数组集合参数

4.日期参数

3. JSON参数

1.Postman发送JSON数据

2.服务端接收JSON数据

4. 路径参数(rest风格)

二、返回响应结果

1. @ResponseBody

2. 统一响应结果

1.响应结果不规范的问题

2.如何统一返回结果

三、分层解耦

1. 三层架构

2. 分层解耦

四、Spring的IOC&DI

1. IoC和DI介绍

2. IOC&DI入门

3. IOC详解

1.bean的声明

2.bean的名称

4.DI详解

一、接收请求数据

接收HTTP请求的数据，主要是接收客户端提交过来的各种参数。而分析HTTP请求的格式，需要接收的数据主要有：

表单参数。客户端在请求行或者请求体里提交的表单参数，格式：参数名=值&参数名=值&...

如果是GET或DELETE请求，表单参数在请求行里提交过来

如果是POST或PUT请求，表单参数在请求体里提交过来
JSON参数。客户端使用axios的post和put方法可以提交json参数，格式：{"key1":value1, "key2":value2}
路径参数。直接在请求路径里携带参数，例如 GET http://locahost:8080/emp/1，其中的1就是路径参数

表示要查询id为1的员工信息

1. 接收表单参数

简单参数：在向服务器发起请求时，向服务器传递的是一些普通的请求数据。

postman工具我上一篇文章有介绍使用（下面是postman工具的页面）

postman工具可以发送不同方式的请求,浏览器只能发送get请求（所以用这个工具测试）

1.原始方式【了解】

通过Servlet中提供的API：HttpServletRequest请求对象来获取请求信息。它提供了获取表单参数的API：

String value = HttpServletRequest对象.getParameter("参数名")

用法

在Controller的方法中，直接增加HttpServletRequest类型的形参
然后在方法里就可以通过该对象来获取请求参数了

@RestController
public class RequestController {//原始方式@RequestMapping("/simpleParam")public String simpleParam(HttpServletRequest request){// http://localhost:8080/simpleParam?name=Tom&age=10// 请求参数： name=Tom&age=10   （有2个请求参数）// 第1个请求参数： name=Tom   参数名:name，参数值:Tom// 第2个请求参数： age=10     参数名:age , 参数值:10String name = request.getParameter("name");//name就是请求参数名String ageStr = request.getParameter("age");//age就是请求参数名int age = Integer.parseInt(ageStr);//需要手动进行类型转换System.out.println(name+"  :  "+age);return "OK";}
}

2.SpringBoot方式

Springboot的环境中，对原始的API进行了封装，接收参数的形式更加简单。

用法

给Controller里的方法添加形参，一个形参用于接收一个表单参数
要求：方法的形参名和表单参数名相同

@RestController
public class RequestController {// http://localhost:8080/simpleParam?name=Tom&age=10// 第1个请求参数： name=Tom   参数名:name，参数值:Tom// 第2个请求参数： age=10     参数名:age , 参数值:10//springboot方式@RequestMapping("/simpleParam")public String simpleParam(String name , Integer age ){//形参名和请求参数名保持一致System.out.println(name+"  :  "+age);return "OK";}
}

postman测试( GET 请求)：

postman测试( POST请求 )：

3.参数名不一致`@RequestParam`

如果方法形参名称与请求参数名称不一致，controller就接收不到参数值了

用法

在方法形参前面加上 @RequestParam("表单参数名")
注解的属性说明：
- value：用于配置表单参数名。表示要接收哪个表单参数
- required：设置为true的话，表示要求客户端必须传这个参数，否则会报错

@RestController
public class RequestController {// http://localhost:8080/simpleParam?name=Tom&age=20// 请求参数名：name//springboot方式@RequestMapping("/simpleParam")public String simpleParam(@RequestParam("name") String username , Integer age ){System.out.println(username+"  :  "+age);return "OK";}
}

@RequestMapping("/simpleParam")
public String simpleParam(@RequestParam(name = "name", required = false) String username, Integer age){
System.out.println(username+ ":" + age);
return "OK";
}

2.实体参数

1.简单实体对象

如果请求参数比较多，就需要写大量的方法形参，非常繁琐。

SpringBoot允许我们将多个请求参数封装到一个实体类对象中。

用法

给Controller里方法上添加JavaBean形参
要求：请求参数名与实体类的属性名相同

/**
User类
*/
public class User {private String name;private Integer age;//get和set方法 略//toString方法 略
}---------------------
/**
Controller方法
*/
@RestController
public class RequestController {//实体参数：简单实体对象@RequestMapping("/simplePojo")public String simplePojo(User user){System.out.println(user);return "OK";}
}

Postman测试：

参数名和实体类属性名一致时才会正确，不然会变成null

2.复杂实体对象

复杂实体对象指的是，在实体类中有一个或多个属性，也是实体对象类型的。例如User类中有一个Address属性（Address也是一个实体类）

用法

在Controller里方法中直接添加实体类形参
要求：请求参数名与形参对象属性名相同，按照对象层次结构关系即可接收嵌套实体类属性参数。

/**
Address实体类
*/
public class Address {private String province;private String city;//get和set方法 略//toString方法 略
}---------------
/**
User实体类
*/
public class User {private String name;private Integer age;private Address address; //地址对象//get和set方法 略//toString方法 略
}--------------
/**
Controller方法
*/
@RestController
public class RequestController {//实体参数：复杂实体对象@RequestMapping("/complexPojo")public String complexPojo(User user){System.out.println(user);return "OK";}
}

Postman测试

3.数组集合参数

数组集合参数的使用场景：在HTML的表单中，有一个表单项是支持多选的(复选框)，可以提交选择的多个值。

1.接收成数组

用法

在Controller的方法上直接添加数组形参
要求表单参数名与形参名称相同

@RestController
public class RequestController {//数组集合参数@RequestMapping("/arrayParam")public String arrayParam(String[] hobby){System.out.println(Arrays.toString(hobby));return "OK";}
}

Postman测试：

在前端请求时，有两种传递形式：

2.接收成集合

用法

在Controller里方法上直接添加集合形参
要求表单参数名与形参名相同
给形参添加@RequestParam注解

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

@RestController
public class RequestController {//数组集合参数@RequestMapping("/listParam")//加@RequestParam,不加就会当成 (new 对象) 找属性值，所以会报错public String listParam(@RequestParam List<String> hobby){System.out.println(hobby);return "OK";}
}

和数组一样的两种请求方式

4.日期参数

因为日期的格式多种多样（如：2022-12-12 10:05:45 、2022/12/12 10:05:45），通过@DateTimeFormat注解，以及其pattern属性来设置日期的格式。

用法

在日期类型(Date,LocalDate,LocalDateTime)的参数/属性上，添加注解@DateTimeFormat(pattern="日期格式")
客户端提交的日期格式，和注解里指定的日期格式必须是匹配的

@RestController
public class RequestController {//日期时间参数@RequestMapping("/dateParam")public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){System.out.println(updateTime);return "OK";}
}

3. JSON参数

客户端在提交参数时，也会经常使用JSON格式。例如：

axios.post("url地址", {"name":"tom", "age":20})
axios.put("url地址", {"name":"tom", "age":20})

1.Postman发送JSON数据

2.服务端接收JSON数据

做法

Controller的方法中，要求使用实体类封装参数，所以要添加一个实体类形参
实体类要求：JSON的键名与实体类属性名相同
在方法的形参实体类上加@RequestBody注解

/**
Address类
*/
public class Address {private String province;private String city;//get和set方法 略//toString方法 略
}----------------
/**
User类
*/
public class User {private String name;private Integer age;private Address address;//get和set方法 略//toString方法 略
} ----------------
/**
Controller方法
*/
@RestController
public class RequestController {//JSON参数@RequestMapping("/jsonParam")public String jsonParam(@RequestBody User user){System.out.println(user);return "OK";}
}

4. 路径参数(rest风格)

直接在请求的URL中传递参数，这样的参数称为“路径参数”或“路径变量”。例如：

GET http://localhost:8080/user/1 其中的1是提交的参数

做法

前端：通过请求URL直接传递参数
后端：
- 在Controller的方法上标识请求路径时，使用{…}占位符来匹配路径参数；有几个参数，就写几个占位符
- 有几个路径参数要接收，就在Controller的方法上添加几个形参，每个形参加@PathVariable("占位符名")获取路径参

@RestController
public class RequestController {//路径参数@RequestMapping("/path/{id}")public String pathParam(@PathVariable Integer id){System.out.println(id);return "OK";}
}

postman测试

多参数实例：

@RestController
public class RequestController {//路径参数@RequestMapping("/path/{id}/{name}")public String pathParam2(@PathVariable Integer id, @PathVariable String name){System.out.println(id+ " : " +name);return "OK";}
}

二、返回响应结果

1. `@ResponseBody`

@ResponseBody注解用于加在Controller类上，也可以加在方法上。它的作用是：

将方法返回值直接响应给浏览器

如果返回值类型是实体对象/集合，将会转换为JSON格式，然后再响应给浏览器

SpringBootWeb提供了一个 @RestController，加在Controller类上。这一个注解相当于@Controller + @ResponseBody

@Controller：加在Controller类上，SpringBoot才会扫描、识别这个类，才能被客户端访问到
@ResponseBody：加在Controller类上，相当于类里所有方法都加了@ResponseBody

所以，只要Controller类上加了@RestController，我们就不用关心响应结果的注解了

@RestController源码：

@Target({ElementType.TYPE})   //元注解（修饰注解的注解）
@Retention(RetentionPolicy.RUNTIME)  //元注解
@Documented    //元注解
@Controller   
@ResponseBody 
public @interface RestController {@AliasFor(annotation = Controller.class)String value() default "";
}

案例：

@RestController
public class ResponseController {//响应字符串@RequestMapping("/hello")public String hello(){System.out.println("Hello World ~");return "Hello World ~";}//响应实体对象@RequestMapping("/getAddr")public Address getAddr(){Address addr = new Address();//创建实体类对象addr.setProvince("广东");addr.setCity("深圳");return addr;}//响应集合数据@RequestMapping("/listAddr")public List<Address> listAddr(){List<Address> list = new ArrayList<>();//集合对象Address addr = new Address();addr.setProvince("广东");addr.setCity("深圳");Address addr2 = new Address();addr2.setProvince("陕西");addr2.setCity("西安");list.add(addr);list.add(addr2);return list;}
}

2. 统一响应结果

1.响应结果不规范的问题

在我们前面所编写的这些Controller方法中，返回值各种各样，没有任何的规范。如果我们开发一个大型项目，项目中controller方法将成千上万，使用这种方式将造成整个项目难以维护。

2.如何统一返回结果

在真实的项目开发中，无论是哪种方法，我们都会定义一个统一的返回结果。前端只需要按照统一格式的返回结果进行解析(仅一种解析方案)，就可以拿到数据

统一的返回结果使用类来描述，在这个结果中包含：(重点)

响应状态码：当前请求是成功，还是失败
状态码信息：给页面的提示信息
返回的数据：给前端响应的数据（字符串、对象、集合）

/**
实体类
*/
public class Result {private Integer code;//自定义的状态码，1 代表成功; 0 代表失败private String msg;  //响应码 描述字符串private Object data; //返回的数据public Result() { }public Result(Integer code, String msg, Object data) {this.code = code;this.msg = msg;this.data = data;}//get和set方法 略//增删改 成功响应(不需要给前端返回数据)public static Result success(){return new Result(1,"success",null);}//查询 成功响应(把查询结果做为返回数据响应给前端)public static Result success(Object data){return new Result(1,"success",data);}//失败响应public static Result error(String msg){return new Result(0,msg,null);}
}-----------------
/**
Controller类
*/
@RestController
public class ResponseController { //响应统一格式的结果@RequestMapping("/hello")public Result hello(){System.out.println("Hello World ~");//return new Result(1,"success","Hello World ~");return Result.success("Hello World ~");}//响应统一格式的结果@RequestMapping("/getAddr")public Result getAddr(){Address addr = new Address();addr.setProvince("广东");addr.setCity("深圳");return Result.success(addr);}//响应统一格式的结果@RequestMapping("/listAddr")public Result listAddr(){List<Address> list = new ArrayList<>();Address addr = new Address();addr.setProvince("广东");addr.setCity("深圳");Address addr2 = new Address();addr2.setProvince("陕西");addr2.setCity("西安");list.add(addr);list.add(addr2);return Result.success(list);}
}

三、分层解耦

1. 三层架构

从组成上看可以分为三个部分：

数据访问：负责业务数据的维护操作，包括增、删、改、查等操作。
逻辑处理：负责业务逻辑处理的代码。
请求处理、响应数据：负责，接收页面的请求，给页面响应数据。

按照上述的三个组成部分，在我们项目开发中呢，可以将代码分为三层：

Controller：控制层。接收前端发送的请求，对请求进行处理，并响应数据。
Service：业务逻辑层。处理具体的业务逻辑。
Dao：数据访问层(Data Access Object)，也称为持久层。负责数据访问操作，包括数据的增、删、改、查。

基于三层架构的程序执行流程：

前端发起的请求，由Controller层接收（Controller响应数据给前端）
Controller层调用Service层来进行逻辑处理（Service层处理完后，把处理结果返回给Controller层）
Serivce层调用Dao层（逻辑处理过程中需要用到的一些数据要从Dao层获取）
Dao层操作文件中的数据（Dao拿到的数据会返回给Service层）

三层架构的好处：

复用性强
便于维护
利用扩展

2. 分层解耦

内聚：软件中各个功能模块内部的功能联系。（就是模块之间都可以调用）
耦合：衡量软件中各个层/模块之间的依赖、关联的程度。（功能和模块都写在一块）

软件设计原则：高内聚低耦合。

高内聚指的是：一个模块中各个元素之间的联系的紧密程度，如果各个元素(语句、程序段)之间的联系程度越高，则内聚性越高，即 "高内聚"。

低耦合指的是：软件中各个层、模块之间的依赖关联程序越低越好

四、Spring的IOC&DI

1. IoC和DI介绍

控制反转： Inversion Of Control，简称IOC。对象的创建控制权由程序自身转移到外部（容器），这种思想称为控制反转。

对象的创建权由程序员主动创建转移到容器(由容器创建、管理对象)。这个容器称为：IOC容器或Spring容器

依赖注入： Dependency Injection，简称DI。容器为应用程序提供运行时，所依赖的资源，称之为依赖注入。

程序运行时需要某个资源，此时容器就为其提供这个资源。

例：EmpController程序运行时需要EmpService对象，Spring容器就为其提供并注入EmpService对象

IOC容器中创建、管理的对象，称之为：bean对象

2. IOC&DI入门

删除Controller层、Service层中new对象的代码
Service层及Dao层的实现类，交给IOC容器管理
为Controller及Service注入运行时依赖的对象
- Controller程序中注入依赖的Service层对象
- Service程序中注入依赖的Dao层对象

代码：

/**
Controller层
*/
@RestController
public class EmpController {@Autowired //运行时,从IOC容器中获取该类型对象,赋值给该变量private EmpService empService ;@RequestMapping("/listEmp")public Result list(){//1. 调用service, 获取数据List<Emp> empList = empService.listEmp();// 响应数据return Result.success(empList);}
}-------------
/**
Service层
*/
@Component //将当前对象交给IOC容器管理,成为IOC容器的bean
public class EmpServiceA implements EmpService {@Autowired //运行时,从IOC容器中获取该类型对象,赋值给该变量private EmpDao empDao ;@Overridepublic List<Emp> listEmp() {//1. 调用dao, 获取数据List<Emp> empList = empDao.listEmp();//2. 对数据进行转换处理 - gender, jobempList.stream().forEach(emp -> {//处理 gender 1: 男, 2: 女String gender = emp.getGender();if("1".equals(gender)){emp.setGender("男");}else if("2".equals(gender)){emp.setGender("女");}//处理job - 1: 讲师, 2: 班主任 , 3: 就业指导String job = emp.getJob();if("1".equals(job)){emp.setJob("讲师");}else if("2".equals(job)){emp.setJob("班主任");}else if("3".equals(job)){emp.setJob("就业指导");}});return empList;}
}-------------------
/**
Dao层
*/
@Component //将当前对象交给IOC容器管理,成为IOC容器的bean
public class EmpDaoA implements EmpDao {@Overridepublic List<Emp> listEmp() {//1. 加载并解析emp.xmlString file = this.getClass().getClassLoader().getResource("emp.xml").getFile();System.out.println(file);List<Emp> empList = XmlParserUtils.parse(file, Emp.class);return empList;}
}

3. IOC详解

1.bean的声明

哪个类需要让Spring帮我们创建对象，就给类上加注解，Spring将会帮我们创建对象放到容器。这个过程叫：bean的注册或者bean的声明

bean：就是Spring创建出来的对象，起的称呼

/**
Controller层
*/
@RestController  //@RestController = @Controller + @ResponseBody
public class EmpController {@Autowired //运行时,从IOC容器中获取该类型对象,赋值给该变量private EmpService empService ;@RequestMapping("/listEmp")public Result list(){//1. 调用service, 获取数据List<Emp> empList = empService.listEmp();// 响应数据return Result.success(empList);}
}----------------
/**
Service层
*/
@Service
public class EmpServiceA implements EmpService {@Autowired //运行时,从IOC容器中获取该类型对象,赋值给该变量private EmpDao empDao ;@Overridepublic List<Emp> listEmp() {//1. 调用dao, 获取数据List<Emp> empList = empDao.listEmp();//2. 对数据进行转换处理 - gender, jobempList.stream().forEach(emp -> {//处理 gender 1: 男, 2: 女String gender = emp.getGender();if("1".equals(gender)){emp.setGender("男");}else if("2".equals(gender)){emp.setGender("女");}//处理job - 1: 讲师, 2: 班主任 , 3: 就业指导String job = emp.getJob();if("1".equals(job)){emp.setJob("讲师");}else if("2".equals(job)){emp.setJob("班主任");}else if("3".equals(job)){emp.setJob("就业指导");}});return empList;}
}--------------
/**
Dao层
*/
@Repository
public class EmpDaoA implements EmpDao {@Overridepublic List<Emp> listEmp() {//1. 加载并解析emp.xmlString file = this.getClass().getClassLoader().getResource("emp.xml").getFile();System.out.println(file);List<Emp> empList = XmlParserUtils.parse(file, Emp.class);return empList;}
}