1. 前言
目前,使用 JFinal 做微信公众平台和微信小程序的开发者越来越多,JFinal 与 JFinal Weixin SDK 也在紧跟趋势,快速迭代,目前已经支持公众平台服务号、订阅号、微信小程序的多账号管理。
本课将带你彻底搞定 JFinal 微信小程序的快速集成。
2. JFinal Weixin 项目简介
JFinal Weixin 是基于 JFinal 的微信公众号极速开发 SDK。
Gitee 地址:
Star 超 2.9K,开源中国 GVP 项目,开发者众多。
JFinal Weixin SDK 封装了公众平台、微信小程序以及微信支付的绝大多数 API,提供标准可继承的 Controller 和内置的 Interceptor,使其可方便快捷地用于开发公众平台、小程序、支付等业务开发。
3. 创建项目开发环境
3.1 项目环境依赖
IDE:Eclipse + JBolt 插件 (使用 IDEA 的同学请谅解)+微信开发者工具
框架:JFinal 4.8、JFinal Weixin 2.5
服务器:JFinal-undertow 2.0
数据库:MySQL
数据库连接池:Druid
JSON:Fastjson
工具包:Hutool
内网穿透:uTools
3.2 创建项目基础开发环境
Eclipse 下创建项目流程,请参考此文:
https://gitbook.cn/gitchat/activity/5e9bf58aa58adf47cb052d29
主要依赖库 Maven pom.xml。
服务器 Undertow:
<dependency> <groupId>com.jfinal</groupId> <artifactId>jfinal-undertow</artifactId> <version>2.0</version></dependency>
JFinal 4.8:
<dependency> <groupId>com.jfinal</groupId> <artifactId>jfinal</artifactId> <version>4.8</version></dependency>
JFinal Weixin 2.5:
<dependency> <groupId>com.jfinal</groupId> <artifactId>jfinal-weixin</artifactId> <version>2.5</version></dependency>
Hutool 5.3.0:
<dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-all</artifactId> <version>5.3.0</version></dependency>
Ehcache 2.6.11:
<dependency> <groupId>net.sf.ehcache</groupId> <artifactId>ehcache-core</artifactId> <version>2.6.11</version></dependency>
Mysql-connector-java 8.0.18:
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.18</version></dependency>
Druid 1.1.18:
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.18</version></dependency>
Fastjson 1.2.67:
<dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.67</version></dependency>
4. 简单快速集成单个微信小程序
不管是单个还是多账号,不管是 Java 代码里直接配置还是读取配置文件,或者从缓存或者数据库总读取配置,最终都要在 JFinal 项目启动的时候,通过 JFinal Weixin SDK 提供的小程序配置工具类,进行配置。
4.1 Java 代码硬编码配置、局部变量或常量配置
首先,需要在微信小程序登录进入后台,找到左侧导航【开发】,进入第二个选项卡【开发配置】,第一个配置区域【开发者 ID】中,拿到需要配置的 AppID 和 AppSecret。
在 JFinalConfig 的主配置类中,覆写 onStart 方法,在 JFinal 项目启动后进行微信小程序配置初始化即可。
注意:这里的两个变量 APPID 和 APPSECRET 也可以提取到类上面做常量定义。
有同学可能会有疑问,为什么是在 onStart 中配置?
这个主要是因为 JFinalConfig 主配置类中,每个 configxxx 方法都有单独的作用。
configConstant 主要配置常量
configRoute 主要配置路由
configPlugin 主要配置自定义插件
configInterceptor 主要配置全局作用的拦截器
configHandler 主要配置全局处理器
configEngine 主要配置 模板引擎相关
剩下的就是 onStart 和 onStop 还有 main 方法, onStop 是服务器停止或者重启时调用
那最后只剩下 onStart 了,而且 onStart 是在所有配置都加载初始化完成,整个项目正常启动后才调用的,非常合适。
当然我们也可以自己写一个 configWechat() 方法:
启动正常!而且成功调用了 API,拿到了微信小程序的 access_token。
大家都知道,调用微信小程序的其它 API,大多数都会要求携带 access_token 的。
至此,完成了最简单的单个账号,Java 代码里硬编码实现配置初始化。
4.2 使用配置文件
在 src/main/resourses 目录下,单独创建一个配置文件 wechat.properties。
这样就需要在 Java 中读取这个配置文件了。
测试启动也是没有问题的,从配置文件中读取到了配置数据后,在 Java 代码里正常使用。
详细视频教程在这里:https://space.bilibili.com/48578449
关注JFinal学院公众号(jfinalxueyuan)
加我微信,随时交流:
mumengmeng
谁在使用JFinal极速开发平台开发项目?
点我查看:
https://mp.weixin.qq.com/s/9InIK3Uf_H0qgeK5k-f9pg