简介
spring-boot-starter-weixin
是 jfinal weixin
的 spring boot starter
,这个 starter
是为了方便 Spring boot
用户使用。具体demo请查看:spring-boot-weixin-demo 和 JFinal-weixin文档。
源码地址
https://gitee.com/596392912/mica-weixin
Jar包依赖(最新)
<dependency> <groupId>net.dreamlu</groupId> <artifactId>mica-weixin</artifactId> <version>2.0.2</version> </dependency>
使用
消息
公众号
继承
DreamMsgControllerAdapter
,实现需要重写的消息。
类添加注解
@WxMsgController
,注解value为你的消息地址,使用/weixin/wx,已经组合[@RequestMapping和@Controller]
小程序
继承
DreamWxaMsgController
,实现需要重写的消息。
添加注解
@WxMsgController
,注解value为你的消息地址,使用/weixin/wxa,已经组合[@RequestMapping和@Controller]
Api接口
类添加
@WxApi
,注解value为你的消息地址,使用/weixin/api,已经组合[@RequestMapping和@Controller]
配置
配置项 | 默认值 | 说明 |
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-config | 小程序配置 | 小程序配置 |
示例配置
demo 项目中的 application.yml
配置文件。
cache使用spring的cache,需要
@EnableCaching
开启。
access-token-cache
建议配置有效时间7100秒。
更新说明
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接管。