微信js-sdk调用
之前在做微信的时候,在微信支付还有调起微信扫一扫的时候,用过js-sdk。最近,被几个做前端的同学问到了具体的流程,想想,还是写下来好点。
微信js-sdk,是微信提供给网页开发设计者使用的,在页面上使用部分微信功能的SDK。关于它的文档,可以通过微信公众平台上获取获取。http://mp.weixin.qq.com/wiki/11/74ad127cc054f6b80759c40f77ec03db.html
关于如何开发,其实在微信的文档上面已经说得蛮清楚的了,只要按照文档来,大概就能够调得出自己想要的功能了。
调起微信js-sdk,可以分为两个部分,配置部分和编码部分。
配置部分,需要开发者登录到微信公众平台上,对能够进行js-sdk调起的域名进行授权,只有通过授权的域名,才能调起。主要的配置在 公众号设置”的“功能设置”里填写“JS接口安全域名”。设置完成后,在需要调起的页面,导入微信官方给出的js https://res.wx.qq.com/open/js/jweixin-1.0.0.js,前期的工作就大部分完成了。
编码部分主要分为前端编码和后台编码,因为微信的js-sdk调起的时候,需要向微信服务器传一些验签的参数,而这些参数,在微信官方是推荐由后台进行加密后再传回前端的。
在开始编码之前,首先了解一下从用户使用开始,到调起js-sdk进行操作得当整个流程:
大致的流程如图所示,用户通过微信客户端访问程序员开发的H5页面,该页面要调起js-sdk的某些功能,则需要在页面加载完成之后,首先请求企业的服务器,申请入appscrte等参数,然后将参数填入wx.config()函数中,该函数主要确定该页面是否可以调起js-sdk,该函数执行完成之后,默认会调用wx.ready(),如果需要页面加载完成后立马调起js-sdk的话,需要将调用的代码放在
wx.ready()中。如果不需要,就只需要在根据情况在页面上出发对应的js-sdk提供的函数即可。每个函数,都会有对应的成功与失败的回调函数,前端通过该函数,来实现对应的结果展示就行了。
在这个过程中,前端所需要做的,其实就是根据需求来调起微信js-sdk中的函数。前端重中之中在于页面加载完成之后的wx.config()接入,而后台的任务则是根据微信的算法,对参数进行加密,然后将数据打包返回给前端。
调起js-sdk所后台需要做的可以分为以下几步:
1、通过请求微信服务器获取 access_token;
2.、通过 access_token获取到调起js-sdk所需要用到的 jsapi_ticket;
3、将 noncestr(随机字符串), jsapi_ticket, timestamp(时间错), url(调起js-sdk的网址)四个参数进行排序并加密生产一串加密字符
4、将appId(公众号的唯一标识), timestamp, nonceStr:,signature(签名)返回给前端
具体需要涉及到的算法如下:
1 public static String signatureSHA1(Map<String, String> map) { 2 3 Set<String> keySet = map.keySet(); 4 5 String[] str = new String[map.size()]; 6 7 StringBuilder tmp = new StringBuilder(); 8 9 // 进行字典排序 10 11 str = keySet.toArray(str); 12 13 Arrays.sort(str); 14 15 for (int i = 0; i < str.length; i++) { 16 17 String t = str[i] + "=" + map.get(str[i]) + "&"; 18 19 tmp.append(t); 20 21 } 22 23 String tosend = tmp.toString().substring(0, tmp.length() - 1); 24 25 MessageDigest md = null; 26 27 byte[] bytes = null; 28 29 try { 30 31 md = MessageDigest.getInstance("SHA-1"); 32 33 bytes = md.digest(tosend.getBytes("utf-8")); 34 35 } catch (Exception e) { 36 37 e.printStackTrace(); 38 39 } 40 41 String singe = byteToStr(bytes); 42 43 return singe.toLowerCase(); 44 45 }
需要注意的是,在前端进行调试的过程中,苹果版的微信会在调出js-sdk出错的时候弹出更加详细的信息,而安卓版有时候只是没反应,连信息都不会弹出,所以建议如果确定后台算法正确的情况下,可以在苹果的微信下进行调试。
具体的项目实例可以看https://github.com/Seanid/wechatPay中页面调起微信支付部分