第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

一、access_token简介

为了使第三方开发者能够为用户提供更多更有价值的个性化服务,微信公众平台 开放了许多接口,包括自定义菜单接口、客服接口、获取用户信息接口、用户分组接口、群发接口等,

开发者在调用这些接口时,都需要传入一个相同的参数 access_token,它是公众账号的全局唯一票据,它是接口访问凭证。

 

access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。

access_token的存储至少要保留512个字符空间。

access_token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的 access_token失效。

 

如果第三方不使用中控服务器,而是选择各个业务逻辑点各自去刷新access_token,那么就可能会产生冲突,导致服务不稳定。

公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在微信公众平台官网-开发者中心页中获得(需要已经成为开发者,且帐号没有异常状态)。注意调用所有微信接口时均需使用https协议。

 

access_token的有效期是7200秒(两小时),在有效期内,可以一直使用,只有当access_token过期时,才需要再次调用接口 获取access_token。在理想情况下,一个7x24小时运行的系统,每天只需要获取12次access_token,即每2小时获取一次。如果在 有效期内,再次获取access_token,那么上一次获取的access_token将失效。

目前,获取access_token接口的调用频率限制为2000次/天,如果每次发送客服消息、获取用户信息、群发消息之前都要先调用获取 access_token接口得到接口访问凭证,这显然是不合理的,一方面会更耗时(多了一次接口调用操作),另一方面2000次/天的调用限制恐怕也不 够用。因此,在实际应用中,我们需要将获取到的access_token存储起来,然后定期调用access_token接口更新它,以保证随时取出的 access_token都是有效的。

 

 

我们先看看官方的说明:

 

接口调用请求说明

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

 

参数说明

参数 是否必须 说明
grant_type 获取access_token填写client_credential
appid 第三方用户唯一凭证
secret 第三方用户唯一凭证**,即appsecret

 

返回说明

正常情况下,微信会返回下述JSON数据包给公众号:

{"access_token":"ACCESS_TOKEN","expires_in":7200}
参数 说明
access_token 获取到的凭证
expires_in 凭证有效时间,单位:秒


错误时微信会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

 

二、封装基本类

封装一下token类:

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

三、获取token。

 

1.问题:如何通过获取token?

 

解决方案:(1)直接通过浏览器访问。(2)编写程序,模拟https连接,获得token。

 

解决详细步骤如下:

(1)浏览器中直接输入链接:https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET ,然后把APPID和APPSECRET替换成自己的appID和appsecret,在浏览器即可获得token。

  

(2)如何在程序中模拟发送https请求,并且获取到token呢?

 

对于https请求,我们需要一个证书信任管理器,这个管理器类需要自己定义,但需要实现X509TrustManager接口, 

首先定义一个MyX509TrustManager 类。

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

 建立一个token测试类:

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

 微信服务器返回的结果:

{"access_token":"E3kRcQTati3QBPz97ou7zG0NXFrZFbA5No_hs5FNUZ62ROT0jr0txWr-gG1w-t06kk0zBW0kFmJiicJAydFyHNZhIh2uqIw4B5t85huRLs4","expires_in":7200}

 

 

2.问题:微信服务器返回的是json数据,如何从json里面解析出来的值?

 

方案:可以通过一款开源的json开发工具包json-lib,将他转换为java对象。

 

详细实现方法:

 

首先引入jar包

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

 

jar包下载:  http://yunpan.cn/cH9UCqsQ9XVdE  访问密码 2711

 

封装一个通用的工具类 CommonUtil ,用于专门获取token

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

修改Token测试类:

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

控制台输出效果如下,说明我们获取到了access_token和expires_in

access_token:2amR6pr1eN-BuSBgho-nzo5tofxJ6BdEnRJQ87Zs5bj4ny4CGB8w-1D3YtjG2PzmEvVm1INrsVg-5BjyHCkWmBKsLPDSF3r_bdaPxMpKtbw
expires_in:7200

 

四、缓存access_token。

 

问题:问题又来来,可是我们如何把这个值缓存起来呢,并且需要2俩小时获取一次?

 

方案:

(1)可以通过缓存框架把该值通过key-values形式缓存在内存中 。

(2)可以把该值存入数据库中,需要的时候就去提取。

 

使用数据库的话,大概思路就是这样的。第一次使用将其access_token存储起来,下次需要access_token则将其查出。若是失效则,重新创建并更新数据库.若是没有失效,则直接使用。

 

建立数据库 souvc

create database  souvc ;

