4.7 KiB
| title | description | published | date | tags | editor | dateCreated |
|---|---|---|---|---|---|---|
| 微信模块 | 微信模块功能 | true | 2021-08-28T03:21:57.635Z | wg-basic, wecaht | markdown | 2021-08-26T08:21:24.080Z |
模块加载
微信模块目前一共有两个，分别是 login-wechat 和 module-wechat 。login-wechat 模块不能单独使用，module-wechat 模块可以单独使用。
两个模块依赖分别为
<dependency>
<groupId>ink.wgink</groupId>
<artifactId>login-wechat</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>ink.wgink</groupId>
<artifactId>module-wechat</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
配置说明
为了能够使用微信功能模块，需要在配置文件中添加如下配置
open-platform:
wechat:
# 支付
pay:
# 激活状态
active: true
# 生产环境
produce: true
# 商家ID
mchid: 123123123123
# 证书路径 和 名称
certificate-path: /Users/xxxxxxx_cert
certificate-name: apiclient_cert.pem
# 公钥文件路径
key-file-path: /Users/xxxxxxx/apiclient_key.pem
# api v3 秘钥
api-v3-secretkey: 111111111111111111
# 小程序
mini-app:
# 激活状态
active: true
# 认证地址，固定
authorizeUrl: https://api.weixin.qq.com/sns/jscode2session
# 认证方式，固定
grantType: authorization_code
# 小程序的appKey
app-key: 123123123123123
# 小程序秘钥
app-secret: 232323232323232323
# 公众号
official-account:
# 激活状态
activate: false
# 公众号认证
authorize:
authorize-url: https://open.weixin.qq.com/connect/oauth2/authorize
access-token-url: https://api.weixin.qq.com/sns/oauth2/access_token
access-token-refresh-url: https://api.weixin.qq.com/sns/oauth2/refresh_token
userinfo-url: https://api.weixin.qq.com/sns/userinfo
response-type: code
scope: snsapi_userinfo
state: wechatRedirectUrl
grant-type: authorization_code
# token地址
access-token-url: https://api.weixin.qq.com/cgi-bin/token
# 公众号appid
app-id: 123123123123123
# 公众号secret
app-secret: 123123123123123123
grant-type: client_credential
config-token: WenG
模块内功能
1. 小程序
1.1 小程序登录
小程序的登录流程如下：
- 用户在打开小程序时，小程序需要调用后台的
/wechat/sign/default接口，完成用户默认登录。 - 接口会返回该用户的 token 和初始化状态，初始化状态为数字，通过下划线
_与token拼接 - 前端将返回值分割 token 和 初始化状态
- 判断初始化状态，如果为 1 表示账户是初始化状态，0 表示账户是非初始化状态
- 如果用户不需要绑定手机号，则第4步可以省略
- 如果需要绑定用户手机号，则需要在获得用户授权之后，调用
/app/miniapp/update-phone接口完成用户绑定，在拿到结果之后，重新获取 token。
这里需要说明的是：小程序默认登录时，会在系统创建随机账户，用户名密码都是随机的。当用户绑定过手机之后，会将随机的用户名修改为手机号。如果手机已经绑定，则提示失败，需要用户更换手机号或微信号。 {.is-info}
1.2 更新个人信息
有时候，我们可能需要展示微信的头像和昵称，获取这些信息也需要用户对小程序进行授权后通过调用接口 /wechat/app/miniapp/user/update-info 接口来完成修改。
这里的修改只是修改了小程序用户信息，并没有对系统用户进行修改，系统中已经体提供了对应的接口，开发人员需要对其封装处理 {.is-info}
2. 公众号
3. 支付
3.1 发起预支付
用户在发起支付之前，需要调用后台系统接口来生成预支付订单，这个订单需要后台调用微信的预支付订单接口来完成。
目前，模块中只对微信支付调用实现了封装，并提供了 ink.wgink.module.wechat.service.pay.v3.jsapi.IJsapiService 接口来方便开发人员调用。开发人员只需要引入这个接口，调用 placeOrder 下单方法即可完成预支付订单的创建。
3.2 实现支付被动通知业务
模块已经默认实现了支付的被动通知，但是，并没有做具体的业务，只是将通知结果进行了输出。开发人员如果想根据业务需要处理支付结果，可以实现 ink.wgink.module.wechat.service.pay.v3.IPayNoticeService 接口，并将实现业务类用 @Primary 注解标注。