微信Java开发工具包的使用前言：一、weixin-java-tools介绍：二、使用方法：总结:
微信Java开发工具包的使用前言：一、weixin-java-tools介绍：二、使用方法：总结:
前言：
之前我在《Java调用微信登录以及eclipse远程调试》一文中说到了Java程序怎么调用微信登录，不过那篇文章中使用的是手工方式，本文将介绍如何使用第三方SDK(binarywang)进行微信网页授权以及获取微信用户信息。
一、weixin-java-tools介绍：
weixin-java-tools是大神binarywang写的一个全能微信Java开发工具包，支持包括微信支付、开放平台、小程序、企业微信/企业号和公众号等的开发，使用起来十分方便。具体的大家可以去GitHub上搜索binarywang。
二、使用方法：
1、后台配置：
本人使用的是微信测试号，因此访问http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login，登录你的测试号。然后找到如下配置项：
image.png
点击修改，改成你的域名即可。比如我修改的就是wx.natappvip.cc。
2、添加依赖：
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-mp</artifactId>
<version>3.0.0</version>
</dependency>3、配置： 本项目是springmvc项目，所以在spring的配置文件中进行如下配置：
<!-- 微信相关配置 -->
<bean id="wxMpConfigStorage" class="me.chanjar.weixin.mp.api.WxMpInMemoryConfigStorage">
<property name="appId" value="你的appId"/>
<property name="secret" value="你的secret"/>
</bean>
<bean id="wxMpService" class="me.chanjar.weixin.mp.api.impl.WxMpServiceImpl">
<property name="wxMpConfigStorage" ref="wxMpConfigStorage"/>
</bean>若是springboot项目，那就得新建配置类了。配置了之后就可以开始使用了。
4、开始使用：
- 首先新建一个授权的controller：
/** 微信授权路由 */
@GetMapping("/authorize")
public String authorize(@RequestParam("state") String state,
@RequestParam("url") String url){
//这个方法的三个参数分别是授权后的重定向url、获取用户信息类型和state
String redirectUrl = wxMpService .oauth2buildAuthorizationUrl(
url, WxConsts.OAuth2Scope.SNSAPI_USERINFO, URLEncoder.encode(state));
log.info("【微信网页授权】获取code,redirectUrl={}",redirectUrl);
return "redirect:" + redirectUrl;
}解释一下这个方法：这个方法需要两个参数，
state：就是微信定义的一个参数，用户可以传入自定义的参数，等下会讲解怎么用state传值；
url：就是用户微信授权登录后重定向的页面路由。
比如现在访问该方法并传入如下参数：
http://wx.natappvip.cc/authorize?url=http://wx.natappvip.cc/index&state=null
因为传入的url是http://wx.natappvip.cc/index，state是null，那么在微信中访问上面的链接，就会重定向到http://wx.natappvip.cc/index，并且会把code以及state携带到重定向后的url中。
- 获取微信用户的公开信息：
@GetMapping("/userInfo")
public String userInfo(@RequestParam("code") String code,@RequestParam("state") String state){
WxMpOAuth2AccessToken wxMpOAuth2AccessToken = new WxMpOAuth2AccessToken();
try {
wxMpOAuth2AccessToken = wxMpService.oauth2getAccessToken(code);
}catch (WxErrorException e){
log.error("【微信网页授权】{}",e);
}
//获取openId
//String openId = wxMpOAuth2AccessToken.getOpenId();
//获取accessToken
//String accessToken = wxMpOAuth2AccessToken.getAccessToken();
// 获取微信用户的公开信息
WxMpUser user = null;
try {
user = wxMpService.oauth2getUserInfo(wxMpOAuth2AccessToken,null);
}catch (Exception e){
log.info("【获取微信用户信息】获取微信用户信息失败,user={}",user);
}
}解释一下这个方法：这个方法需要搭配第一个授权的方法一起使用，构成如下链接：
http://wx.natappvip.cc/authorize?url=http://wx.natappvip.cc/userInfo&state=null，
用户通过访问该链接后，在上面这个userInfo方法中就可以通过@RequestParam获取到code和state，不过这里我们并没有state并没有传值，所以获取到也没用。获取到了code，就可以获取到wxMpOAuth2AccessToken，获取到了wxMpOAuth2AccessToken就可以获取到openId、accessToken、wxMpUser等信息了。
5、微信扫码：
需求：用户使用微信扫描二维码后，就会跳转到指定的url中，且能获取到扫码用户的信息。
其实这个很好实现，只需要将
http://wx.natappvip.cc/authorize?url=指定的url&state=需要传递的参数
这个链接变成二维码即可。
举个栗子
- 生成二维码：
/** 生成带url的二维码 */
@GetMapping("/generateqrcode4shopauth")
@ResponseBody
public void generateORCode4ShopAuth(HttpServletRequest request,HttpServletResponse response) {
//从session中获取当前店铺信息
Shop shop = (Shop) request.getSession().getAttribute("currentShop");
String content = "{aaashopIdaaa:" + shop.getShopId() + ",aaacreateTimeaaa:" + System.currentTimeMillis + "}";
if(shop != null && shop.getShopId() != null) {
try {
String longUrl = "http://wx.natappvip.cc/wechat/authorize" +
"?url=http://wx.natappvip.cc/shopadmin/addshopauthmap" +
"&state=" + URLEncoder.encode(content,"UTF-8");
//将目标url转成短url
String shortUrl = ShortNetAddressUtil.generateShortUrl(longUrl);
//生成二维码
BitMatrix qRcodeImg = QRCodeUtil.generateQRCodeStream(shortUrl, response);
//将二维码以图片流形式输出到前端
MatrixToImageWriter.writeToStream(qRcodeImg, "png", response.getOutputStream());
}catch(Exception e) {
e.printStackTrace();
}
}
}这个就是生成二维码的方法，在前端页面中直接通过<img src="..."/>标签，src指向这个生成二维码方法的路由即可。注意。state要携带多个参数的话就用上面的方式，先将多个参数拼接成一个字符串content，但是不能直接让state=content，一定要先用encode方法编码一下。另外在附上缩短网址的工具类：
public class ShortNetAddressUtil {
public static CloseableHttpClient httpclient;
static {
httpclient = HttpClients.createDefault();
}
/** 生成短连接信息 */
public static String generateShortUrl(String url) {
try {
HttpPost httpost = new HttpPost("http://suo.im/api.php");
List<NameValuePair> params = new ArrayList<NameValuePair>();
params.add(new BasicNameValuePair("format", "utf-8")); // 编码
params.add(new BasicNameValuePair("url", url)); // 用户名称
httpost.setEntity(new UrlEncodedFormEntity(params, "utf-8"));
HttpResponse response = httpclient.execute(httpost);
String jsonStr = EntityUtils.toString(response.getEntity(), "utf-8");
return jsonStr;
} catch (Exception e) {
e.printStackTrace();
return "Error";
}
}
}- 扫描二维码后发生的事情：
在上面的生成二维码方法中，因为重定向的url是
http://wx.natappvip.cc/shopadmin/addshopauthmap，所以用户使用微信扫描二维码后，就会携带code、state等参数跳到这个路由指向的方法中。该方法如下：
@GetMapping("/exchangeaward")
private String exchangeAward(@RequestParam("code") String code,
@RequestParam("state") String state) {
// 在这里可以通过code获取到openId、微信用户公开信息等
// 解析state中携带的参数
String qrCodeinfo = new String(URLDecoder.decode(state, "UTF-8"));
ObjectMapper mapper = new ObjectMapper();
//wechatInfo类用来接收state携带的参数
WechatInfo wechatInfo = null;
try {
// 将解码后的内容用aaa去替换之前生成二维码时加入的aaa
wechatInfo = mapper.readValue(qrCodeinfo.replace("aaa", "\""), WechatInfo.class);
} catch (Exception e) {
return "fail";
}
return "success";
}该方法中可以通过code获取到微信用户相关信息，可以通过state获取到刚才生成自定义的参数，就可以为所欲为了。
总结:
上面介绍了weixin-java-tools的少部分用法，这只是冰山一角，更多用法请参考在github上搜索binarywang。