从零搭建开发脚手架使用WxJava快速接入微信公众号

本文转载自微信公众号「Java大厂面试官」，作者laker。转载本文请联系Java大厂面试官公众号。   

长寿网站制作公司哪家好，找成都创新互联！从网页设计、网站建设、微信开发、APP开发、响应式网站设计等网站项目制作，到程序开发，运营维护。成都创新互联于2013年开始到现在10年的时间，我们拥有了丰富的建站经验和运维经验，来保证我们的工作的顺利进行。专注于网站建设就选成都创新互联。

  • 环境准备
    • 1.申请公众号测试账号
    • 2.外网服务准备以及配置
    • 3.常用开发工具及网站
  • 快速开始
    • 依赖导入
    • 配置文件
    • 服务接入认证
  • 常用功能
    • 获取关注用户列表
    • 获取用户信息
    • 微信网页授权
    • 更新用户备注名
    • 创建自定义菜单
    • 删除自定义菜单
    • 获得自定义菜单
    • 其他功能
  • 总结

环境准备

1.申请公众号测试账号

地址：https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

申请公众号及认证流程较慢且繁琐，可在测试账号中体验并测试微信公众号所有高级功能。

直接微信扫描就能申请个公众测试账号，非常方便快捷。

2.外网服务准备以及配置

配置：

“注意: URL配置以及代码中的RequestMapping中的对应关系。

服务接口开发：

用于验证服务接入和接口回调的。

参照快速开始-服务接入认证章节

3.常用开发工具及网站

  • 公众号官网文档
  • 微信公众平台接口调试工具
  • web开发者工具
  • 测试账号申请
  • 微信官方文档

快速开始

使用WxJava来快速开发，它是微信开发 Java SDK，支持微信支付、开放平台、公众号、企业号/企业微信、小程序等的后端开发。

  • Github:https://github.com/Wechat-Group/WxJava
  • Gitee:https://gitee.com/binary/weixin-java-tools

依赖导入

非Spring Boot:

 
 
 
 
    
  
  
  
  
  1.  
    2. 
  
  
  
  
  2.   com.github.binarywang 
    3. 
  
  
  
  
  3.   weixin-java-mp 
    4. 
  
  
  
  
  4.   4.0.0 
    5. 
  
  
  
  
  5.  
    6.

Spring Boot：

 
 
 
 
    
  
  
  
  
  1.  
    2. 
  
  
  
  
  2.    com.github.binarywang 
    3. 
  
  
  
  
  3.    wx-java-mp-spring-boot-starter 
    4. 
  
  
  
  
  4.    4.0.0 
    5. 
  
  
  
  
  5.  
    6.
  • 微信小程序：weixin-java-miniapp
  • 微信支付：weixin-java-pay
  • 微信开放平台：weixin-java-open
  • 公众号(包括订阅号和服务号)：weixin-java-mp
  • 企业号/企业微信：weixin-java-cp

配置文件

 
 
 
 
    
  
  
  
  
  1. # 公众号配置(必填) 
    2. 
  
  
  
  
  2. wx.mp.appId = appId 
    3. 
  
  
  
  
  3. wx.mp.secret = @secret 
    4. 
  
  
  
  
  4. wx.mp.token = @token 
    5. 
  
  
  
  
  5. wx.mp.aesKey = @aesKey 
    6. 
  
  
  
  
  6. # 存储配置redis(可选) 
    7. 
  
  
  
  
  7. wx.mp.config-storage.type = Jedis                     # 配置类型: Memory(默认), Jedis, RedisTemplate 
    8. 
  
  
  
  
  8. wx.mp.config-storage.key-prefix = wx                  # 相关redis前缀配置: wx(默认) 
    9. 
  
  
  
  
  9. wx.mp.config-storage.redis.host = 127.0.0.1 
    10. 
  
  
  
  
  10. wx.mp.config-storage.redis.port = 6379 
    11. 
  
  
  
  
  11. #单机和sentinel同时存在时，优先使用sentinel配置 
    12. 
  
  
  
  
  12. #wx.mp.config-storage.redis.sentinel-ips=127.0.0.1:16379,127.0.0.1:26379 
    13. 
  
  
  
  
  13. #wx.mp.config-storage.redis.sentinel-name=mymaster 
    14. 
  
  
  
  
  14. # http客户端配置 
    15. 
  
  
  
  
  15. wx.mp.config-storage.http-client-type=httpclient      # http客户端类型: HttpClient(默认), OkHttp, JoddHttp 
    16. 
  
  
  
  
  16. wx.mp.config-storage.http-proxy-host= 
    17. 
  
  
  
  
  17. wx.mp.config-storage.http-proxy-port= 
    18. 
  
  
  
  
  18. wx.mp.config-storage.http-proxy-username= 
    19. 
  
  
  
  
  19. wx.mp.config-storage.http-proxy-password= 
    20. 
  
  
  
  
  20. # 公众号地址host配置 
    21. 
  
  
  
  
  21. #wx.mp.hosts.api-host=http://proxy.com/ 
    22. 
  
  
  
  
  22. #wx.mp.hosts.open-host=http://proxy.com/ 
    23. 
  
  
  
  
  23. #wx.mp.hosts.mp-host=http://proxy.com/ 
    24.

