Tomcat + Spring MVC + HttpClient:如何使用PUT和PATCH方法传递数据

  • Post author:
  • Post category:其他


在RESTful风格的API中,PUT/PATCH方法一般用于更新数据。在项目的代码中,使用的是HttpClient 4.5,是这样写的:

protected JSONObject doHttpUriRequest(HttpUriRequest httpUriRequest) {
    JSONObject result = null;

    HttpClient httpClient = HttpClients.createDefault();
    try {
        HttpResponse httpResponse = httpClient.execute(httpUriRequest);
        StatusLine responseStatusLine = httpResponse.getStatusLine();

        int statusCode = responseStatusLine.getStatusCode();
        if (statusCode == 200) {
            HttpEntity responseEntity = httpResponse.getEntity();

            String jsonString = EntityUtils.toString(responseEntity, CHARACTER_SET);
            result = new JSONObject(jsonString);

            EntityUtils.consume(responseEntity);
        } else {
            // error handling
        }
    } catch (IOException e) {
        e.printStackTrace();
        return onLocalError(e);
    }

    return result;
}

protected JSONObject doHttpPatch(String uri, Map<String, String> params) {
    JSONObject result = null;

    HttpPatch httpPatch = new HttpPatch(uri);
    List<NameValuePair> nvps = constructNvps(params); // constructing name-value pair

    try {
        httpPatch.setEntity(new UrlEncodedFormEntity(nvps, CHARACTER_SET));
        result = doHttpUriRequest(httpPatch);
    } catch (UnsupportedEncodingException e) {
        e.printStackTrace();
        return onLocalError(e);
    }

    return result;
}

其中doHttpUriRequest()是一个处理发送请求的工具函数,doHttpPatch()是具体处理数据的函数。

可见写法和一个普通的POST请求差不多,只是将HttpPost换成HttpPatch。

可是在server端,比如在params中有一个参数叫key,值是value,在Controller里面,能识别到这是一个PATCH方法,可是key的值是null。就是Servlet不能从form里面获取参数。

Google查了一下原因,大体是说PATCH这个方法很新,就算到Tomcat 7.0.39也都不支持。那怎么破呢?有两个办法:


1. 用URI来请求

既然不能使用form来获取参数,那就写在URI的尾巴吧:

protected JSONObject doHttpPatchWithURI(String uri, Map<String, String> params) {
    JSONObject result = null;
    URIBuilder uriBuilder = new URIBuilder();
    uriBuilder.setPath(uri);
    uriBuilder.setParameters(constructNvps(params));

    try {
        URI builtUri = uriBuilder.build();
        HttpPatch httpPatch = new HttpPatch(builtUri);
        result = doHttpUriRequest(httpPatch);
    } catch (URISyntaxException e) {
        e.printStackTrace();
        return onLocalError(e);
    }

    return result;
}

使用了这种做法,servlet可以获得参数了。

这个方法有一个问题。就是即使key是null值,在URI的参数也会带上。在Servlet里面接收,key的值会变成”“(空字符串)。这样在RESTful风格API里面会有歧义:究竟是不更新,还是更新成空字符串呢?


2. 在web.xml中加入一个filter

另一种做法是保持使用上面POST风格的方法,在web.xml中加入一个filter:

<filter>
    <filter-name>HttpPutFormContentFilter</filter-name>
    <filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HttpPutFormContentFilter</filter-name>
    <servlet-name>springWebMvcDispatcher</servlet-name>
</filter-mapping>

其中springWebMvcDispatcher是servlet的名字。

Filter的工作是从request body的form data里面读取数据,然后包装成一个ServletRequest,使得ServletRequest.getParameter*()之类的方法可以读取到数据。

参考文档:


http://stackoverflow.com/questions/20370927/patch-method-in-tomcat-with-spring-mvc



版权声明:本文为dduhmy原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。