AJAX POST请求中參数以form data和request payload形式在servlet中的获取方式

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

get请求：

RequestURL:http://127.0.0.1:8080/test/test.do?name=mikan&address=street
Request Method:GET
Status Code:200 OK

Request Headers
Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Encoding:gzip,deflate,sdch
Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
Connection:keep-alive
Cookie:JSESSIONID=74AC93F9F572980B6FC10474CD8EDD8D
Host:127.0.0.1:8080
Referer:http://127.0.0.1:8080/test/index.jsp
User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36

Query String Parameters
name:mikan
address:street

Response Headers
Content-Length:2
Date:Sun, 11 May 2014 10:42:38 GMT
Server:Apache-Coyote/1.1

Post请求：

RequestURL:http://127.0.0.1:8080/test/test.do
Request Method:POST
Status Code:200 OK

Request Headers
Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Encoding:gzip,deflate,sdch
Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
Cache-Control:max-age=0
Connection:keep-alive
Content-Length:25
Content-Type:application/x-www-form-urlencoded
Cookie:JSESSIONID=74AC93F9F572980B6FC10474CD8EDD8D
Host:127.0.0.1:8080
Origin:http://127.0.0.1:8080
Referer:http://127.0.0.1:8080/test/index.jsp
User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36

Form Data
name:mikan
address:street

Response Headers
Content-Length:2
Date:Sun, 11 May 2014 11:05:33 GMT
Server:Apache-Coyote/1.1

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

在servlet中，能够通过request.getParameter(name)的形式来获取表单參数。

而假设使用原生AJAX POST请求的话：

         function getXMLHttpRequest() {
                   var xhr;
                   if(window.ActiveXObject) {
                            xhr= new ActiveXObject("Microsoft.XMLHTTP");
                   }else if (window.XMLHttpRequest) {
                            xhr= new XMLHttpRequest();
                   }else {
                            xhr= null;
                   }
                   return xhr;
         }

         function save() {
                   var xhr = getXMLHttpRequest();
                   xhr.open("post","http://127.0.0.1:8080/test/test.do");
                   var data = "name=mikan&address=street...";
                   xhr.send(data);
                   xhr.onreadystatechange= function() {
                            if(xhr.readyState == 4 && xhr.status == 200) {
                                     alert("returned:"+ xhr.responseText);
                            }
                   };
         }

通过chrome的开发人员工具看到请求头例如以下：

RequestURL:http://127.0.0.1:8080/test/test.do
Request Method:POST
Status Code:200 OK

Request Headers
Accept:*/*
Accept-Encoding:gzip,deflate,sdch
Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
AlexaToolbar-ALX_NS_PH:AlexaToolbar/alxg-3.2
Connection:keep-alive
Content-Length:28
Content-Type:text/plain;charset=UTF-8
Cookie:JSESSIONID=C40C7823648E952E7C6F7D2E687A0A89
Host:127.0.0.1:8080
Origin:http://127.0.0.1:8080
Referer:http://127.0.0.1:8080/test/index.jsp
User-Agent:Mozilla/5.0 (Windows NT 6.1)AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.149 Safari/537.36

Request Payload
name=mikan&address=street

Response Headers
Content-Length:2
Date:Sun, 11 May 2014 11:49:23 GMT
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请求）的处理代码例如以下：

protectedvoid parseParameters() {
           //省略部分代码......
           parameters.handleQueryParameters();// 这里是处理url中的參数
           //省略部分代码......
           if ("multipart/form-data".equals(contentType)) { // 这里是处理文件上传请求
                parseParts();
                success = true;
                return;
           }

           if(!("application/x-www-form-urlencoded".equals(contentType))) {// 这里假设是非POST请求直接返回，不再进行处理
                success = true;
                return;
           }
           //以下的代码才是处理POST请求參数
           //省略部分代码......
           try {
                if (readPostBody(formData, len)!= len) { // 读取请求体数据
                    return;
                }
           } catch (IOException e) {
                // Client disconnect
                if(context.getLogger().isDebugEnabled()) {
                    context.getLogger().debug(
                            sm.getString("coyoteRequest.parseParameters"),e);
                }
                return;
           }
           parameters.processParameters(formData, 0, len); // 处理POST请求參数，把它放到requestparameter map中（即request.getParameterMap获取到的Map，request.getParameter(name)也是从这个Map中获取的）
           // 省略部分代码......
}

   protected int readPostBody(byte body[], int len)
       throws IOException {

       int offset = 0;
       do {
           int inputLen = getStream().read(body, offset, len - offset);
           if (inputLen <= 0) {
                return offset;
           }
           offset += inputLen;
       } while ((len - offset) > 0);
       return len;
    }

从上面代码能够看出，POST请求是不会读取请求体数据和进行对应的參数处理的，即把表单数据解析后，放到request parameter map中（即request.getParameterMap获取到的Map，request.getParameter(name)也是从这个Map中获取的）。所以通过request.getParameter(name)是获取不到的。

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

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

         privateString getRequestPayload(HttpServletRequest req) {
                   StringBuildersb = new StringBuilder();
                   try(BufferedReaderreader = req.getReader();) {
                            char[]buff = new char[1024];
                            intlen;
                            while((len = reader.read(buff)) != -1) {
                                     sb.append(buff,0, len);
                            }
                   }catch (IOException e) {
                            e.printStackTrace();
                   }
                   returnsb.toString();
         }

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

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

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

另外，假设使用jquery，我使用1.11.0这个版本号来測试，$.ajax post请求是不须要明白设置这个请求头的，其它版本号的本人没有亲自測试过。相信在1.11.0之后的版本号也是不须要设置的。只是之前有的就不一定了。这个没有測试过。