Springboot借助微信开发工具weixin.java.tools完成微信授权登录，发送模板消息，发送客服消息，拉取用户信息列表功能

2024-02-04 05:59
文章标签 java 模板 springboot 功能 微信 登录 spring 完成 用户 授权 列表 消息 tools 信息 发送 开发工具 借助 客服 weixin 拉取

本文主要是介绍Springboot借助微信开发工具weixin.java.tools完成微信授权登录，发送模板消息，发送客服消息，拉取用户信息列表功能，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

公司要求实现微信公众号的一些功能，本人经过查阅资料发现使用weixin.java.tools对微信进行开发十分便捷，遂将完成的几个小功能贴出来进行记录。

主要接入步骤：

  • 通过ngrok获取动态测试域名。(如果有的话可以用自己的域名，如果想要免费使用域名的话建议使用ngrok内网穿透工具。它的缺点是每次运行ngrok都会变更域名，免费的要求也不要这么多啦)
  • 申请测试公众号。(想要使用微信服务器提供的所有接口的话需要认证公众号，认证公众号一年掏三百多这里不建议)
  • 将微信端与本地服务器端进行对接。

开发工具：idea

其他工具 ：ngrok（本文含下载链接）,测试公众号（官网注册）

1.注册公众号：

2.运行ngrok内网穿透工具

输入命令行：ngrok 8080（如不行输入ngrok http 8080）

若运行成功则会动态分配一个域名

3.创建Springboot+Maven项目（如不会的自行百度）

4.引入Maven依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.1.6.RELEASE</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.example</groupId><artifactId>weixin</artifactId><packaging>jar</packaging><version>0.0.1-SNAPSHOT</version><name>weixin</name><description>Demo project for Spring Boot</description><properties><java.version>1.8</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>com.github.binarywang</groupId><artifactId>weixin-java-mp</artifactId><version>3.4.9.B</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.16.10</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-test</artifactId></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-test</artifactId><version>5.1.8.RELEASE</version></dependency><dependency><groupId>net.minidev</groupId><artifactId>json-smart</artifactId><version>2.3</version></dependency><dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.31</version></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

其中引入的weixin-java-mp依赖就是我们今天的主角，weixin-java-tools是大神binarywang写的开发工具包，有了它我们将减少很多底层的工作量，如token的加密，accesstoken的周期管理，传入传出数据的封装与解析等都不用我们亲自动手完成：

<dependency><groupId>com.github.binarywang</groupId><artifactId>weixin-java-mp</artifactId><version>3.4.9.B</version>
</dependency>

 

5.进行微信服务器端与本地服务器端的对接工作（代码模块正式开始）

配置文件

server.port = 8080
server.servlet.context-path = /weixin
mpAppId=        #公众号id
mpAppSecret=    #公众号密匙
token=smk666

其中公众号的信息在测试号里面都有：

微信服务器对接代码块

package com.example.demo.web;@SpringBootApplication
@Controller
public class LoginController {@Value("${token}")//获取配置文件的值private String token;@RequestMapping(value = "/wx",method= RequestMethod.GET)public void login(HttpServletRequest request, HttpServletResponse response) throws IOException {System.out.println(token);//微信服务器get传递的参数String signature = request.getParameter("signature");//微信加密签名String timestamp = request.getParameter("timestamp");//时间戳String nonce = request.getParameter("nonce");//随机数String echostr = request.getParameter("echostr");//随机字符串（用来进行返回）//微信工具类WxMpService wxService=new WxMpServiceImpl();//注入token的配置参数/*** 生产环境 建议将WxMpInMemoryConfigStorage持久化*/WxMpInMemoryConfigStorage wxConfigProvider=new WxMpInMemoryConfigStorage();//注入token值wxConfigProvider.setToken(token);wxService.setWxMpConfigStorage(wxConfigProvider);boolean flag=wxService.checkSignature(timestamp, nonce, signature);System.out.println(flag);PrintWriter out=response.getWriter();if(flag){out.print(echostr);}out.close();}
}

