说明

jfinal weixin 的 spring boot starter，这个starter是为了方便boot用户使用。

具体demo请查看：mica-weixin-demo 和 JFinal-weixin文档

开源推荐

• Spring boot 微服务，高效开发之 mica 工具集：https://gitee.com/596392912/mica
• Avue 一款基于vue可配置化的神奇框架：https://gitee.com/smallweigit/avue
• pig 宇宙最强微服务（架构师必备）：https://gitee.com/log4j/pig
• SpringBlade 完整的线上解决方案（企业开发必备）：https://gitee.com/smallc/SpringBlade
• IJPay 支付SDK让支付触手可及：https://gitee.com/javen205/IJPay

兼容性

版本说明

version	spring boot version	java version
3.0.0	3.x	17
2.1.2	1.x ~ 2.x	1.8

Jar包依赖（最新）

<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-weixin</artifactId>
    <version>3.0.0</version>
</dependency>

使用

消息

公众号

1. 继承DreamMsgControllerAdapter，实现需要重写的消息。

2. 类添加注解@WxMsgController，注解value为你的消息地址，使用/weixin/wx，已经组合[@RequestMapping和@Controller]

小程序

1. 继承DreamWxaMsgController，实现需要重写的消息。

2. 添加注解@WxMsgController，注解value为你的消息地址，使用/weixin/wxa，已经组合[@RequestMapping和@Controller]

Api

• 类添加@WxApi，注解value为你的消息地址，使用/weixin/api，已经组合[@RequestMapping和@Controller]

access token cache

您可以配置 mica-caffeine 或 mica-redis 实现 access token 的缓存。

配置

配置项	默认值	说明
dream.weixin.access-token-cache	dreamWeixinCache#7100s	缓存名，需要开启spring cache
dream.weixin.app-id-key	appId	多公众号参数名，如：/weixin/wx?appId=xxx
dream.weixin.dev-mode	false	开发模式
dream.weixin.url-patterns	/weixin/*	weixin 消息处理spring拦截器url前缀
dream.weixin.wx-configs	公众号的配置	多公众号配置
dream.weixin.wxa-configs	小程序配置	小程序配置

注意：

• demo中的application.yml

dream:
  weixin:
    dev-mode: true
    wx-configs:
      - appId: wx9803d1188fa5fbda
        appSecret: db859c968763c582794e7c3d003c3d87
      - appId: wxc03edcd008ad1e70
        appSecret: 11ed9e2b8e3e3c131e7be320a42b2b5a
        token: 123456
        encodingAesKey: xxx
        messageEncrypt: true
    wxa-configs:
      - app-id: wx4f53594f9a6b3dcb
        app-secret: eec6482ba3804df05bd10895bace0579

• access-token-cache建议配置有效时间7100秒。

自定义公众号vs小程序配置

注意：实现 WxConfigLoader 即可，可以从数据库中获取。

/**
 * 微信配置加载器，用于自定义实现
 *
 * @author L.cm
 */
@Configuration
public class WxConfigDatabaseLoader implements WxConfigLoader {

	@Override
	public List<ApiConfig> loadWx() {
		// 公众号
		ApiConfig wxConf = new ApiConfig();
		wxConf.setAppId("wxc03edcd008ad1e70");
		wxConf.setAppSecret("11ed9e2b8e3e3c131e7be320a42b2b5a");
		wxConf.setToken("123456");
		return Collections.singletonList(wxConf);
	}

	@Override
	public List<WxaConfig> loadWxa() {
		// 小程序
		return Collections.emptyList();
	}
}

更新说明

2022-12-11 3.0.0

• 升级 java 到 java17。
• 升级 Spring boot 到 3.x。
• 升级 jfinal 到 5.0.8。
• 升级 lombok 到 1.18.24。

2021-11-22 2.1.2

• 微调，兼容更多版本，测试 Spring boot 2.6.0 兼容性。
• 升级 jfinal 到 4.9.17。
• 升级 jfinal-weixin 到 3.4，支持草稿箱和发布接口。
• 升级 lombok 到 1.18.22。

2021-07-14 2.1.1

• 升级 jfinal-weixin 到 3.2。

2021-04-27 2.1.0

• Spring cache 对象改为每次读取， caffeine 会刷新，照成引用为 null。
• 升级 jfinal-weixin 到 3.1。

2020-03-20 2.0.6

• 升级 jfinal-weixin 到 3.0。

2020-12-16 2.0.5

• 升级 jfinal-weixin 到 2.9，修复素材下载流被关闭的问题。

2020-12-13 2.0.4

• 调整 WxConfigLoader 方便自定义 config 存储更多属性。

2020-10-13 2.0.3

• 升级 jfinal-weixin 到 2.8

2020-09-14 2.0.2

• 升级 jfinal-weixin 到 2.7

2020-07-07 2.0.1

• 修复 java 编译版本，采用 java8。

2020-07-05 v2.0.0

• 改名为 mica-weixin，提升 mica 品牌。
• 内置 @EnableCaching。
• 更改缓存名为 dreamWeixinCache#7100s，方便和 mica-redis 一起使用。
• 升级 jfinal、jfinal-weixin 版本。

2020-05-01 v1.4.0

• 支持多小程序消息，注意： yml 配置 key 由 dream.weixin.wxa-config 改为 dream.weixin.wxa-configs。
• 支持自定义公众号和小程序配置加载，可用于从数据库等加载配置。
• 升级 jfinal、jfinal-weixin 版本。

2019-08-01 v1.3.6

• 升级 jfinal、jfinal-weixin、okhttp 版本。

2019-03-17 v1.3.5

• 解决单公众号下消息报错

2019-03-17 v1.3.4

• 解决小程序，启用并设置消息推送配置校验不通过的问题。

2019-03-07 v1.3.3

• 升级到 gradle 5.2.1。
• 升级 JFinal 到 3.6。
• 升级 JFinal Weixin 到 2.3。
• 使用 mica-auto 生成 spring.factories、devtools 配置。
• InMsg 消息对象采用 request 存储，去掉 @WxMsgController 中的 Scope 配置，将消息控制器还原为单例。

2018-12-23 v1.3.2

• 修复 SpringAccessTokenCache 没有配置的问题，感谢 qq:A梦的小C 反馈。

2018-12-23 v1.3.1

• WeixinAppConfig 改为实现 SmartInitializingSingleton。

2018-05-03 v1.3.0

• 弃用@EnableDreamWeixin，导入jar包即可享用。
• 将消息路由改为spring接管。

微信公众号

精彩内容每日推荐！