wechat4j获取用户昵称乱码修复

项目对接微信公众号平台时，微信的官方给出的建议是使用wechat4j。官方建议的，自然心里踏实，但实际用起来时发现wechat4j埋有很多雷，最让人心烦意乱的就是中文乱码问题。

之前写过一篇为JAXB和response设置编码，解决wechat4j中文乱码，解决的是智能输入时反馈信息的乱码，遇到同样问题的伙伴可以去参考一下解决方案。

今天要写的是利用wechat4j获取用户昵称乱码的问题。

一、问题描述

UserManager userManager = new UserManager();
org.sword.wechat4j.user.User user = userManager.getUserInfo(tokenResponse.getOpenid());
thirdLoginMember.setThird_name(user.getNickName());

项目运行时，一旦昵称为中文，此方法获得的昵称就是乱码，引发乱码的原因其实很直白，无非就是编码方式不匹配。

二、问题分析

我们来追本溯源，看看以下的代码，我们能感受到问题具体出在哪。

wechat4j中的代码

public User getUserInfo(String openId) {
    return getUserInfo(openId, null);
}

public User getUserInfo(String openId, LanguageType lang) {
    String url = USER_INFO_GET_URL + TokenProxy.accessToken() + "&openid=" + openId;
    if (lang != null) {
        url += "&lang=" + lang.name();
    }
    String resultStr = HttpUtils.get(url);
    logger.info("return data " + resultStr);
    try {
        WeChatUtil.isSuccess(resultStr);
    } catch (WeChatException e) {
        logger.error(e.getMessage());
        e.printStackTrace();
        return null;
    }

    User user = JSONObject.parseObject(resultStr, User.class);
    return user;
}

public static String get(String url){
    return httpGet(url);
}

private static String httpGet(String url) {
    try {
        HttpEntity entity = Request.Get(url).
                execute().returnResponse().getEntity();
        return entity != null ? EntityUtils.toString(entity) : null;
    } catch (Exception e) {
        logger.error("get请求异常，" + e.getMessage() + "\n get url:" + url);
        e.printStackTrace();
    }
    return null;
}

httpcore-4.3.3.jar中的代码

public static String toString(final HttpEntity entity)
    throws IOException, ParseException {
    return toString(entity, (Charset)null);
}

public static String toString(
        final HttpEntity entity, final Charset defaultCharset) throws IOException, ParseException {
    Args.notNull(entity, "Entity");
    final InputStream instream = entity.getContent();
    if (instream == null) {
        return null;
    }
    try {
        Args.check(entity.getContentLength() <= Integer.MAX_VALUE,
                "HTTP entity too large to be buffered in memory");
        int i = (int)entity.getContentLength();
        if (i < 0) {
            i = 4096;
        }
        Charset charset = null;
        try {
            final ContentType contentType = ContentType.get(entity);
            if (contentType != null) {
                charset = contentType.getCharset();
            }
        } catch (final UnsupportedCharsetException ex) {
            if (defaultCharset == null) {
                throw new UnsupportedEncodingException(ex.getMessage());
            }
        }
        if (charset == null) {
            charset = HTTP.UTF8_CONTENT_CHARSET;
        }
        logger.info("输出流的转码方式为：" + charset);

        final Reader reader = new InputStreamReader(instream, charset);
        final CharArrayBuffer buffer = new CharArrayBuffer(i);
        final char[] tmp = new char[1024];
        int l;
        while((l = reader.read(tmp)) != -1) {
            buffer.append(tmp, 0, l);
        }
        return buffer.toString();
    } finally {
        instream.close();
    }
}

从上述代码中可得知，wechat4j在取得到参数后，调用httpcore-4.3.3.jar中的EntityUtils类的toString（）方法，该方法默认使用的编码方式是“ISO-8859-1”。看到这里，你也许就恍然大悟了，原来如此嘛。那，该如何改动呢？

三、问题解决之道

wechat4j是一个jar包，git上提供了源码下载，你可以选择直接在项目中引入wechat4j.jar，也可以选择把源码作为一个导入项目引入到项目中，我选择的是第二种做法，这种方案方便我们调试，以及修改源码。

在说解决之道之前，我先啰嗦一点关于eclipse中项目之间引用的注意事项。

上图是我项目中wechat4j源码的目录：

apache.http就是httpcore-4.3.3.jar的源码。
sword是wechat4j.jar的源码。
tomcat 7 是把该项目引入到一个web项目后，自动出现的，我顺带把wechat4j所需要的jar包添加到lib包下。
本来wechat4j是一个Java项目。

关于deployment assembly我并没有很好的理解其作用（Define packaging structure for this Java EE Web Application project.），大致的意思是把被引入的项目编译成jar包供引用项目使用。

build path中引入项目。

project reference。

关于这三个之间的关联关系，我真是没有搞明白，敬请小伙伴们指导。

PS：请特别注入，针对wechat4j的引入，被引入项目（ymeng）中不能再放httpcore-4.3.3.jar，否则wechat4j中的httpcore将不会起作用。

那么接下来，我们该好好看看怎么解决了，其实方法依然可知。

第一种，EntityUtils.toString()方法中设置编码方式。

return entity != null ? EntityUtils.toString(entity,"utf-8") : null;

这个其实应该交由wechat4j来做的，但它坑了。

第二种，EntityUtils.toString方法中设置默认的编码方式为utf-8.

if (charset == null) {
   charset = HTTP.UTF8_CONTENT_CHARSET;
}

看完本篇文章，大家是否略有所获？