mica-weixin 使用文档

说明

Mica Maven release

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

具体demo请查看:mica-weixin-demoJFinal-weixin文档

开源推荐

兼容性

支持 Spring boot 1.x 和 2.x

Jar包依赖(最新)

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

使用

消息

公众号

  • 继承DreamMsgControllerAdapter,实现需要重写的消息。
  • 类添加注解@WxMsgController,注解value为你的消息地址,使用/weixin/wx,已经组合[@RequestMapping和@Controller]

小程序

  • 继承DreamWxaMsgController,实现需要重写的消息。
  • 添加注解@WxMsgController,注解value为你的消息地址,使用/weixin/wxa,已经组合[@RequestMapping和@Controller]

Api

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

access token cache

您可以配置 mica-caffeinemica-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 公众号

如梦技术

精彩内容每日推荐!!!