Ajax的text/plain、application/x-www-form-urlencoded和application/json

2022-10-06 11:04:11

Ajax的text/plain、application/x-www-form-urlencoded和application/json

HTTP请求中，如果是get请求，那么表单参数以name=value&name1=value1的形式附到url的后面，如果是post请求，那么表单参数是在请求体中，也是以name=value&name1=value1的形式在请求体中。通过chrome的开发者工具可以看到如下（这里是可读的形式，不是真正的HTTP请求协议的请求格式）：

get请求：

[plain] view plain copy

  1. RequestURL:http://127.0.0.1:8080/test/test.do?name=mikan&address=street
  2. Request Method:GET
  3. Status Code:200 OK
  4. Request Headers
  5. Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
  6. Accept-Encoding:gzip,deflate,sdch
  7. Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
  8. AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
  9. Connection:keep-alive
  10. Cookie:JSESSIONID=74AC93F9F572980B6FC10474CD8EDD8D
  11. Host:127.0.0.1:8080
  12. Referer:http://127.0.0.1:8080/test/index.jsp
  13. User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36
  14. Query String Parameters
  15. name:mikan
  16. address:street
  17. Response Headers
  18. Content-Length:2
  19. Date:Sun, 11 May 2014 10:42:38 GMT
  20. Server:Apache-Coyote/1.1

Post请求：

[plain] view plain copy

  1. RequestURL:http://127.0.0.1:8080/test/test.do
  2. Request Method:POST
  3. Status Code:200 OK
  4. Request Headers
  5. Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
  6. Accept-Encoding:gzip,deflate,sdch
  7. Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
  8. AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
  9. Cache-Control:max-age=0
  10. Connection:keep-alive
  11. Content-Length:25
  12. Content-Type:application/x-www-form-urlencoded
  13. Cookie:JSESSIONID=74AC93F9F572980B6FC10474CD8EDD8D
  14. Host:127.0.0.1:8080
  15. Origin:http://127.0.0.1:8080
  16. Referer:http://127.0.0.1:8080/test/index.jsp
  17. User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36
  18. Form Data
  19. name:mikan
  20. address:street
  21. Response Headers
  22. Content-Length:2
  23. Date:Sun, 11 May 2014 11:05:33 GMT
  24. Server:Apache-Coyote/1.1

这里要注意post请求的Content-Type为application/x-www-form-urlencoded，参数是在请求体中，即上面请求中的Form Data。

在servlet中，可以通过request.getParameter(name)的形式来获取表单参数。

而如果使用原生AJAX POST请求的话：

[javascript] view plain copy

  1. function getXMLHttpRequest() {
  2. var xhr;
  3. if(window.ActiveXObject) {
  4. xhr= new ActiveXObject("Microsoft.XMLHTTP");
  5. }else if (window.XMLHttpRequest) {
  6. xhr= new XMLHttpRequest();
  7. }else {
  8. xhr= null;
  9. }
  10. return xhr;
  11. }
  12. function save() {
  13. var xhr = getXMLHttpRequest();
  14. xhr.open("post","http://127.0.0.1:8080/test/test.do");
  15. var data = "name=mikan&address=street...";
  16. xhr.send(data);
  17. xhr.onreadystatechange= function() {
  18. if(xhr.readyState == 4 && xhr.status == 200) {
  19. alert("returned:"+ xhr.responseText);
  20. }
  21. };
  22. }

通过chrome的开发者工具看到请求头如下：

