java微信开发API第三步 微信获取以及保存接口调用凭证
微信如何获取以及保存接口调用凭证,下面就为大家进行介绍
一、说明
*详细说明请参考前两篇文章。
*本文分为三部分:
接口调用凭证access_token的作用以及解释
如何获取接口调用凭证access_token
如何实现微信文档所说的“中控服务器”的实现以保存access_token
* 本文结束会给出包括本文前三篇文章的所有演示源码
为什么要获取和保存接口调用凭证access_token
•开始开发-获取接口调用凭据
◦文档地址:http://mp.weixin.qq.com/wiki/14/9f9c82c1af308e3b14ba9b973f99a8ba.html
•官网文档给出这样解释:
◦access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的access_token失效。
•理解:
◦我们简单翻阅文档可以发现,许多高级功能,例如:自定义菜单、素材管理、用户管理、账号管理等各种高级功能请求的链接中都有“?access_token=token”这个参数,这是全局调用参数,微信后台需要根据这个参数确定身份,保证我们的微信公众号的安全。
◦为了防止公众号的程序错误而引发微信服务器负载异常,默认情况下,每个公众号调用接口都不能超过一定限制,这里微信限制每天2000次。所以,如果我们想要频繁调用这个参数,需要我们开发者手动保存,每个access_token有效期是2个小时。
获取接口调用凭证access_token
•官网文档给出这样解释:
◦接口调用请求说明
http请求方式: get
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=appid&secret=appsecret
■返回说明
正常情况下,微信会返回下述json数据包给公众号:
{“access_token”:”access_token”,”expires_in”:7200}
错误时微信会返回错误码等信息,json数据包示例如下(该示例为appid无效错误):
{“errcode”:40013,”errmsg”:”invalid appid”}
•理解:
◦get请求,该方式直接在本地就可以实现。因为只是一个普通的get请求,类似于访问网址。所以,不需要上传该部分代码到服务器就可以直接操作。
◦http请求协议是get请求,说明我们需要通过get请求获取返回流,返回流是json形式。调用时我们需要携带三个参数:grant_type、appid、secret。其中appid和secret是我们微信公众号关键的参数,在前文已经阐述。返回结果分为正确和错误两种结果。【百度:json】
◦其实,我们可以直接在地址栏输入文档给的示例:https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=appid&secret=appsecret,我们会看到这样的信息:“{“errcode”:40013,”errmsg”:”invalid appid hint: [pqkl0120ic11]”}”,因为这是一个无效的请求,返回的是错误的结果。
◦当我们把自己的测试号appid和appsecret替换上面的那两个参数,会看到这样的信息:“{“access_token”:”xrllr3fnf…badamio”,”expires_in”:7200}”,代表获取成功。
◦现在我们通过java 代码获取返回流,拿取access_token。
•实现
private static final long max_time = 7200 * 1000;// 微信允许最长access_token有效时间(ms) private static final string tag = "weixinapitest";// tag private static final string appid = "wx889b****b3666b0b8";// appid private static final string secert = "6da7676***f0a9f15fbf06027856bb";// 秘钥 /* * 该测试用例演示了如何获取access_token。 * access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。 */ @test public void getaccess_token() throws ioexception { // 拼接api要求的httpsurl链接 string urlstring = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + appid + "&secret=" + secert; // 创建一个url url requrl = new url(urlstring); // 拿取链接 httpsurlconnection httpsconn = (httpsurlconnection) requrl .openconnection(); // 取得该连接的输入流,以读取响应内容 inputstreamreader isr = new inputstreamreader( httpsconn.getinputstream()); // 读取服务器的响应内容并显示 char[] chars = new char[1024]; string reslut = ""; int len; while ((len = isr.read(chars)) != -1) { reslut += new string(chars, 0, len); } isr.close(); /* * 转化json成javabean。引入了第三方jar:gson */ gson gson = new gson();// 将获取的json转化为java中的bean // 注意:access_token access_token是一个自己创建的javabean access_token access_token = gson.fromjson(reslut, new access_token().getclass()); if (access_token.getaccess_token() != null) { system.out.println("获取的access_token是:" + access_token.getaccess_token()); system.out.println("该access_token的有效时间是:" + access_token.getexpires_in() + "s"); } else { system.out.println(tag + "获取access_token失败,请检查"); } }
保存接口调用凭证access_token
•思路
将获取到的access_token和当前时间存储到file里, 取出时判断当前时间和存储里面的记录的时间的时间差,如果大于max_time,重新获取,并且将获取到的存储到file替换原来的内容,如果小于max_time,直接获取。
•实现
/* * 该方法实现获取access_token、保存并且只保存2小时access_token。如果超过两个小时重新获取;如果没有超过两个小时,直接获取。该方法依赖 * :public static string getaccesstoken(); * * 思路:将获取到的access_token和当前时间存储到file里, * 取出时判断当前时间和存储里面的记录的时间的时间差,如果大于max_time,重新获取,并且将获取到的存储到file替换原来的内容 * ,如果小于max_time,直接获取。 */ @test public void getsavedaccess_token() throws ioexception { gson gson = new gson(); string maccess_token = null;// 需要获取的access_token; file file = new file("temp_access_token.temp");// access_token保存的位置 // 如果文件不存在,创建 if (!file.exists()) file.createnewfile(); // 如果文件大小等于0,说明第一次使用,存入access_token if (file.length() == 0) { maccess_token = getaccesstoken(); fileoutputstream fos = new fileoutputstream(file, false);// 不允许追加 access_token at = new access_token(); at.setaccess_token(maccess_token); at.setexpires_in(system.currenttimemillis() + ""); string json = gson.tojson(at); fos.write((json).getbytes()); fos.close(); } else { // 读取文件内容 fileinputstream fis = new fileinputstream(file); byte[] b = new byte[2048]; int len = fis.read(b); string mjsonaccess_token = new string(b, 0, len);// 读取到的文件内容 access_token access_token = gson.fromjson(mjsonaccess_token, new access_token().getclass()); if (access_token.getexpires_in() != null) { long savetime = long.parselong(access_token.getexpires_in()); long nowtime = system.currenttimemillis(); long remiantime = nowtime - savetime; // system.out.println(tag + "时间差:" + remiantime); if (remiantime < max_time) { access_token at = gson.fromjson(mjsonaccess_token, new access_token().getclass()); maccess_token = at.getaccess_token(); } else { maccess_token = getaccesstoken(); fileoutputstream fos = new fileoutputstream(file, false);// 不允许追加 access_token at = new access_token(); at.setaccess_token(maccess_token); at.setexpires_in(system.currenttimemillis() + ""); string json = gson.tojson(at); fos.write((json).getbytes()); fos.close(); } } } system.out.println("获取到的access_token是:" + maccess_token); } /* * 获取微信服务器accesstoken。该部分和getaccess_token() 一致,不再加注释 */ public static string getaccesstoken() { string urlstring = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + appid + "&secret=" + secert; string reslut = null; try { url requrl = new url(urlstring); httpsurlconnection httpsconn = (httpsurlconnection) requrl .openconnection(); inputstreamreader isr = new inputstreamreader( httpsconn.getinputstream()); char[] chars = new char[1024]; reslut = ""; int len; while ((len = isr.read(chars)) != -1) { reslut += new string(chars, 0, len); } isr.close(); } catch (ioexception e) { e.printstacktrace(); } gson gson = new gson(); access_token access_token = gson.fromjson(reslut, new access_token().getclass()); if (access_token.getaccess_token() != null) { return access_token.getaccess_token(); } else { return null; } }
前三篇文章演示源码:http://xiazai.jb51.net/201606/yuanma/weixinapidemo(jb51.net).rar
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。