微信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.cc2、添加依赖:

<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获取到codestate,不过这里我们并没有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。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏NetCore

尝试使用Memcached遇到的狗血问题

乘着有时间,尝试下利用Memcached进行分布式缓存,其中遇到了不少问题及狗血的事情,开篇记录下,希望对您有帮助。 我之前的项目为:Asp.Net MVC4 ...

25550
来自专栏猿天地

Netty-整合Protobuf高性能数据传输

前言 本篇文章是Netty专题的第四篇,前面三篇文章如下: 高性能NIO框架Netty入门篇 高性能NIO框架Netty-对象传输 高性能NIO框架Netty-...

330110
来自专栏帘卷西风的专栏

使用Cmake生成跨平台项目编译解决方案

    项目最近有需求在windows下面运行,我花了几周时间将linux的服务器移植到windows下面,目前已经能够正常运行服务器,目前又有了新需求,两边的...

64820
来自专栏开源优测

[接口测试 - 基础篇] 12 还是要掌握python日志管理模块的

python logging模块介绍 Python的logging模块提供了通用的日志系统,可以方便第三方模块或者是应用使用。这个模块提供不同的...

37780
来自专栏JavaNew

Spring Boot实战:静态资源处理

373110
来自专栏小勇DW3

SpringBoot的自动配置原理过程解析

SpringBoot的最大好处就是实现了大部分的自动配置,使得开发者可以更多的关注于业务开发,避免繁琐的业务开发,但是SpringBoot如此好用的

15430
来自专栏乐百川的学习频道

做一个自动配置JDK环境变量的Powershell脚本

本来想把这篇的内容包括在我的Powershell系列文章之内的,后来写完之后才想起来,这时候我已经复制粘贴到简书、CSDN和SegmentFault三个地方了。...

26850
来自专栏JavaEdge

JVM源码分析之synchronized1 字节码实现2 偏向锁

javap命令生成的字节码中包含 ** monitorenter ** 和 ** monitorexit **指令

9230
来自专栏乐百川的学习频道

Spring学习笔记 Spring Roo 简介

一直以来,Java/Spring开发被认为是笨重的代表,无法快速生成项目原型和骨架。所以,Spring推出了Spring Roo这个项目,帮助我们快速生成项目原...

30170
来自专栏乐沙弥的世界

Linux 内核参数优化(for oracle)

    Oracle 不同平台的数据库安装指导为我们部署Oracle提供了一些系统参数设置的建议值,然而建议值是在通用的情况下得出的结论,并非能完全满足不同的需...

19620

扫码关注云+社区

领取腾讯云代金券