[plain] view plain copy

  1. RequestURL:http://127.0.0.1:8080/test/test.do
  2. Request Method:POST
  3. Status Code:200 OK
  4. Request Headers
  5. Accept:*/*
  6. Accept-Encoding:gzip,deflate,sdch
  7. Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
  8. AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
  9. Connection:keep-alive
  10. Content-Length:28
  11. Content-Type:text/plain;charset=UTF-8
  12. Cookie:JSESSIONID=C40C7823648E952E7C6F7D2E687A0A89
  13. Host:127.0.0.1:8080
  14. Origin:http://127.0.0.1:8080
  15. Referer:http://127.0.0.1:8080/test/index.jsp
  16. User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36
  17. Request Payload
  18. name=mikan&address=street
  19. Response Headers
  20. Content-Length:2
  21. Date:Sun, 11 May 2014 11:49:23 GMT
  22. Server:Apache-Coyote/1.1

注意请求的Content-Type为text/plain;charset=UTF-8，而请求表单参数在RequestPayload中。

那么servlet中通过request.getParameter(name)却是空。为什么呢？而这样的参数又该怎么样获取呢？

为了搞明白这个问题，查了些资料，也看了Tomcat7.0.53关于请求参数处理的源码，终于搞明白了是怎么回事。

HTTP POST表单请求提交时，使用的Content-Type是application/x-www-form-urlencoded，而使用原生AJAX的POST请求如果不指定请求头RequestHeader，默认使用的Content-Type是text/plain;charset=UTF-8。

由于Tomcat对于Content-Type multipart/form-data（文件上传）和application/x-www-form-urlencoded（POST请求）做了“特殊处理”。下面来看看相关的处理代码。

Tomcat的HttpServletRequest类的实现类为org.apache.catalina.connector.Request（实际上是org.apache.coyote.Request），而它对处理请求参数的方法为protected void parseParameters()，这个方法中对Content-Type multipart/form-data（文件上传）和application/x-www-form-urlencoded（POST请求）的处理代码如下：

[java] view plain copy

  1. protectedvoid parseParameters() {
  2. //省略部分代码......
  3. parameters.handleQueryParameters();// 这里是处理url中的参数
  4. //省略部分代码......
  5. if ("multipart/form-data".equals(contentType)) { // 这里是处理文件上传请求
  6. parseParts();
  7. success = true;
  8. return;
  9. }
  10. if(!("application/x-www-form-urlencoded".equals(contentType))) {// 这里如果是非POST请求直接返回，不再进行处理
  11. success = true;
  12. return;
  13. }
  14. //下面的代码才是处理POST请求参数
  15. //省略部分代码......
  16. try {
  17. if (readPostBody(formData, len)!= len) { // 读取请求体数据
  18. return;
  19. }
  20. } catch (IOException e) {
  21. // Client disconnect
  22. if(context.getLogger().isDebugEnabled()) {
  23. context.getLogger().debug(
  24. sm.getString("coyoteRequest.parseParameters"),e);
  25. }
  26. return;
  27. }
  28. parameters.processParameters(formData, 0, len); // 处理POST请求参数，把它放到requestparameter map中（即request.getParameterMap获取到的Map，request.getParameter(name)也是从这个Map中获取的）
  29. // 省略部分代码......
  30. }
  31. protected int readPostBody(byte body[], int len)
  32. throws IOException {
  33. int offset = 0;
  34. do {
  35. int inputLen = getStream().read(body, offset, len - offset);
  36. if (inputLen <= 0) {
  37. return offset;
  38. }
  39. offset += inputLen;
  40. } while ((len - offset) > 0);
  41. return len;
  42. }

从上面代码可以看出，Content-Type不是application/x-www-form-urlencoded的POST请求是不会读取请求体数据和进行相应的参数处理的，即不会解析表单数据来放到request parameter map中。所以通过request.getParameter(name)是获取不到的。

那么这样提交的参数我们该怎么获取呢？

当然是使用最原始的方式，读取输入流来获取了，如下所示：

[java] view
plain copy

  1. privateString getRequestPayload(HttpServletRequest req) {
  2. StringBuildersb = new StringBuilder();
  3. try(BufferedReaderreader = req.getReader();) {
  4. char[]buff = new char[1024];
  5. intlen;
  6. while((len = reader.read(buff)) != -1) {
  7. sb.append(buff,0, len);
  8. }
  9. }catch (IOException e) {
  10. e.printStackTrace();
  11. }
  12. returnsb.toString();
  13. }

当然，设置了application/x-www-form-urlencoded的POST请求也可以通过这种方式来获取。

所以，在使用原生AJAX POST请求时，需要明确设置Request Header，即：

[javascript] view
plain copy

  1. xhr.setRequestHeader("Content-Type","application/x-www-form-urlencoded");

另外，如果使用jQuery，我使用1.11.0这个版本来测试，$.ajax post请求是不需要明确设置这个请求头的，其他版本的本人没有亲自测试过。相信在1.11.0之后的版本也是不需要设置的。不过之前有的就不一定了。这个没有测试过。

2015-04-17后记：

最近在看书时才真正搞明白，服务器为什么会对表单提交和文件上传做特殊处理，因为表单提交数据是名值对的方式，且Content-Type为application/x-www-form-urlencoded，而文件上传服务器需要特殊处理，普通的post请求（Content-Type不是application/x-www-form-urlencoded）数据格式不固定，不一定是名值对的方式，所以服务器无法知道具体的处理方式，所以只能通过获取原始数据流的方式来进行解析。

jquery在执行post请求时，会设置Content-Type为application/x-www-form-urlencoded，所以服务器能够正确解析，而使用原生ajax请求时，如果不显示的设置Content-Type，那么默认是text/plain，这时服务器就不知道怎么解析数据了，所以才只能通过获取原始数据流的方式来进行解析请求数据。

当后台使用@RequestBody以对象的形式来接收数据时，在前台必须以application/json的形式进行传递，同时使用JSON.stringify(data)将json对象转换为json字符串。

当你使用application/x-www-form-urlencoded格式来传递数据时，tomcat会将其组装进一个Map中，后台只能用request.getParameter来访问。

原生Ajax默认格式：text/plain

Jquery Ajax默认格式(Map) + Form表单POST提交格式：application/x-www-form-urlencoded

字符流 Ajax格式(Map)：application/json
 ( 同时使用JSON.stringify(data)将json对象转换为json字符串 )

文件上传：multipart/form-data

上一篇：在linux中配置安装telnet服务


下一篇：[转] SpringBoot RESTful 应用中的异常处理小结