1、 Http请求报文
Http请求报文示例图如下:
①是请求方法,GET和POST是最常见的HTTP方法,除此以外还包括DELETE、HEAD、OPTIONS、PUT、TRACE。不过,当前的大多数浏览器只支持GET和POST,Spring 3.0提供了一个HiddenHttpMethodFilter,允许通过_method的表单参数指定这些特殊的HTTP方法(实际上还是通过POST提交表单)。服务端配置了HiddenHttpMethodFilter后,Spring会根据_method参数指定的值模拟出相应的HTTP方法,这样,就可以使用这些HTTP方法对处理方法进行映射了。
②为请求对应的URL地址,它和报文头的Host属性组成完整的请求URL
③是协议名称及版本号
-
④是HTTP的报文头,报文头包含若干个属性,格式为 属性名:属性值 ,服务端据此获取客户端的信息
⑤是报文体,它将一个页面表单中的组件值通过param1=value1¶m2=value2的键值对形式编码成一个格式化串,它承载多个请求参数的数据。不但报文体可以传递请求参数,请求URL也可以通过类似于/chapter15/user.html? param1=value1¶m2=value2”的方式传递请求参数。
对照上面的请求报文,把它进一步分解,可以看到一幅更详细的结构图:
2、post/get请求
2.1 post请求
Http Header里的Content-Type一般有这三种:
multipart/form-data(一般用来上传文件): 数据被编码为一条消息,页面上的每个控件对应消息中的一个部分;
application/x-www-form-urlencoded:数据被编码为名称/值对。这是标准的编码格式。默认行为。会将表单内的数据转换拼接成key-value对(非 ASCII 码进行编码);
text/plain: 数据以纯文本形式(text/json/xml/html)进行编码,其中不含任何控件或格式字符。postman软件里标的是RAW;
2.2 get请求
GET请求 不存在请求实体部分,键值对参数放置在 URL 尾部,浏览器把form数据转换成一个字串name1=value1&name2=value2...,然后把这个字串追加到url后面,用?分割,加载这个新的url。因此请求头不需要设置 Content-Type 字段,就算设置了没什么用,还是用默认的content-type来进行的: application/x-www-form-urlencoded;
非 ASCII 码会自动进行编码转换,例如发送请求:www.bilibili.com?hehe=你的我的
GET 参数的编码方式是无法人为干涉的 ,这导致了不同浏览器有不同的编码方式,因此最稳妥的方案是人工预编码,人工解码,从而禁止浏览器编码的干涉
2.3 post VS get
Get和Post都是Http协议的组件,所以底层都是使用tcp链接。Get的请求方式是将http的header和data一并发往服务端,也就是一条tcp数据包发送,这就会有两个问题:
数据量有限,依赖于Tcp负载能力,所以携带的数据量很大的情况下,容易造成重发。
所有的携带的数据只能接受转化成ASCII字符。
但是Post不一样,post使用两步走,先发送http的header,然后再传输data。数据类型也不受限制。而且数据隐秘性比较好。
3、后端获取请求参数
3.1 post请求
- 使用HttpServletRequest
@PostMapping("/uploadNetPointExcelFile")
public Result uploadNetPointExcelFile(HttpServletRequest request) {
String userId= request.getParameter("userId");
}
- 使用@RequestBody 可接受的参数 Map,JSONObject,或者对应的JavaBean
//post 请求的是json字符串,@RequestBody 将字符串转为Map<>类型
//post : {"key":"value"}
@RequestMapping(value = "/test")
public String getStart1(@RequestBody Map map) {
return map.toString();
}
- 使用@RequestParam
//这种方式只用在Content-Type=application/x-www-form-urlencoded这种情况下才能使用,sevlet将Body中的key-value转成Param。
@RequestMapping(value = "/getUserInfo")
public User getUserInfo(@RequestParam(value = "id",required = false) Integer id){
}
总结:post可以传递参数可以大致分成两种,
一种是表单:在sevlet实现中mutipart/form-data和application/x-www-form-urlencoded会被特殊处理,请求参数将被放置于request.paramter,解析成map,参数必须要用@RequestParam解析;
第二种是application/json,参数是存放在json中的,参数必须要用@RequestBody才能解析出来。
@RequestBody是将post请求中内容转为一个整体对象。
@RequestBody的解析有两个条件:
1.POST请求中content的值必须为json格式(存储形式可以是字符串,也可以是byte数组);
2.@RequestBody注解的参数类型必须是完全可以接收参数值的类型,比如:Map,JSONObject,或者对应的JavaBean;
3.2 get请求
get请求方式参数是拼接在url后,所以限制了可以发送的长度。Get不支持使用http Body获取参数,他只支持params,也就是URL拼接参数
- 使用HttpServletRequest
@GetMapping("/downloadJoinRecord")
public void downloadJoinRecord(HttpServletRequest request, HttpServletResponse response) {
String activityName = request.getParameter("activityName");
String productType = request.getParameter("productType");
}
这个方法是获取整个URL的信息,然后手动获取和分离参数,和类型转化。这个里面带的内容很多,不仅Param还有Header,Cookies等。
- 默认方式,什么也不加,直接在方法中获取参数值
//参数多时,用对象接收
@GetMapping("/exportAnalysisNew")
public void exportAnalysisNew(GoldFingerClueReportDTO paramMap, HttpServletResponse response, HttpServletRequest request){
}
//参数少时,直接接收
@RequestMapping(value = "/getUserInfo")
public User getUserInfo(Integer id){
}
//默认情况下会从Param(就是URL后面的拼接参数)获取名字是id的项,自动转化成Integer类型,其他的类型也是类似。
- 利用@RequestParam
@GetMapping("getUserName")
public Result getTest(@RequestParam("userName") String userName){
return userName;
}
4、@RequestBody VS @RequestParam
4.1 @RequestBody
@RequestBody用来处理请求头Content-Type: 为 application/json编码的内容,明确的告诉服务器发送的内容是json。
因为需要读取body中内容,所以只能接受post请求。
就application/json类型的数据而言,使用注解@RequestBody可以将body里面所有的json数据传到后端,后端再进行解析。
GET请求中,因为没有HttpEntity,所以@RequestBody并不适用。
POST请求中,通过HttpEntity传递的参数,必须要在请求头中声明数据的类型Content-Type,SpringMVC通过使用HandlerAdapter 配置的HttpMessageConverters来解析HttpEntity中的数据,然后绑定到相应的bean上。
4.2 @RequestParam
@RequestParam用来处理请求头Content-Type: 为 application/x-www-form-urlencoded编码的内容。(Http协议中,如果不指定Content-Type,则默认传递的参数就是application/x-www-form-urlencoded类型)
get 方式中queryString的值,和post方式中 body data的值都会被Servlet接受到并转化到Request.getParameter()参数集中,所以@RequestParam可以获取的到。
RequestParam可以接受简单类型的属性,也可以接受对象类型。
实质是将Request.getParameter() 中的Key-Value参数Map利用Spring的转化机制ConversionService配置,转化成参数接收对象或字段。
@RequestParam有三个配置参数:
- required 表示是否必须,默认为 true,必须。
- defaultValue 可设置请求参数的默认值。
- value 为接收url的参数名(相当于key值)。
@RequestParam也可用于其它类型的请求,例如:POST、DELETE等请求。
5、总结
form-data、x-www-form-urlencoded:不可以用@RequestBody;可以用@RequestParam
application/json:json字符串部分可以用@RequestBody;url中的?后面参数可以用@RequestParam
在GET请求中,不能使用@RequestBody。 在POST请求,可以使用@RequestBody和@RequestParam;
可以使用多个@RequestParam获取数据,@RequestBody不可以;
参数在url中时,使用@PathVariable
接口规范为resultful风格时,举个例子:如果要获取某个id下此条问题答案的查询次数的话,则后台就需要动态获取参数,其注解为@PathVariable,并且requestMapping中的value应为value="/{id}/queryNum",截图如下: