介绍

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

消息处理器和Api接口处理器中可直接@Autowired spring bean,完全使用Spring习惯进行开发。

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

使用

Jar包依赖

<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>spring-boot-starter-weixin</artifactId>
    <version>1.2.0</version>
</dependency>

说明: 依赖spring-boot-starter-aop

启用微信

@EnableDreamWeixin

消息

公众号

  1. 继承MsgControllerAdapter,实现需要重写的消息。

  2. 添加注解@WxMsgController,注解value为你的消息地址,使用/weixin/wx

小程序

  1. 继承WxaMsgController,实现需要重写的消息。

  2. 添加注解@WxMsgController,注解value为你的消息地址,使用/weixin/wxa

Api

  1. 使用传统的spring的控制器即可

  2. 添加@WxApi注解

配置

配置项 默认值 说明
dream.weixin.access-token-cache dreamWeixinCache 缓存名,需要开启spring cache
dream.weixin.app-id-key appId 多公众号参数名,如:/weixin/wx?appId=xxx
dream.weixin.dev-mode false 开发模式
dream.weixin.url-patterns /weixin/* JFinal-weixin 过滤器url前缀
dream.weixin.wx-configs 公众号的配置 多公众号配置
dream.weixin.wxa-config 小程序配置 小程序配置

注意

  • demo中的application.yml
    dream:
    weixin:
      dev-mode: true
      wx-configs:
        - appId: wx9803d1188fa5fbda
          appSecret: db859c968763c582794e7c3d003c3d87
        - appId: wxc03edcd008ad1e70
          appSecret: 11ed9e2b8e3e3c131e7be320a42b2b5a
          token: 123456
      wxa-config:
        appid: wx4f53594f9a6b3dcb
        appSecret: eec6482ba3804df05bd10895bace0579
    
  • cache使用spring的cache,需要@EnableCaching开启。
  • access-token-cache建议配置有效时间7100秒。