建立数据库表 t_token 来存放token值

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token
CREATE TABLE `t_token` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `access_token` varchar(1024) NOT NULL,
  `expires_in` int(11) NOT NULL,
  `createTime` datetime NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8
第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

 

现在我们通过jdbc来读取这个token值。

 

导入jdbc的jar包

http://yunpan.cn/cH9IRaKemL3II  访问密码 2ffa

导入mysql 的jar包

http://yunpan.cn/cmv3BGe9CkUr3  访问密码 3601

 

 

新建一个数据库配置文件db.properties

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token
#Oracle
#jdbc.driverClassName=oracle.jdbc.OracleDriver
#jdbc.url=jdbc:oracle:thin:@localhost:1521:orcl
#jdbc.username=root
#jdbc.password=123456

#Mysql
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/souvc
jdbc.username=root
jdbc.password=123456

dataSource.initialSize=10
dataSource.maxIdle=20
dataSource.minIdle=5
dataSource.maxActive=50
dataSource.maxWait=1000
第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

 

新建一个jdbc的连接工具类

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

新建测试连接类

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

测试结果如下,说明了能连上数据库:

jdbc:mysql://localhost:3306/souvc, [email protected], MySQL-AB JDBC Driver

 

接下来我们封装一个从数据库读取token和保存token的类

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

建立一个测试类测试

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

 

获取token的结果:

6bbRDvtxIG9jwVhJQBOXoi6-bN6hlMNagxZjsh5QAf447shWcCi9LC1GL5PFgrn4zTdeFMpaU4EqE0CTQDQ2_PE0qOdXTHEM2gt6CV_zlRY
7200

 

保存token的结果:

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

 

这样基本完成了。

也许大家觉得这个方法有点麻烦,也希望大家多多提出修改的建议,或是在评论中说一下自己的方法。贴出代码,让大家一起进步。

 

五,问题:但是如何让这个保存工作隔7200 秒进行保存呢?

 

方案:

做一个定时器。

做一个web实现监听器。

 

定期获取并存储access_token的流程为:

     Web服务器启动时就加载一个Servlet,在Servlet的init()方法中启动一个线 程,在线程的run()方法中通过死循环+Thread.sleep()的方式定期获取access_token,然后将获取到的 access_token保存在public static修饰的变量中。

 

在工程中创建一个InitServlet类,该类的代码如下:

 

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

 

 

从上面的代码 可以看出,InitServlet类只重写了init()方法,并没有重写doGet()和doPost()两个方法,

因为我们并不打算让 InitServlet来处理访问请求。init()方法的实现也比较简单,先获取在web.xml中配置的参数appid和appsecret,

再启动 线程TokenThread定时获取access_token。

 

InitServlet在web.xml中的配置如下:

 

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

 

 

InitServlet 在web.xml中的配置与普通Servlet的配置有几点区别:

1)通过配置<init-param>向Servlet中传入参数;

2)通 过配置<load-on-startup>使得Web服务器启动时就加载该Servlet;

3)没有配置<servlet- mapping>,因为InitServlet并不对外提供访问。

 

TokenThread的源代码如下:

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token View Code

 

 

配置一下log4j.properties 日志文件:

log4j.rootLogger=info,console
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%-5p] %m%n

 

 

代码中通过while(true){}构造了一个死循环(永久执行);

调用公众平台接口获取access_token;

让线程休眠7000秒再运行,即每隔7000秒获取一次access_token,保证access_token永不失效。

 

 

温馨提示:

可以不存入数据库。

在项目中的其他类,可以通过调用 TokenThread.accessToken.getToken() 来得到接口访问凭证access_token。

 

 

 

其他文章关联:

 

第一篇:微信公众平台开发实战Java版之了解微信公众平台基础知识以及资料准备

 

第二篇 :微信公众平台开发实战Java版之开启开发者模式,接入微信公众平台开发

 

第三篇 :微信公众平台开发实战Java版之请求消息,响应消息以及事件消息类的封装

 

第四篇 :微信公众平台开发实战Java版之完成消息接受与相应以及消息的处理

 

第五篇 :微信公众平台开发实战Java版之如何获取公众号的access_token以及缓存access_token

 

第六篇 :微信公众平台开发实战Java版之如何自定义微信公众号菜单

 

第七篇 :微信公众平台开发实战Java版之如何获取微信用户基本信息

 

第八篇 :微信公众平台开发实战Java版之如何网页授权获取用户基本信息

 

第九篇 :微信公众平台开发实战Java版之如何实现自定义分享内容

 

其他:Web开发须知:URL编码与解码