SpringBoot整合WxJava开启消息推送的实现

2024-04-02 19:55

短信预约 -IT技能 免费直播动态提醒

1、引入 WxJava 依赖

<!-- web支持 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 微信小程序开发 -->
<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>wx-java-miniapp-spring-boot-starter</artifactId>
    <version>4.2.0</version>
</dependency>

2、申请微信小程序

https://mp.weixin.qq.com/

使用邮箱注册一个微信小程序账号，一个邮箱仅能注册一个微信小程序账号

3、微信小程序配置信息

登录微信小程序后，在：开发–》开发管理找到小程序的基本信息：

在这里插入图片描述

将 AppID，AppSecret 配置在项目配置文件中

# 微信开发配置
wx:
  # 微信小程序开发
  miniapp:
      appid: xxxxxxxxxx
      secret: xxxxxxxxxx
      # 配置消息推送需要
      token: 
      aesKey: 
      msgDataFormat: 
      # 存储类型
      config-storage:
        type: redistemplate

配置了 config-storage.type 决定我们获取的 AccessToken 存放的位置，默认存放在本地缓存中，可选存在 redis 中，我们可以存放在 redis 中进行可视化管理。

4、消息推送配置

在开发管理页面往下滑，找到 “消息推送” 模块，启用 “消息推送”

在这里插入图片描述

这里我已经启用了，我们点击修改，重新配置我们的消息推送配置

在这里插入图片描述

1、URL，即微信推送消息的时候，调用你的 api 接口地址

2、Token，这个为自定义 token，做参数校验使用的

3、EncodingAESKey，消息加密密钥，我们可以选择随机生成

4、消息加密方式，我们为了数据安全，选择 “安全模式”

5、数据格式，我们选择 JSON 或 XML 都行

对应的后台配置文件配置为：

# 微信开发配置
wx:
  # 微信小程序开发
  miniapp:
      appid: xxxxxxxxxx
      secret: xxxxxxxxxx
      # 配置消息推送需要
      token: asurplus_token
      aesKey: PeQ3KmxFbhko0FdR5WG6Hn8wOuKuhQfr6ZNl7ykRGaM
      msgDataFormat: JSON
      # 存储类型
      config-storage:
        type: redistemplate

5、接收消息推送的 API

import cn.binarywang.wx.miniapp.api.WxMaService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@Slf4j
@RestController
@RequestMapping("wx/ma/welcome")
public class WxMaMsgController {

    @Autowired
    private WxMaService wxMaService;

    
    @GetMapping
    public String doGet(String signature, String timestamp, String nonce, String echostr) {
        // 消息合法
        if (wxMaService.checkSignature(timestamp, nonce, signature)) {
            log.info("-------------微信小程序消息验证通过");
            return echostr;
        }
        // 消息签名不正确，说明不是公众平台发过来的消息
        return null;
    }
}

第四步配置的 URL 应为：http://lizhou.4kb.cn/wx/ma/welcome

其中，lizhou.4kb.cn 为你的域名，没有域名的参考文章：使用内网穿透工具Ngrok代理本地服务