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;
}

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