HttpClient -- StringEntity 编码问题

 

最近使用Apache的httpclient发起httpPost请求，后端一直提示编码格式错误。代码和环境都是在UTF-8写处理的，后端接受的编码也是UTF-8，但是后端依然报错。在跟踪代码的时候，发现主要是客户端StringEntity的处理问题。StringEntity设置编码格式主要有以下两种方式
 

//第一种方式：后端无法解码
StringEntity stringEntity = new StringEntity(JSONObject.toJSONString(params));
stringEntity.setContentType("UTF-8");
 
//第二种方式：请求成功
StringEntity stringEntity = new StringEntity(JSONObject.toJSONString(params), "UTF-8");

在跟踪源码的时候，发现StringEntity的处理逻辑如下：

public StringEntity(String string) throws UnsupportedEncodingException {
        this(string, ContentType.DEFAULT_TEXT);
}
 
public StringEntity(String string, ContentType contentType) throws UnsupportedCharsetException {
        Args.notNull(string, "Source string");
        Charset charset = contentType != null ? contentType.getCharset() : null;
        if (charset == null) {
            charset = HTTP.DEF_CONTENT_CHARSET;
        }
 
        this.content = string.getBytes(charset);
        if (contentType != null) {
            this.setContentType(contentType.toString());
        }
 
 }

 当不传入ContentType时，会使用默认值，而该处的默认编码格式是：ISO_5598_1。所以后端才会提示异常。

    总结：使用httpclient时，尽量使用第二种方式来初始化StringEntity，避免因为编码格式导致异常。

例子：

POST---有参测试(对象参数)

  /**
     * POST---有参测试(对象参数)
     *
     *
     */
    @Test
    public void doPostTestTwo() {  
 // 获得Http客户端(可以理解为:你得先有一个浏览器;注意:实际上HttpClient与浏览器是不一样的)
        CloseableHttpClient httpClient = HttpClientBuilder.create().build();

        // 创建Post请求
        HttpPost httpPost = new HttpPost("http://localhost:12345/doPostControllerTwo");
        User user = new User();
        user.setUserName("王网");
        user.setPassword("Ss@1234");

        // 我这里利用阿里的fastjson，将Object转换为json字符串;
        // (需要导入com.alibaba.fastjson.JSON包)
        String jsonString = JSON.toJSONString(user);

        StringEntity entity = new StringEntity(jsonString, "UTF-8");

        // post请求是将参数放在请求体里面传过去的;这里将entity放入post请求体中
        httpPost.setEntity(entity);

        httpPost.setHeader("Content-Type", "application/json;charset=utf8");

        // 响应模型
        CloseableHttpResponse response = null;
        try {
            // 由客户端执行(发送)Post请求
            response = httpClient.execute(httpPost);
            // 从响应模型中获取响应实体
            HttpEntity responseEntity = response.getEntity();

            System.out.println("响应状态为:" + response.getStatusLine());
            if (responseEntity != null) {
                System.out.println("响应内容长度为:" + responseEntity.getContentLength());
                System.out.println("响应内容为:" + EntityUtils.toString(responseEntity));
            }
        } catch (ClientProtocolException e) {
            e.printStackTrace();
        } catch (ParseException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                // 释放资源
                if (httpClient != null) {
                    httpClient.close();
                }
                if (response != null) {
                    response.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }