您的位置 首页 java

微信公众号开发之生成带参数的二维码（六）

智云科技发布于 2023年7月26日评论(0)阅读(23)

为了满足用户渠道推广分析和用户帐号绑定等场景的需要，公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码，用户扫描后，公众号可以接收到事件推送。

目前有2种类型的二维码：

1、临时二维码，是有过期时间的，最长可以设置为在二维码生成后的30天（即2592000秒）后过期，但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景 2、永久二维码，是无过期时间的，但数量较少（目前为最多10万个）。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。

用户扫描带场景值二维码时，可能推送以下两种事件：

如果用户还未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。

如果用户已经关注公众号，在用户扫描后会自动进入会话，微信也会将带场景值扫描事件推送给开发者。

获取带参数的二维码的过程包括两步，首先创建二维码ticket，然后凭借ticket到指定URL换取二维码。 

 http请求方式: POST
URL: 
POST数据格式：json
POST数据例子：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}

或者也可以使用以下POST数据创建 字符串 形式的二维码参数：
{"expire_seconds": 604800, "action_name": "QR_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}

参数说明

参数说明expire_seconds该二维码有效时间，以秒为单位。 最大不超过2592000（即30天），此字段如果不填，则默认有效期为30秒。action_name二维码类型，QR_SCENE为临时的整型参数值，QR_STR_SCENE为临时的字符串参数值，QR_LIMIT_SCENE为永久的整型参数值，QR_LIMIT_STR_SCENE为永久的字符串参数值action_info二维码详细信息scene_id场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1–100000）scene_str场景值ID（字符串形式的ID），字符串类型，长度限制为1到64

返回说明

正确的Json返回结果: 

 {"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm
3sUw==","expire_seconds":60,"url":"#34;}

参数说明ticket获取的二维码ticket，凭借此ticket可以在有效时间内换取二维码。expire_seconds该二维码有效时间，以秒为单位。 最大不超过2592000（即30天）。url二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片

通过ticket换取二维码

获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，本接口无须登录态即可调用。

请求说明 

 HTTP GET请求（请使用https协议）
提醒：TICKET记得进行UrlEncode

一、新建一个QrCodeUtil里面包含三个方法，分别是封装请求的参数，产生二维码和获得二维码

​ 

 QrCodeUtil.java  
 package com.xu.wemall. Component s.weixin;

import com.alibaba. fastjson .JSONObject;
import com.xu.wemall.commons.constants.URIConstant;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans. factory .annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.TreeMap;

@Slf4j
@Component
public class QrCodeUtil {

    @Autowired
    private RestTemplate restTemplate;

    @Autowired
    private AccessTokenUtil accessTokenUtil;

    private String createQrCodeString(String sceneStr) {

        TreeMap<String, String> params = new TreeMap<>();
        // output data
        JSONObject data = new JSONObject();
        data.put("action_name", "QR_SCENE");
        data.put("expire_seconds", 3600);//一小时

        JSONObject scene = new JSONObject();
        scene.put("scene_str", sceneStr);
        JSONObject actionInfo = new JSONObject();
        actionInfo.put("scene", scene);
        data.put("action_info", actionInfo);

        return data.toJSONString();

    }

    public JSONObject createQrCode(String sceneId) {

        String qrCodeString = this.createQrCodeString(sceneId);
        log.info("qrCodeString:{}", qrCodeString);

        String accessToken = accessTokenUtil.getAccessToken();
        if (accessToken != null) {
            log.info("URL{}", URIConstant.CREATE_QRCODE_URL);
            String url = URIConstant.CREATE_QRCODE_URL.replace("ACCESS_TOKEN", accessToken);
            log.info("URL_ACCESS_TOKEN:{}", url);
            //将菜单对象转换成JSON字符串

            //发起POST请求创建菜单
            JSONObject jsonObject = restTemplate.postForObject(url, qrCodeString, JSONObject.class);

            return jsonObject;
        }
        return null;

    }

    public void showQrCode(String ticket) throws UnsupportedEncodingException {

        String TICKET = URLEncoder.encode(ticket, "utf-8");

        log.info("URL{}", URIConstant.SHOW_QRCODE_URL);
        String url = URIConstant.SHOW_QRCODE_URL.replace("TICKET", TICKET);
        log.info("SHOW_QRCODE_URL:{}", url);
        //将菜单对象转换成JSON字符串

        //发起POST请求创建菜单
        restTemplate.getForObject(url, JSONObject.class);

    }

}

二、我们新建一个controller用来提交我们的请求

​ 

 QrCodeWxController.java  
 package com.xu.wemall.controller.weixin;

import com.alibaba.fastjson.JSONObject;
import com.xu.wemall.components.weixin.QrCodeUtil;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import java.io.UnsupportedEncodingException;

/**
 * 类名称: LoginController
 * 类描述: 与微信对接登陆验证
 *
 * @author yuanjun
 * 创建时间:2017年12月5日上午10:52:13
 */@Slf4j
@RestController
@Api(tags = "微信生成带参的二维码接口")
@RequestMapping(value = "/weixin/qrcode")
public class QrCodeWxController {

    @Autowired
    private QrCodeUtil qrCodeUtil;

    @ApiOperation(value = "创建带参的二维码")
    @RequestMapping(value = "/createQrCode", method = RequestMethod.POST)
    public Object createQrCode(String sceneId) {

        JSONObject jsonObject = qrCodeUtil.createQrCode(sceneId);
        return jsonObject;

    }

    @ApiOperation(value = "获取带参的二维码")
    @RequestMapping(value = "/showQrCode", method = RequestMethod.GET)
    public void showQrCode(String ticket) throws UnsupportedEncodingException {
        qrCodeUtil.showQrCode(ticket);

    }

}

三、我们打开我们的swagger页面提交一下请求试试看

​

四、根据ticket获取二维码

​

五、【One More Thing！！！】

那这个二维码别人扫了我们怎么知道呢？回答：如果别人扫了我们生成的二维码就会触发我们的扫码事件，微信服务器就会给我们推送如下的消息包 

 <xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[SCAN]]></Event>
  <EventKey><![CDATA[SCENE_VALUE]]></EventKey>
  <Ticket><![CDATA[TICKET]]></Ticket>
</xml>

到这里你应该清楚了吧，我们在我们的微信对接接口的POST方法里增加如下代码即可：

​ 

 WeiXinController.java  
 package com.xu.wemall.controller.weixin;

import com.alibaba.fastjson.JSONObject;
import com.xu.wemall.commons.utils.CheckUtil;
import com.xu.wemall.components.weixin.MessageUtil;
import com.xu.wemall.components.weixin.WeiXinUserUtil;
import io.swagger.annotations.Api;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.PrintWriter;
import java.util.Map;

/**
 * 类名称: LoginController
 * 类描述: 与微信对接登陆验证
 *
 * @author yuanjun
 * 创建时间:2017年12月5日上午10:52:13
 */@Slf4j
@RestController
@Api(tags = "接入验证接口")
@RequestMapping(value = "/weChart")
public class WeiXinController {

    @Autowired
    private WeiXinUserUtil weiXinUserUtil;

    @Autowired
    private MessageUtil messageUtil;

    @RequestMapping(value = "/connect", method = RequestMethod.GET)
    public String connect(@RequestParam(value = "signature") String signature,
                          @RequestParam(value = "timestamp") String timestamp,
                          @RequestParam(value = "nonce") String nonce,
                          @RequestParam(value = "echostr") String echostr) {

        log.info("-----开始校验签名-----");
        PrintWriter out = null;
        if (CheckUtil.checkSignature(signature, timestamp, nonce)) {
            log.info("-----签名校验通过-----");
            return echostr;
        } else {
            log.info("-----校验签名失败-----");
            return null;
        }

    }

    @RequestMapping(value = "connect", method = RequestMethod.POST)
    public String dopost(HttpServletRequest request, HttpServletResponse response) throws Exception {

        response.setCharacterEncoding("utf-8");

        //将微信请求xml转为map格式，获取所需的参数
        Map<String, String> map = MessageUtil.parseXml(request);
        String ToUserName = map.get("ToUserName");
        String FromUserName = map.get("FromUserName");
        String MsgType = map.get("MsgType");
        String Content = map.get("Content");
        String Event = map.get("Event");

        if(MessageUtil.REQ_MESSAGE_TYPE_EVENT.equals(MsgType)){

            if(MessageUtil.EVENT_TYPE_SUBSCRIBE.equals(Event)){
                String xmlString = messageUtil.subscribeForText(ToUserName,FromUserName);

                //关注了公众号，调用接口获得用户的详细信息并保存到后台
                JSONObject jsonObject = weiXinUserUtil.handdleWeixinUserInfo(FromUserName);
                log.info("获取用户的详细信息：{}",jsonObject.toJSONString());

                return xmlString;

            }else if(MessageUtil.EVENT_TYPE_UNSUBSCRIBE.equals(Event)){

                String xmlString = messageUtil.unsubscribeForText(ToUserName,FromUserName);
                return xmlString;

            }else if(MessageUtil.EVENT_TYPE_SCAN.equals(Event)){
                JSONObject jsonObject = weiXinUserUtil.handdleWeixinUserInfo(FromUserName);
                log.info("获取用户的详细信息：{}",jsonObject.toJSONString());

            }

        }

        //处理文本类型，实现输入1，回复相应的封装的内容
        if (MessageUtil.REQ_MESSAGE_TYPE_TEXT.equals(MsgType)) {
            String xmlString = messageUtil.replyForText(ToUserName,FromUserName,"你发送的是：" + Content);
            log.info(xmlString);
            return xmlString;

        }

        if (MessageUtil.REQ_MESSAGE_TYPE_IMAGE.equals(MsgType)) {

            String filePath = "C:\Users\RonnieXu\Pictures\2.jpg";
            String xmlString = messageUtil.replyForImage(ToUserName,FromUserName,filePath);
            return xmlString;
        }

        return null;
    }

}  
 WeiXinUserUtil.java  
 package com.xu.wemall.components.weixin;

import com.alibaba.fastjson.JSONObject;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.xu.wemall.commons.constants.URIConstant;
import com.xu.wemall.entry.WxUser;
import com.xu.wemall.service.IWxUserService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;

@Slf4j
@Component
public class WeiXinUserUtil {

    @Autowired
    private IWxUserService iWxUserService;

    @Autowired
    private RestTemplate restTemplate;

    @Autowired
    private AccessTokenUtil accessTokenUtil;

    public JSONObject handdleWeixinUserInfo(String openId) {

        String accessToken = accessTokenUtil.getAccessToken();
        if (accessToken != null) {
            log.info("URL{}", URIConstant.OPENID_USERINFO_URL);
            String url = URIConstant.OPENID_USERINFO_URL.replace("ACCESS_TOKEN", accessToken)
                    .replace("OPENID", openId);
            log.info("OPENID_USERINFO_URL:{}", url);

            //发起POST请求创建菜单
            JSONObject jsonObject = restTemplate.getForObject(url, JSONObject.class);

            //表示订阅了该公众号
            if (jsonObject.getIntValue("subscribe") == 1) {
                //保存
                WxUser wxUser = JSONObject.parseObject(jsonObject.toJSONString(), WxUser.class);

                //先查一下是否曾经查询过(查看数据库数据）
                QueryWrapper<WxUser> queryWrapper = new QueryWrapper();
                queryWrapper.lambda().eq(WxUser::getOpenid, openId);
                WxUser wxUserExist = iWxUserService.getOne(queryWrapper);
                if (wxUserExist == null) {
                    boolean result = iWxUserService.saveOrUpdate(wxUser);
                }

            }

            return jsonObject;
        }

        return null;
    }

}

打完收工，下回再见！

标签:
打赏 点赞(0)

文章来源：智云一二三科技

文章标题：微信公众号开发之生成带参数的二维码（六）

文章地址：https://www.zhihuclub.com/187284.shtml

关于作者: 智云科技

相关文章

热门文章

1分享新浪图床上传接口源码

点赞(595)阅读(34,339)

2PHP简单实现路由Route功能

点赞(820)阅读(27,100)

3centos系统如何查看是否安装了mysql

点赞(161)阅读(2,749)

4curl 工具简述

点赞(141)阅读(2,489)

5PHP基础技巧12条

点赞(139)阅读(2,476)

发表回复

您的电子邮箱地址不会被公开。

网站地图