请求响应
概述
- 前端控制器(核心控制器)DispatcherServlet:它实现了Servlet接口,可以被Tomcat程序识别。浏览器发起的请求会先通过DispatcherServlet,由DispatcherServlet将请求转给后方的controller程序进行处理,处理完成后,controller程序再将处理完的结果返回给DispatcherServlet,最后在由DispatcherServlet将响应返回浏览器。
- 请求对象HttpServletRequest:获取请求数据。
- 响应对象HttpServletResponse:设置响应数据。
基本的通信架构
- BS架构:Browser/Server,浏览器/服务器架构模式。客户端只需要浏览器,应用程序的逻辑和数据都存储在服务端。维护方便,用户体验一般。
- CS架构:Client/Server,客户端/服务器架构模式。客户端需要下载安装客户端程序,部分逻辑和数据存储在客户端。开发、维护麻烦,用户体验不错。
请求
Postman
- Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件,可以模拟浏览器来发起任何形式的请求,并且在请求的过程中可以很方便地携带很多请求参数、请求头等信息。
- 作用:常用于进行接口测试,也是后端开发工程师进行接口测试的首选工具。
简单参数
原始方式(了解)
在原始的web程序中,获取请求参数需要通过HttpServletRequest对象手动获取。
@RequestMapping("/simpleParam")
public String simpleParam(HttpServletRequest request){
//接收参数,接收到的参数都是字符串类型
String name = request.getParameter("name");
String ageStr = request.getParameter("age");
//类型转换
int age = Integer.parseInt(ageStr);
System.out.println(name+" : "+age);
//返回“OK”到浏览器
return "OK";
}
SpringBoot方式
- 参数名与形参变量名相同,定义形参即可接收参数,并且会自动进行类型转换。
//URL: http://localhost:8080/simpleParam?name=Tom&age=10
@RequestMapping("/simpleParam")
public String simpleParam(String name , Integer age){
System.out.println(name+" : "+age);
return "OK";
}
- 如果方法形参名称与请求参数名称不匹配,可以使用@RequestParam注解完成映射。
//URL: http://localhost:8080/simpleParam?name=Tom&age=10
@RequestMapping("/simpleParam")
public String simpleParam(@RequestParam(name = "name") String username , Integer age){
System.out.println(username + " : " + age);
return "OK";
}
- @RequestParam注解中的required属性默认为true,代表该请求参数必须传递,如果不传递将报错。 如果该参数是可选的,可以将required属性设置为false。
实体参数
简单实体对象
请求参数名与形参对象属性名相同,定义Pojo接收即可。
//URL: http://localhost:8080/simplePojo?name=Tom&age=10
@RequestMapping("/simplePojo")
public String simplePojo(User user){
System.out.println(user);
return "OK";
}
//User类
public class User {
private String name;
private Integer age;
}
复杂实体对象
-
形参对象内部嵌套了其他对象就叫复杂实体对象。
-
请求参数名与形参对象属性名相同,按照对象层次结构关系即可接收嵌套Pojo属性参数。
//URL: http://localhost:8080/complexPojo?name=Tom&age=10&address.province=Beijing&address.city=Beijing
@RequestMapping("/complexPojo")
public String complexPojo(User user){
System.out.println(user);
return "OK";
}
//User类
public class User {
private String name;
private Integer age;
private Address address;
}
//Address类
public class Address {
private String province;
private String city;
}
数组集合参数
数组参数
请求参数名与形参数组名称相同且请求参数为多个,定义数组类型形参即可接收参数。
//URL: http://localhost:8080/arrayParam?hobby=game&hobby=java
@RequestMapping("/arrayParam")
public String arrayParam(String[] hobby){
System.out.println(Arrays.toString(hobby));
return "OK";
}
集合参数
请求参数名与形参集合名称相同且请求参数为多个,需要使用@RequestParam注解绑定参数关系。
//URL: http://localhost:8080/listParam?hobby=game&hobby=java&hobby=sing
@RequestMapping("/listParam")
public String listParam(@RequestParam List<String> hobby){
System.out.println(hobby);
return "OK";
}
日期参数
请求参数名与形参集合名称相同,使用形参LocalDateTime对象来接收,且需要使用@DateTimeFormat注解完成日期参数格式转换 。
//URL: http://localhost:8080/dateParam?updateTime=2022-12-12 10:05:45
@RequestMapping("/dateParam")
public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){
System.out.println(updateTime);
return "OK";
}
Json参数
- 使用形参对象接收,Json数据键名与形参对象属性名相同,定义Pojo类型形参即可接收参数,需要使用@RequestBody注解标识。
- Json参数只能使用POST请求方式在请求体中传输。
//URL: http://localhost:8080/jsonParam
@RequestMapping("/jsonParam")
public String jsonParam(@RequestBody User user){
System.out.println(user);
return "OK";
}
//User类
public class User {
private String name;
private Integer age;
private Address address;
}
//Address类
public class Address {
private String province;
private String city;
}
路径参数
-
通过请求URL直接传递的参数叫路径参数。
-
使用
{形参名}
来标识该路径参数,需要使用@PathVariable注解获取路径参数。
//URL: http://localhost:8080/path/1
@RequestMapping("/path/{id}")
public String pathParam(@PathVariable Integer id){
System.out.println(id);
return "OK";
}
- 也可以同时传递多个参数,使用
{形参名1}/{形参名2}...
即可。
//URL: http://localhost:8080/path/1/Tom
@RequestMapping("/path/{id}/{name}")
public String pathParam2(@PathVariable Integer id, @PathVariable String name){
System.out.println(id+ " : " +name);
return "OK";
}
响应
@ResponseBody
类型
方法注解、类注解。
位置
Controller方法上/类上。
作用
-
将方法的返回值直接响应,如果返回值类型是实体对象或集合,则会先将实体对象或集合转换为Json格式,再响应Json格式的数据。
-
当注解类时,类内部的所有方法的返回值都会直接响应。
注意
- @RestController = @Controller + @ResponseBody。
- 在Controller中定义的每一个注解了@RequestMapping的对外暴露的方法都被称为功能接口。
统一响应结果
- 当直接返回方法的返回值时,返回值的类型不固定,从而导致不便管理和难以维护。
- 可以将返回值封装在一个类中,达到统一响应结果的目的:
public class Result {
//响应码,1 代表成功; 0 代表失败
private Integer code;
//提示信息
private String msg;
//返回的数据
private Object data;
//……
}
分层解耦
三层架构
三层架构将业务职责分开,每一层只负责一个业务职责,复用性强,便于维护,利于拓展。
- controller:控制层,接收前端发送的请求,对请求进行处理,并响应数据。
- service:业务逻辑层,处理具体的业务逻辑。
- dao:数据访问层(Data Access Object)(也叫持久层),负责数据访问操作,包括数据的增、删、改、查。
分层解耦
- 内聚:软件中各个功能模块内部的功能联系,联系越紧密,内聚度越高,理想内聚的模块只做一件事情。
- 耦合:衡量软件中各个层/模块之间的依赖、关联的程度,程度越高,耦合越紧。
- 软件设计原则:高内聚低耦合。
spring中实现分层解耦所依赖的思想
- 控制反转: Inversion Of Control,简称IOC,spring的第一大核心思想。对象的创建控制权由程序自身转移到外部(容器),这种思想称为控制反转。
- 依赖注入: Dependency Injection,简称DI。容器为应用程序提供运行时,所依赖的资源,称之为依赖注入。
- Bean对象:IOC容器中创建、管理的对象,被称为Bean对象。
IOC详解
Bean的声明
要把某个对象交给IOC容器管理,需要在对应的类上加上如下注解之一:
注解 | 说明 | 位置 |
---|---|---|
@Component | 声明bean的基础注解 | 不属于以下三类时,用此注解 |
@Controller | @Component的衍生注解 | 标注在控制器类上 |
@Service | @Component的衍生注解 | 标注在业务类上 |
@Repository | @Component的衍生注解 | 标注在数据访问类上(由于与mybatis整合,用的少) |
注意事项
- 声明bean的时候,可以通过value属性指定bean的名字,如果没有指定,默认为类名首字母小写。
- 使用以上四个注解都可以声明bean,但是在springboot集成web开发中,声明控制器bean只能用@Controller。
Bean组件扫描
- 前面声明bean的四大注解,要想生效,还需要被组件扫描注解@ComponentScan扫描。
- @ComponentScan注解虽然没有显式配置,但是实际上已经包含在了启动类声明注解@SpringBootApplication中,默认扫描的范围是启动类所在包及其子包。
某些包扫描不到的解决方案
- 手动添加@ComponentScan注解,该注解的参数是要扫描的的包名数组,且必须将启动类所在包也传入,因为显示添加了@ComponentScan注解后,@SpringBootApplication注解中的@ComponentScan注解就失效了。(不推荐)
- 将所有代码文件都按照规范,放在启动类所在包及其子包中。(推荐)
DI详解
- @Autowired注解,默认是按照类型进行,如果存在多个相同类型的bean,将会出现错误。
- 可以通过以下几种方案来解决:
- @Primary注解要注入的对象。
- @Autowired + @Qualifier("bean的名称")注解被注入的变量。
- @Resource(name="bean的名称")注解被注入的变量。
@Resource与@Autowired区别
- @Autowired 是spring框架提供的注解,而@Resource是JDK提供的注解。
- @Autowired 默认是按照类型注入,而@Resource默认是按照名称注入。