微信公众号扫一扫

时间:2021-10-23 03:29:38

步骤

根据微信JS-JDK文档说明,实现扫一扫主要有以下几大步骤:

  1. 绑定域名
  2. 引入JS文件
  3. 通过config接口注入权限验证配置
  4. 通过ready接口处理成功验证
  5. 通过error接口处理失败验证

绑定域名

在JS接口安全域名填入域名,注意不带http,如图:

微信公众号扫一扫

引入JS文件

1 <script src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js"></script>

通过config接口注入权限验证配置

 1 $.ajax({
 2         url: "${pageContext.request.contextPath}/wechat/jsapisign",
 3         type: "post",
 4         data: {
 5             url: location.href.split('#')[0]
 6         },
 7         contentType: 'application/x-www-form-urlencoded;charset=utf-8',
 8         async: true,
 9         success: function (data) {
10             wx.config({
11                 debug: false,
12                 appId: data.appid, // 必填,公众号的唯一标识
13                 timestamp: data.timestamp, // 必填,生成签名的时间戳
14                 nonceStr: data.nonceStr, // 必填,生成签名的随机串
15                 signature: data.signature,// 必填,签名,见附录1
16                 jsApiList: ["scanQRCode"] // 必填,需要使用的JS接口列表,所有JS接口列表见附录2
17             });
18         }
19     });

微信jsapi验签

 1 public Map<String, String> jsApiSign(String url) {
 2         Map<String, String> ret = new HashMap<String, String>(16);
 3         String nonce_str = CheckUtil.create_nonce_str();
 4         String timestamp = CheckUtil.create_timestamp();
 5         String string1;
 6         String signature = "";
 7 
 8         String jsapi_ticket = wechatAccessTokenService.getJsApiTicket();
 9         //注意这里参数名必须全部小写,且必须有序
10         string1 = "jsapi_ticket=" + jsapi_ticket +
11                 "&noncestr=" + nonce_str +
12                 "&timestamp=" + timestamp +
13                 "&url=" + url;
14         logger.info("jsApiSign===" + string1);
15 
16         try {
17             MessageDigest crypt = MessageDigest.getInstance("SHA-1");
18             crypt.reset();
19             crypt.update(string1.getBytes("UTF-8"));
20             signature = CheckUtil.byteToHex(crypt.digest());
21         } catch (NoSuchAlgorithmException | UnsupportedEncodingException e) {
22             e.printStackTrace();
23         }
24 
25         ret.put("appid", appid);
26         ret.put("url", url);
27         ret.put("jsapi_ticket", jsapi_ticket);
28         ret.put("nonceStr", nonce_str);
29         ret.put("timestamp", timestamp);
30         ret.put("signature", signature);
31         logger.info("jsApiSign===url=" + url + "==jsapi_ticket" + jsapi_ticket + "==nonce_str" + nonce_str + "==timestamp" + timestamp + "==signature" + signature);
32         return ret;
33     }
 1 public String getJsApiTicket() {
 2         AugeWechatAccessToken wechatAccesstoken = augeWechatAccessTokenMapper.selectByPrimaryKey(jsApiTicketId);
 3         logger.info("getJsApiTicket===" + wechatAccesstoken.getAccessToken());
 4         if (Strings.isNullOrEmpty(wechatAccesstoken.getAccessToken()) || wechatAccesstoken.getExpiresIn() - 100 * 1000 < System.currentTimeMillis()) {
 5             //空或者过期,刷新
 6             return refreshJsApiTicket();
 7         } else {
 8             return wechatAccesstoken.getAccessToken();
 9         }
10     }

Controller层代码

1 @RequestMapping(value = "/jsapisign", method = {RequestMethod.GET, RequestMethod.POST}, produces = MEDIATYPE_CHARSET_JSON_UTF8)
2     @ResponseBody
3     public String jsApiSign(String url) {
4         //添加微信js签名信息
5         Map<String, String> signMap = wechatService.jsApiSign(url);
6 
7         return JSON.toJSONString(signMap);
8     }

前台JSP页面完整代码

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%
    String path = request.getContextPath();
    String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + path + "/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="zh-CN">
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=320.1,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no">
<head>
    <base href="<%=basePath%>">
    <title>扫码还书</title>
    <link rel="stylesheet" href="http://203.195.235.76/jssdk/css/style.css"/>
    <script src="http://res.wx.qq.com/open/js/jweixin-1.1.0.js"></script>
    <script src="http://libs.baidu.com/jquery/2.0.0/jquery.js"></script>
    <link rel="stylesheet" type="text/css" href="../../../resources/css/bookdetail.css">

</head>

<body>
<div class="wrap" style="width: 100% ;height: 100%">
    <img src="../../../resources/images/borrow/return.png" alt="" style="width: 100% ;height: 75%">
    <div style="text-align: center; background-color: #f5f5f5; ">
        <img src="../../../resources/images/borrow/scanReturn.png" alt="" style="width: 40% ;height: 25%;" id="scanQRCode1">
    </div>

</div>

<script type="text/javascript">
    $.ajax({
        url: "${pageContext.request.contextPath}/wechat/jsapisign",
        type: "post",
        data: {
            url: location.href.split('#')[0]
        },
        contentType: 'application/x-www-form-urlencoded;charset=utf-8',
        async: true,
        success: function (data) {
            wx.config({
                debug: false,
                appId: data.appid, // 必填,公众号的唯一标识
                timestamp: data.timestamp, // 必填,生成签名的时间戳
                nonceStr: data.nonceStr, // 必填,生成签名的随机串
                signature: data.signature,// 必填,签名,见附录1
                jsApiList: ["scanQRCode"] // 必填,需要使用的JS接口列表
            });
        }
    });
    wx.ready(function () {
        // 9.1.2 扫描二维码并返回结果
        document.querySelector('#scanQRCode1').onclick = function () {
            wx.scanQRCode({
                needResult: 1,
                desc: 'scanQRCode desc',
                success: function (res) {
                    //扫码后获取结果参数赋值给Input
                    var url = res.resultStr;
                    //商品条形码,取","后面的
                    if (url.indexOf(",") >= 0) {
                        var tempArray = url.split(',');
                        var barCode = tempArray[1];
                        window.location.href = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx96668744efc2b2de&redirect_uri=http://cx.ngrok.xiaomiqiu.cn/wechat/toReturnDetail?barCode=" + barCode + "&response_type=code&scope=snsapi_base&state=BINDFACE#wechat_redirect";

                    } else {
                        alert("请对准条形码扫码!");
                    }
                }
            });
        };
    });
    //初始化jsapi接口 状态
    wx.error(function (res) {
        alert("调用微信jsapi返回的状态:" + res.errMsg);
    });

</script>
</body>
</html>

注:开发中容易出现的有signature验签错误,我们可以透过前后端url一致性来判断。其次就是注意有时候的错误是由于accessToken没有刷新的缘故,需要重新刷新。