写完后在公众号测试号端进行测试，需要重点说明的是URL。

如以下URL：http://www.wx.fzy365.online（域名）+/weixin/wx（对接接口的地址）

测试成功后我们进行下一步

6.模板推送功能的实现

新增测试模板

其中模板ID用于我们后台接口的调用，模板内容为键值对形式，key1、key2为传入参数的键值且后缀加.DATA。

示例：姓名 {{key1.DATA}}

获取Accesstoken

调用微信接口必须得获取调用权限，其中Accesstoken就是该权限的凭证，两小时刷新一次，weixin.java.tool中已经封装好相关的管理方法，这里我将获取Accesstoken部分的代码单独写成一个工具类以便调用：

package com.example.demo.Util;import me.chanjar.weixin.mp.api.WxMpInMemoryConfigStorage;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.api.impl.WxMpServiceImpl;
import java.io.IOException;
import java.util.Properties;/*** @说明：* @创建人：孙明康* @创建时间：2019/8/1 15:57*/
public class GetAccessTokenUtil {/*** @Description:根据微信公众号id，secret获取access_token* @return: wxMpService（封装好的服务，内含调用微信接口必须的access_token）* @author: 孙明康 2019/8/3 17:06*/private static Properties properties;public static WxMpService getAccessToken() {//获取配置信息中的公众号信息if (properties==null) {properties = new Properties();ClassLoader loader = Thread.currentThread().getContextClassLoader();try {properties.load(loader.getResourceAsStream("application.properties"));} catch (IOException e) {e.printStackTrace();}}String mpAppId = properties.getProperty("mpAppId");String mpAppSecret =properties.getProperty("mpAppSecret");WxMpInMemoryConfigStorage wxStorage = new WxMpInMemoryConfigStorage();wxStorage.setAppId(mpAppId);wxStorage.setSecret(mpAppSecret);WxMpService wxMpService = new WxMpServiceImpl();wxMpService.setWxMpConfigStorage(wxStorage);return wxMpService;}}

模版消息推送功能的代码实现

传入值为json格式，注释@param里面有写（后面的controller同理）：

package com.example.demo.web;import java.util.List;/*** @说明：模版消息推送*/
@CrossOrigin
@RestController
public class PushController {/*** @Description:模板消息推送* @param:目标用户id，推送模板id，模板信息列表：{'openid':'oopKVw3CjDqczvJ9fLSecbYZYl14','templateId':'eBcuETQZjL_R4ZzLd6L9rIehSiSGGCtWe_xpWqBkMnI','returnUrl':'www.baidu.com/','wxMpTemplateDataList':[{'name':'key1','value':'孙明康','color':'#FF00FF'},{'name':'key2','value':'您的服务器有新的预警情况哦','color':'#FF00FF'}]}* @return:状态返回值：{"statusMessage":true}* @author: 孙明康 2019/8/3 16:20*/ @PostMapping("/push")//正式发布public ApiResult push(String jsonString) throws WxErrorException {public ApiResult push(@RequestBody String jsonString) throws WxErrorException {String openid = null;String templateId= null;String returnUrl = null;String templateJsonArray = null;List<WxMpTemplateData> wxMpTemplateDataList = null;JSONObject jsonObj = JSONObject.parseObject(jsonString);if(null != jsonObj) {openid = jsonObj.getString("openid");templateId = jsonObj.getString("templateId");returnUrl = jsonObj.getString("returnUrl");//JSONArray templateJsonArray = jsonObj.getJSONArray("wxMpTemplateDataList");templateJsonArray = jsonObj.getString("wxMpTemplateDataList");wxMpTemplateDataList=JSONArray.parseArray(templateJsonArray,WxMpTemplateData.class);}//access_token为获取的接口调用takenWxMpService access_token = GetAccessTokenUtil.getAccessToken();//设置推送对象信息WxMpTemplateMessage templateMessage = WxMpTemplateMessage.builder()//.toUser(openid)//要推送的用户openid.templateId(templateId)//模版id.url(returnUrl)//点击模版消息要访问的网址.build();// 模板中的map值templateMessage.addData(new WxMpTemplateData(name2, value2, color2));String name = null;String value = null;String color = null;System.out.println("获取templateId的值----"+templateId);System.out.println("获取openid的值----"+openid);System.out.println("获取returnUrl的值----"+returnUrl);for(int i = 0;i < wxMpTemplateDataList.size(); i ++){WxMpTemplateData  wxMpTemplateDataEx =  wxMpTemplateDataList.get(i);name = wxMpTemplateDataEx.getName();value = wxMpTemplateDataEx.getValue();color = wxMpTemplateDataEx.getColor();templateMessage.addData(new WxMpTemplateData(name, value, color));}boolean statusMessage = true;try {//调用String zhaungtai = access_token.getTemplateMsgService().sendTemplateMsg(templateMessage);System.out.println("若传输成功返回的状态是"+zhaungtai);} catch (Exception e) {System.out.println("推送失败：" + e.getMessage());statusMessage = false;e.printStackTrace();}finally {JSONObject jsonObject = new JSONObject();jsonObject.put("statusMessage",statusMessage);return ResultApiUtils.getSuccessResult(jsonObject);}}}

7.客服信息功能（主动向用户发送信息）功能的代码实现

这个功能比较鸡肋，如果客户在48小时之内没有跟你的公众号说过话就没法调用。

package com.example.demo.web;/*** @说明：主动发送消息（客服消息）* @创建人：孙明康* @创建时间：2019/8/2 14:30*/
@CrossOrigin
@RestController
public class KefuMessageController {/*** @Description:微信测试账号推送* @param:用户id及向用户发送的具体消息{openid:'oopKVw3CjDqczvJ9fLSecbYZYl14',content:'测试:\n超链接：<a href="http://www.4399.com/">预警情况</a>'}* @return:状态返回值：{"statusMessage":true}* @author: 孙明康 2019/8/3 16:47*/@PostMapping("/kefu")// 正式发布public ApiResult kefu(String jsonString) {public ApiResult kefu(@RequestBody String jsonString) {String openid = null;String content = null;JSONObject jsonObj = JSONObject.parseObject(jsonString);if(null != jsonObj) {openid = jsonObj.getString("openid");content = jsonObj.getString("content");}//access_token为获取的接口调用accesstaken（接口自动刷新）WxMpService access_token = GetAccessTokenUtil.getAccessToken();//设置推送的具体信息WxMpKefuMessage message = new WxMpKefuMessage();message.setMsgType(WxConsts.KefuMsgType.TEXT);message.setToUser(openid);//测试:\n超链接：<a href="http://www.4399.com/">预警情况</a>message.setContent(content);boolean statusMessage = true;try {//getAccessTokenUtil.getAccessToken()用来设置accesstokenaccess_token.getKefuService().sendKefuMessage(message);} catch (Exception e) {System.out.println("推送失败：" + e.getMessage());statusMessage = false;e.printStackTrace();}finally {JSONObject jsonObject = new JSONObject();jsonObject.put("statusMessage",statusMessage);return ResultApiUtils.getSuccessResult(jsonObject);}}
}

8.客户信息列表的拉取

这里我调用了两个微信服务器提供的接口，分别为客户openID的批量拉取接口、单个客户信息的获取接口。

package com.example.demo.web;/*** @说明：* @创建人：孙明康* @创建时间：2019/8/2 15:16*/
@CrossOrigin
@RestController
public class WxUserController {/*** @Description:从微信端获取用户ID和个人信息* @param:拉取所有用户：{next_openid:''}or从该id向下进行拉取（不包含改id）：{next_openid:'oopKVw10zjn0cqTCapx1wKY9WYF8'}* @return:用户信息列表userList：[{"subscribe":true,"openId":"oopKVw3CjDqczvJ9fLSecbYZYl14","nickname":"孙明康","sexDesc":"男","sex":1,"language":"zh_CN","city":"珠海","province":"广东","country":"中国","headImgUrl":"http://thirdwx.qlogo.cn/mmopen/1kc9BKglZaKic1etEeibLCvia5qSaz7tO5MePZe7BPtTxibXcWPRc6KMeFa7KatdW8Sm9BncY54vbdxWVvEwJO6Hbxy42q7z0HuC/132","subscribeTime":1564645086,"remark":"","groupId":0,"tagIds":[],"subscribeScene":"ADD_SCENE_QR_CODE","qrScene":"0","qrSceneStr":""}]* @author: 孙明康 2019/8/2 15:21*/@GetMapping("/wxUser")//正式发布public ApiResult wxUser(String jsonString) throws WxErrorException {public ApiResult wxUser(@RequestBody String jsonString) throws WxErrorException {String next_openid = "";JSONObject jsonObj = JSONObject.parseObject(jsonString);if(null != jsonObj) {next_openid = jsonObj.getString("next_openid");}//access_token为获取的接口调用accesstaken（接口自动刷新）WxMpService access_token = GetAccessTokenUtil.getAccessToken();//获取存储在微信端的用户个人信息WxMpUserList wxUserList = access_token.getUserService().userList(next_openid);//获取用户信息List<WxMpUser> userList = new ArrayList();for(String userOpenId : wxUserList.getOpenids()) {String lang = "zh_CN"; //语言WxMpUser userMessage = access_token.getUserService().userInfo(userOpenId, lang);System.out.println("用户的个人信息：——————" + userMessage);userList.add(userMessage);}System.out.println("用户信息列表：——————" + userList);Map<String, Object> resultMap = new HashMap<>();resultMap.put("userList",userList);return ResultApiUtils.getSuccessResult(resultMap);}
}

9.一些封装json的类

APIResult

package com.example.demo.entity;/*** @说明：* @创建人：孙明康* @创建时间：2019/8/3 10:21*/
//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//import java.io.Serializable;
import java.util.Calendar;
import java.util.Date;
import java.io.Serializable;
import java.util.Calendar;
import java.util.Date;public class ApiResult implements Serializable {private static final long serialVersionUID = -7595446147358370950L;private int status;private String message;private Object data;private Date requesttime = Calendar.getInstance().getTime();public ApiResult() {}public Date getRequesttime() {return this.requesttime;}public ApiResult setRequesttime(Date requesttime) {this.requesttime = requesttime;return this;}public int getStatus() {return this.status;}public ApiResult setStatus(int status) {this.status = status;return this;}public String getMessage() {return this.message;}public ApiResult setMessage(String message) {this.message = message;return this;}public Object getData() {return this.data;}public ApiResult setData(Object data) {this.data = data;return this;}
}

ResultApiUtils

package com.example.demo.entity;/*** @说明：* @创建人：孙明康* @创建时间：2019/8/3 10:24*/
//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//import com.alibaba.fastjson.JSONObject;
import org.springframework.http.HttpStatus;
import com.example.demo.entity.ApiResult;public class ResultApiUtils {private static final String DEFAULT_SUCCESS_MESSAGE = "success";private static final String DEFAULT_FAIL_MESSAGE = "fail";public ResultApiUtils() {}public static ApiResult getDefaultResult() {return new ApiResult();}public static ApiResult getSuccessResult() {return (new ApiResult()).setStatus(HttpStatus.OK.value()).setMessage("success");}public static ApiResult getSuccessResult(Object data) {return (new ApiResult()).setStatus(HttpStatus.OK.value()).setMessage("success").setData(data);}public static ApiResult getSuccessResult(int statusCode, String message, Object data) {return null == message?(new ApiResult()).setStatus(statusCode).setMessage("success").setData(data):(null == data?(new ApiResult()).setStatus(statusCode).setMessage(message):(new ApiResult()).setStatus(statusCode).setMessage(message).setData(data));}public static ApiResult getFailResult() {return (new ApiResult()).setStatus(HttpStatus.BAD_REQUEST.value()).setMessage("fail");}public static ApiResult getFailResult(String message) {return (new ApiResult()).setStatus(HttpStatus.BAD_REQUEST.value()).setMessage(message);}public static ApiResult getFailResult(int statusCode, String message) {return null == message?(new ApiResult()).setStatus(statusCode).setMessage("success"):(new ApiResult()).setStatus(statusCode).setMessage(message);}public static ApiResult getFailResult(int statusCode, String message, Object data) {return null == message?(new ApiResult()).setStatus(statusCode).setMessage("success").setData(data):(null == data?(new ApiResult()).setStatus(statusCode).setMessage(message):(new ApiResult()).setStatus(statusCode).setMessage(message).setData(data));}public static String resultToJson(ApiResult apiResult) {return JSONObject.toJSONString(apiResult);}
}

10.测试

好不容易就都写完啦，这里就展示一个模板消息推送接口的测试，其余测试同理。

PushControllerTest

package com.example.demo.Test;/*** @说明：* @创建人：孙明康* @创建时间：2019/8/1 16:51*/
import com.example.demo.entity.ApiResult;
import com.example.demo.web.PushController;
import me.chanjar.weixin.common.error.WxErrorException;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;import static org.junit.Assert.*;@RunWith(SpringRunner.class)
@SpringBootTest
public class PushControllerTest {@AutowiredPushController pushController;@Testpublic void push() throws WxErrorException {ApiResult status=pushController.push("{'openid':'oopKVw3CjDqczvJ9fLSecbYZYl14','templateId':'eBcuETQZjL_R4ZzLd6L9rIehSiSGGCtWe_xpWqBkMnI','returnUrl':'www.baidu.com/','wxMpTemplateDataList':[{'name':'key1','value':'孙明康','color':'#FF00FF'},{'name':'key2','value':'您的服务器有新的预警情况哦','color':'#FF00FF'}]}");System.out.println(status.getData());}
}

11.小结

到这里本次微信接口demo的编写就全部完成辽，感觉目前网上面关于weixin.java.tool工具包的介绍不是很多，如果想自学的话建议去GitHub上面直接搜开发文档看。

这篇关于Springboot借助微信开发工具weixin.java.tools完成微信授权登录，发送模板消息，发送客服消息，拉取用户信息列表功能的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/676522。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
Security OAuth2 单点登录流程

Security OAuth2 单点登录流程

单点登录（英语：Single sign-on，缩写为 SSO），又译为单一签入，一种对于许多相互关连，但是又是各自独立的软件系统，提供访问控制的属性。当拥有这项属性时，当用户登录时，就可以获取所有系统的访问权限，不用对每个单一系统都逐一登录。这项功能通常是以轻型目录访问协议（LDAP）来实现，在服务器上会将用户信息存储到LDAP数据库中。相同的，单一注销（single sign-off）就是指
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
大模型研发全揭秘：客服工单数据标注的完整攻略

大模型研发全揭秘：客服工单数据标注的完整攻略

在人工智能（AI）领域，数据标注是模型训练过程中至关重要的一步。无论你是新手还是有经验的从业者，掌握数据标注的技术细节和常见问题的解决方案都能为你的AI项目增添不少价值。在电信运营商的客服系统中，工单数据是客户问题和解决方案的重要记录。通过对这些工单数据进行有效标注，不仅能够帮助提升客服自动化系统的智能化水平，还能优化客户服务流程，提高客户满意度。本文将详细介绍如何在电信运营商客服工单的背景下进行
阅读更多...
W外链微信推广短连接怎么做？

W外链微信推广短连接怎么做？

制作微信推广链接的难点分析 一、内容创作难度 制作微信推广链接时，首先需要创作有吸引力的内容。这不仅要求内容本身有趣、有价值，还要能够激起人们的分享欲望。对于许多企业和个人来说，尤其是那些缺乏创意和写作能力的人来说，这是制作微信推广链接的一大难点。 二、精准定位难度 微信用户群体庞大，不同用户的需求和兴趣各异。因此，制作推广链接时需要精准定位目标受众，以便更有效地吸引他们点击并分享链接
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2