微信小程序二维码

一、获取小程序码的三个接口

不同的接口对应不同的业务场景，接口B用的较多，接口C官方不推荐使用，也就是说根据需码量来决定选择A接口还是B接口。

（1）、接口 A: 适用于需要的码数量较少的业务场景
生成小程序码，可接受 path 参数较长，生成个数受限

接口A文档

（1）、接口 B：适用于需要的码数量极多的业务场景
生成小程序码，可接受页面参数较短，生成个数不受限.

接口B文档

就以接口B来展开说明

二、思路介绍

（1）、获取 ACCESS_TOKEN 凭证。

获取Access token 文档

根据文档可以看出来，一个Token最多可用2小时并且只能存在一个可用Token，即使本Token并没有失效，再次获取新的Token也会使上一个Token失效。

为了保证高可用，不能2小时刷新一次token吧，太呆逼。可以1个半小时刷新一次，获取Token存入Redis，如果Redis中获取不到就重新获取Token存入Redis。

（2）、带参入码

请求方式
POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=你的微信Token

参数

常用的有 scene 、 page 其他的具体细节并不做过多控制

scene传参有些许特殊

{
 "scene": "a=1"
}

多个参数：scene=shop=382number=3这样传有的手机就把 = 转义了，有的没有，所以定义统一解析规则 a=1 改为 az1 或者 ak1等等由前端去拆分字符解析

（3）、保存图片

操作成功后 返回的图片 Buffer 而不是图片地址，因此需要做一些处理，保存到本地、然后上传到服务器

（4）、异常处理

失败的话会返回错误码，根据具体的错误码去做处理

如果是Token失效所导致的异常40001，就在获取一遍Token重新执行操作，提高容错率，保证高可用

三、编码

（1）、获取 ACCESS_TOKEN 凭证。

开发环境一般都有配置Redis头，实例代码并不规范，仅供参考。

    //从Yml配置文件读取关于微信的配置
    @Resource
    private WechatConfig wxConfig;
    
    @Override
    public String getWeChatToken() throws IOException {
        //1、从Redis获取微信的Token
        String accessToken = RedisHelper.get(RedisKey.getKey("存入的微信Token"));
        //2、不为空则返回Redis中的微信Token
        if (StringUtils.isNotBlank(accessToken)) {
            return accessToken;
        }
        //3、为空则获取Token
        accessToken = this.obtainToken();
        return accessToken;
    }

    /**
     * 获取 access_token
     */
    @Override
    public synchronized String obtainToken() throws IOException {
        //1、从配置文件读取到下面的参数 并发送Get请求就可以获取到Token
        String getToken = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
        //2、获取到请求的结果转成指定的格式
        //（接口只返回access_token和错误码expires_in，因此该param只封装这两个参数）
        returnTokenParam token = JSONObject.parseObject(s, returnTokenParam .class);
        String accessToken = token .getAccessToken();
        //3、获取Token成功存入Redis 失败抛出异常，当然也可以做异常处理
        if ("".equals(accessToken) || StringUtils.isBlank(accessToken)) {
            log.error("获取微信Access_Token失败");
            throw new BizException(ErrorCode.WECHAT_ACCESSTOKEN_ERROR);
        }
        RedisHelper.set(token自定义名称, accessToken, 过期时间 60*60*30 1个半小时);
        return accessToken;
    }

（2）、带参入码、异常处理

        //1、校验，准备参数
        //因Token只能生效一个所以 非线上环境不去获取token
        //（逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~）
        //生成的用户邀请小程序码会被持久化，查询是否持久化，是的话返回结果
        //（逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~）
        //获取微信accessToken
        String accessToken = 第一步的getWeChatToken();
        
        //2、创建请求参数
        JSONObject params = new JSONObject();
        //让前端通过 "y" 解析参数  也可以是别的
        params.put("scene","cy"+customer.getRecommendCode());
        //扫码后进入小程序的页面位置(从yml读)
        params.put("page", page);

        //3、发起 post json请求 （按自己的方式发请求，接收结果就行）
        Response response = 你自己的请求工具类.POST请求("https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + accessToken, params);

        //4、获取结果进行处理（成功默认返回image/jpeg）
        String contentType = response.header("Content-Type");
        if (!"image/jpeg".equals(contentType)) {
            //处理错误（获取返回结果的body）
            String body = response.body().string();
            JSONObject jsonObject = new JSONObject(body);
            String errcode = jsonObject.get("errcode").toString();
            //如果为 40001 错误码 极可能是token出现问题，保证高可用再去重新获取
            if (!"40001".equals(errcode)) {
                String errmsg = jsonObject.get("errmsg").toString();
                log.error("记录错误日志");
                //抛出异常
                throw new .....;
            }
            //重新获取token
            accessToken = 第一步的getWeChatToken();
            //重新发起 post json请求
            Response response = 你自己的请求工具类.POST请求("https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + accessToken, params);
            //获取结果进行处理
            contentType = response.header("Content-Type");
            if (!"image/jpeg".equals(contentType)) {
                String errmsg = jsonObject.get("errmsg").toString();
                log.error("记录错误日志");
                //抛出异常
                throw new .....;
            }
        }

        //5、保存图片
        saveToImgByInputStream(得到的流，保存路径)
        //上传到服务器
        //（逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~）
        //持久化图片地址
        //（逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~）

3、保存图片

/**
     * 将二进制转换成文件保存
     * @param instreams 二进制流
     * @param imgPath 图片的保存路径
     * @return
     *      1：保存正常
     *      0：保存失败
     */
    public static int saveToImgByInputStream(InputStream instreams, String imgPath){
        int stateInt = 1;
        if(instreams != null){
            try {
                //可以是任何图片格式.jpg,.png等
                File file = new File(imgPath);
                FileOutputStream fos=new FileOutputStream(file);
                byte[] b = new byte[1024];
                int nRead = 0;
                while ((nRead = instreams.read(b)) != -1) {
                    fos.write(b, 0, nRead);
                }
                fos.flush();
                fos.close();
            } catch (Exception e) {
                stateInt = 0;
                e.printStackTrace();
            }
        }
        //1 成功，0 失败
        return stateInt;
    }