服务接入认证

 
 
 
 
    
  
  
  
  
  1. @Api(tags = "微信公众号") 
    2. 
  
  
  
  
  2. @ApiSupport(order = 4) 
    3. 
  
  
  
  
  3. @RequestMapping("/wx") 
    4. 
  
  
  
  
  4. @RestController 
    5. 
  
  
  
  
  5. @Slf4j 
    6. 
  
  
  
  
  6. public class WxController { 
    7. 
  
  
  
  
  7.     @Autowired 
    8. 
  
  
  
  
  8.     WxMpService wxMpService; 
    9. 
  
  
  
  
  9.  
    10. 
  
  
  
  
  10.     /** 
    11. 
  
  
  
  
  11.      * 用户配置 token和url时的服务认证 
    12. 
  
  
  
  
  12.      *  url配置为：http://ip:port/wx 
    13. 
  
  
  
  
  13.      *  如果接收不到微信服务的调用，把这个接口开大点，不要限制GET等 
    14. 
  
  
  
  
  14.      */ 
    15. 
  
  
  
  
  15.     @GetMapping 
    16. 
  
  
  
  
  16.     @ApiOperationSupport(order = 1) 
    17. 
  
  
  
  
  17.     @ApiOperation(value = "服务认证") 
    18. 
  
  
  
  
  18.     public String transfer(String signature, String timestamp, String nonce, String echostr) { 
    19. 
  
  
  
  
  19.         log.info("接收到来自微信服务器的认证消息：signature ：{}，timestamp：{}，nonce：{}，echostr：{}", signature, timestamp, nonce 
    20. 
  
  
  
  
  20.                 , echostr); 
    21. 
  
  
  
  
  21.         if (!wxMpService.checkSignature(timestamp, nonce, signature)) { 
    22. 
  
  
  
  
  22.             log.error("消息不合法"); 
    23. 
  
  
  
  
  23.             return "error"; 
    24. 
  
  
  
  
  24.         } 
    25. 
  
  
  
  
  25.         return echostr; 
    26. 
  
  
  
  
  26.     } 
    27.

“这里的接口地址注意，上面再微信平台配置的URL的对应。

服务接入认证流程图：

到这里就接入成功了。

常用功能

获取关注用户列表

 
 
 
 
    
  
  
  
  
  1. String nextOpenid = null;// 可选，第一个拉取的OPENID，null为从头开始拉取 
    2. 
  
  
  
  
  2. WxMpUserList wxMpUserList = wxMpService.getUserService().userList(nextOpenid); 
    3.

结果：

 
 
 
 
    
  
  
  
  
  1. { 
    2. 
  
  
  
  
  2.     "total": 1, 
    3. 
  
  
  
  
  3.     "count": 1, 
    4. 
  
  
  
  
  4.     "openids": [ 
    5. 
  
  
  
  
  5.       "xxxx" 
    6. 
  
  
  
  
  6.     ], 
    7. 
  
  
  
  
  7.     "nextOpenid": "xxxx" 
    8. 
  
  
  
  
  8.   } 
    9.

获取用户信息

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID(加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同)。公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用之间统一用户帐号的需求，需要前往微信开放平台(open.weixin.qq.com)绑定公众号后，才可利用UnionID机制来满足上述需求。

其他场景获取用户信息可以参考微信网页授权章节

 
 
 
 
    
  
  
  
  
  1. String lang = "zh_CN"; //语言 openId 可以从关注用户列表接口来或者是用户发送消息的fromuser 
    2. 
  
  
  
  
  2. WxMpUser user = wxMpService.getUserService().userInfo(openId, lang); 
    3.

结果：

 
 
 
 
    
  
  
  
  
  1. { 
    2. 
  
  
  
  
  2.    "subscribe": true, 
    3. 
  
  
  
  
  3.    "openId": "xxx", 
    4. 
  
  
  
  
  4.    "nickname": "laker", 
    5. 
  
  
  
  
  5.    "sexDesc": "男", 
    6. 
  
  
  
  
  6.    "sex": 1, 
    7. 
  
  
  
  
  7.    "language": "zh_CN", 
    8. 
  
  
  
  
  8.    "city": "合肥", 
    9. 
  
  
  
  
  9.    "province": "安徽", 
    10. 
  
  
  
  
  10.    "country": "中国", 
    11. 
  
  
  
  
  11.    "headImgUrl": "http://xxx", 
    12. 
  
  
  
  
  12.    "subscribeTime": 1618311163, 
    13. 
  
  
  
  
  13.    "unionId": null, 
    14. 
  
  
  
  
  14.    "remark": "", 
    15. 
  
  
  
  
  15.    "groupId": 0, 
    16. 
  
  
  
  
  16.    "tagIds": [], 
    17. 
  
  
  
  
  17.    "privileges": null, 
    18. 
  
  
  
  
  18.    "subscribeScene": "ADD_SCENE_QR_CODE", 
    19. 
  
  
  
  
  19.    "qrScene": "0", 
    20. 
  
  
  
  
  20.    "qrSceneStr": "" 
    21. 
  
  
  
  
  21.  } 
    22.

微信网页授权

实现第三方微信登录功能。

如果用户在微信客户端中访问第三方网页，公众号可以通过微信网页授权机制，来获取用户基本信息，进而实现业务逻辑。

文档地址：https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html

1.配置网页授权回调域名

在微信公众号请求用户网页授权之前，开发者需要先到公众平台官网中的“开发 - 接口权限 - 网页服务 - 网页帐号 - 网页授权获取用户基本信息”的配置选项中，修改授权回调域名。请注意，这里填写的是域名(是一个字符串)，而不是URL，因此请勿加 http:// 等协议头(即输入：www.laker.com)。

注意事项：

  • 沙盒号(测试号)回调地址支持域名和ip，正式公众号回调地址只支持域名并且域名需使用字母、数字及“-”的组合，须通过ICP备案的验证，不支持端口号及短链。
  • 测试号：找到 网页授权获取用户基本信息>点击修改>设置域名
  • 服务号：找到 开发>接口权限>网页授权获取用户基本信息>>点击修改>设置域名
  • 设置域名不要添加http:// 等协议头

2.微信网页授权 - 流程时序图

3.构造网页授权url

首先构造网页授权url，然后构成超链接让用户点击，例如构建自定义菜单中的跳转URL按钮类型(VIEW)。

 
 
 
 
    
  
  
  
  
  1. WxMpService wxMpService = ...; 
    2. 
  
  
  
  
  2. String url = ...; 
    3. 
  
  
  
  
  3. wxMpService.getOauth2Service().buildAuthorizationUrl(url, WxConsts.OAuth2Scope.SNSAPI_USERINFO, null) 
    4.

4.获得用户基本信息

当用户同意授权后，会回调所设置的url并把authorization code传过来，然后用这个code获得access token，其中也包含用户的openid等信息。

 
 
 
 
    
  
  
  
  
  1. WxMpOAuth2AccessToken wxMpOAuth2AccessToken = wxMpService.getOAuth2Service().getAccessToken(code); 
    2. 
  
  
  
  
  2. WxMpUser wxMpUser = wxMpService.getOAuth2Service().getUserInfo(wxMpOAuth2AccessToken, null); 
    3.

更新用户备注名

 
 
 
 
    
  
  
  
  
  1. wxMpService.getUserService().userUpdateRemark(openid, "测试备注名"); 
    2.

创建自定义菜单

包括新增和修改，修改相当于覆盖之前的菜单。

 
 
 
 
    
  
  
  
  
  1. WxMenu wxMenu = new WxMenu(); 
    2. 
  
  
  
  
  2. // 设置菜单 
    3. 
  
  
  
  
  3. wxMpService.getMenuService().menuCreate(wxMenu); 
    4.

删除自定义菜单

 
 
 
 
    
  
  
  
  
  1. wxMpService.getMenuService().menuDelete(); 
    2.

获得自定义菜单

 
 
 
 
    
  
  
  
  
  1. WxMenu wxMenu = wxMpService.getMenuService().menuGet(); 
    2.

其他功能

可去wiki页查看

  • https://github.com/Wechat-Group/WxJava/wiki
  • https://github.com/Wechat-Group/WxJava/wiki/%E5%85%AC%E4%BC%97%E5%8F%B7%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3

总结

总体来说集成还是比较顺利，但是有几个点还是要重点说下：

环境准备这个很重要，很多文章没有说清楚，都不知道开始要准备什么，这里看到需要一个外网能访问的服务和一个公众号，公众号可以直接使用测试账号。

关于外网服务可以去百度内网穿透，免费的有很多直接拿来用就行。

配置服务接口认证的URL，一定要是能具体到我们的接口的。

网页授权填写域名时，域名不要添加http:// 等协议头 ，直接www.xxx.com 即可。

参考：

https://github.com/Wechat-Group/WxJava

微信官方文档

分享文章：从零搭建开发脚手架使用WxJava快速接入微信公众号
网页地址：http://www.shufengxianlan.com/qtweb/news13/402163.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

Google知识

行业网站建设

成都400电话申请　　 　重庆水土双线托管　　 　app软件定制开发　　 　食品包装设计　　 　云主机　　 　成都包装设计公司　　 　网站建设　　 　简阳网站制作　　 　响应式建站　　 　高端网站设计　　 　消防工程　　 　专业网站设计　　 　成都响应式网站建设　　 　绵阳网站制作　　 　南充主机托管　　 　眉山联通机房　　 　成都标牌标识牌制作公司　　 　成都商城开发　　 　绵阳网站建设　　 　温江网站制作