微信 SDK
项目简介
本项目使用 spring-boot-starter 的形式封装了微信公众平台的常用 API，延续了 spring-boot 的风格，以最少化配置项为目标，除了 appid, secret 等基础配置项之外，你不需要做任何其他设置，系统提供的默认设置已经能覆盖大部分的使用情况；当然，总还是会有些特殊需求不能被覆盖到，所以系统也对外提供了接口，用户可以实现对应模块的接口来覆盖系统的默认设置。
配置
前提
- 本项目基于 Spring Boot，所以要使用本项目，必须引入 Spring Boot 的相关依赖
- JDK 1.8 及以上
引入 maven 依赖
<dependency>
<groupId>me.javaroad.openapi.wechat</groupId>
<artifactId>wechat-spring-boot-starter</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>因为目前是 snapshot 版本，所以还需要引入 snapshot repository :
<repositories>
<repository>
<snapshots />
<id>sonatype snapshots</id>
<url>https://oss.sonatype.org/content/repositories/snapshots/</url>
</repository>
</repositories>基础配置
在 application.yml 中新增以下配置：
weixin:
mp:
endpoint:
# 微信回调地址，默认为 /weixin/callback，如需自定义，请修改以下配置项
callback-url: /weixin/callback
security:
# 微信后台配置的 token
token: 1234567890
# 微信后台配置的消息加解密 aeskey
encodingAesKey: abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG
# #############################################################
# 微信 access token 过期刷新阈值，计算方法：
# 当前时间 - (获得token时间 + token 有效期 + 阈值) < 0 则刷新 token
# 默认为 token 失效前 5 分钟刷新
# #############################################################
refresh-token-threshold: 300
auth:
# APPID
appid: appid
# APP secret
secret: secret完成以上两项配置后，已经可以成功接入微信。接下来，你可以根据自身需求阅读对应模块的文档，实现自己的业务逻辑。
目录
- 获取 AccessToken
- 消息管理
- 接收普通消息
- 接收事件推送
- 被动回复消息
- 消息加解密
- 获取微信服务器 IP
- 客服消息
- 群发接口和原创校验
- 模板消息接口
- 一次性订阅消息
- 素材管理
- 图文消息留言管理
- 用户管理
- 账号管理
- 数据统计
- 微信卡卷
- ... TODO
问题及建议
若是对于本项目有任何问题或建议,请提 Issue 。