返回博文列表

微信开发工具 spring-boot-starter-weixin v1.3.4 发布

把 jfinal-weixin 封装成 Spring Boot Starter,支持多公众号、支付、客服消息、卡券与小程序,v1.3.4 修复了小程序消息推送配置校验问题。

如梦技术 5 分钟
# spring boot # jfinal-weixin

简介 ​

spring-boot-starter-weixin 是 jfinal weixin 的 spring boot starter,这个 starter 是为了方便 Spring boot 用户使用。具体demo请查看:spring-boot-weixin-demo 和 JFinal-weixin文档。

功能 ​

  1. 支持多公众号
  2. 提供公众号登录和用户相关接口
  3. 支持多公众号数据统计
  4. 支持公众号支付
  5. 公众号客服vs消息接口
  6. 公众号摇周边接口
  7. 公众号卡券相关
  8. 微信门店接口
  9. 微信硬件
  10. 小程序等

Jar包依赖(最新) ​

xml
<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>spring-boot-starter-weixin</artifactId>
    <version>1.3.4</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]

配置 ​

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

示例配置 ​

demo 项目中的 application.yml 配置文件。

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

更新说明 ​

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接管。

开源推荐 ​

微信公众号 ​

如梦技术

精彩内容每日推荐!!!