最近接手了一个 Sass 项目的子功能写一个微信小程序,其中有这么一个需求:为不同的租户生成不同的小程序码,通过扫码自动带入租户的基本信息,之后再进行用户登录,与微信账户绑定云云。

本文着重点:小程序码的获取与使用,另由于小程序后端能力统统由原项目提供,是无法使用腾讯的本身的云开发的,我们使用的是服务端 API 的调用方式。

一、小程序码

微信官方提供了三种获取小程序码的接口:createQRCode, getgetUnlimited。createQRCode 和 get 算是一类,前者生成二维码后者生成小程序码。他们的特性概括来说就是:永久有效有数量限制(合计 10 万个)接受的自定义参数较长(128 字节)。自然是不能满足业务需求啦,所以我们使用的是 getUnlimited ,特点是无限数量,缺点是只能携带 32 字节的自定义参数(而且还限制类型)。

1.access_token

在正式的获取小程序码前,我们还需要获取到一个名为 access_token 的参数,它是小程序全局唯一后台接口调用凭据,调用绝大多数后台接口时都需使用。可以通过 getAccessToken 接口获取。

请求地址
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
获取 Access Token
获取 Access Token

它的有效期是 2 个小时,重复获取将导致上次获取的 access_token 失效。

2.getUnlimited

请求地址
POST https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
属性类型必填默认值说明
access_tokenstring接口调用凭证
scenestring最大 32 个可见字符。支持数字,英文和字符:!#$&'()*+,/:;=?@-._~
pagestring主页必须是已经发布的小程序存在的页面
widthnumber430二维码的宽度,单位 px,最小 280px,最大 1280px
获取小程序码
获取小程序码

二、微信小程序

小程序端只需要在页面的 onLoad 中读取即可:

读取传参
onLoad: function (options) {
const comCodeScene = decodeURIComponent(options.scene || '');
// 业务处理
}

三、获取小程序码

完!你问我其它的代码嘞?本宝宝本项目只负责前端哈哈哈哈哈

一个简单的 Java 版本获取小程序码的实现
获取小程序码
/**
* 获取租户小程序二维码
*
* @param tenant
* @return
*/
public String getWx2d(CmmTenant tenant) {
String base64Code = null;
//然后调用微信官方api生成二维码
String createQrCodeUrl = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + getToken();
//此处我是使用的阿里巴巴的fastJson
JSONObject createQrParam = new JSONObject();
createQrParam.put("scene", "scene=" + tenant.getDomainName());
createQrParam.put("width", "280");

PrintWriter out = null;
InputStream in = null;
try {
URL realUrl = new URL(createQrCodeUrl);
// 打开和URL之间的连接
URLConnection conn = realUrl.openConnection();
// 设置通用的请求属性
conn.setRequestProperty("accept", "*/*");
conn.setRequestProperty("connection", "Keep-Alive");
conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
// 发送POST请求必须设置如下两行
conn.setDoOutput(true);
conn.setDoInput(true);
// 获取URLConnection对象对应的输出流
out = new PrintWriter(conn.getOutputStream());
// 发送请求参数,利用connection的输出流,去写数据到connection中,我的参数数据流出我的电脑内存到connection中,让connection把参数帮我传到URL中去请求。
out.print(createQrParam);
// flush输出流的缓冲
out.flush();
//获取URL的connection中的输入流,这个输入流就是我请求的url返回的数据,返回的数据在这个输入流中,流入我内存,我将从此流中读取数据。
in = conn.getInputStream();
//定义个空字节数组
byte[] data = null;
// 读取图片字节数组
try {
//创建字节数组输出流作为中转仓库,等待被写入数据
ByteArrayOutputStream swapStream = new ByteArrayOutputStream();
byte[] buff = new byte[100];
int rc = 0;
while ((rc = in.read(buff, 0, 100)) > 0) {
//向中转的输出流循环写出输入流中的数据
swapStream.write(buff, 0, rc);
}
//此时connection的输入流返回给我们的请求结果数据已经被完全地写入了我们定义的中转输出流swapStream中
data = swapStream.toByteArray();
} catch (IOException e) {
e.printStackTrace();
} finally {
if (in != null) {
try {
in.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
base64Code = new String(Objects.requireNonNull(Base64.encodeBase64(data)));
//Base64转byte[]数组
System.out.println(base64Code);
} catch (Exception e) {
System.out.println("发送 POST 请求出现异常!" + e);
e.printStackTrace();
}

// 使用finally块来关闭输出流、输入流
finally {
try {
if (out != null) {
out.close();
}
if (in != null) {
in.close();
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
log.info("base64Code=" + base64Code);
return base64Code;
}

评论