為了使第三方開發者能夠為用戶提供更多更有價值的個性化服務,微信公眾平台開放了許多接口,包括自定義菜單接口、客服接口、獲取用戶信息接口、用戶分組接口、群發接口等,開發者在調用這些接口時,都需要傳入一個相同的參數access_token,它是公眾賬號的全局唯一票據,它是接口訪問憑證。
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都是有效的。
下面將為大家介紹如何定時獲取並存儲access_token。請注意:這不是一篇講解如何調用接口獲取access_token的文章,關於access_token的獲取,請參考文章《微信公眾帳號開發教程第14篇-自定義菜單的創建及菜單事件響應》。
在動手前先來簡單分析一下,我們要解決的無非是如下兩個問題:
1、如何定時獲取access_token?
在Java中,如果要定時執行某項任務,需要用到java.util.Timer類,對於喜歡使用框架的朋友,可以采用開源的任務調度框架quartz,Spring框架也支持quartz。除此這外,還有一種方法就是啟動一個線程,在線程的run()方法中寫一個死循環,然后使用Thread.sleep()來保證線程定時執行某項任務。
2、將access_token保存在哪?
對於access_token的存儲,可以考慮存儲在文件、數據庫或內存中。具體采用哪種存儲方式,需要根據項目實際情況而定。如果只有一台服務器,直接將access_token存儲在內存中是最簡便有效的方式。
在本文中,筆者將演示的定期獲取並存儲access_token的流程為:Web服務器啟動時就加載一個Servlet,在Servlet的init()方法中啟動一個線程,在線程的run()方法中通過死循環+Thread.sleep()的方式定期獲取access_token,然后將獲取到的access_token保存在public static修飾的變量中。
在工程中創建一個InitServlet類,該類的代碼如下:
01.
package
org.liufeng.weixin.servlet;
02.
03.
import
javax.servlet.ServletException;
04.
import
javax.servlet.http.HttpServlet;
05.
import
org.liufeng.weixin.thread.TokenThread;
06.
import
org.liufeng.weixin.util.WeixinUtil;
07.
import
org.slf4j.Logger;
08.
import
org.slf4j.LoggerFactory;
09.
10.
/**
11.
* 初始化servlet
12.
*
13.
* @author liuyq
14.
* @date 2013-05-02
15.
*/
16.
public
class
InitServlet
extends
HttpServlet {
17.
private
static
final
long
serialVersionUID = 1L;
18.
private
static
Logger log = LoggerFactory.getLogger(WeixinUtil.
class
);
19.
20.
public
void
init()
throws
ServletException {
21.
// 獲取web.xml中配置的參數
22.
TokenThread.appid = getInitParameter(
"appid"
);
23.
TokenThread.appsecret = getInitParameter(
"appsecret"
);
24.
25.
log.info(
"weixin api appid:{}"
, TokenThread.appid);
26.
log.info(
"weixin api appsecret:{}"
, TokenThread.appsecret);
27.
28.
// 未配置appid、appsecret時給出提示
29.
if
(
""
.equals(TokenThread.appid) ||
""
.equals(TokenThread.appsecret)) {
30.
log.error(
"appid and appsecret configuration error, please check carefully."
);
31.
}
else
{
32.
// 啟動定時獲取access_token的線程
33.
new
Thread(
new
TokenThread()).start();
34.
}
35.
}
36.
}
從上面的代碼可以看出,InitServlet類只重寫了init()方法,並沒有重寫doGet()和doPost()兩個方法,因為我們並不打算讓InitServlet來處理訪問請求。init()方法的實現也比較簡單,先獲取在web.xml中配置的參數appid和appsecret,再啟動線程TokenThread定時獲取access_token。
InitServlet在web.xml中的配置如下:
01.
<?xml version=
"1.0"
encoding=
"UTF-8"
?>
02.
<web-app version=
"2.5"
xmlns=
"http://java.sun.com/xml/ns/javaee"
03.
xmlns:xsi=
"http://www.w3.org/2001/XMLSchema-instance"
04.
xsi:schemaLocation="http:
//java.sun.com/xml/ns/javaee
05.
http:
//java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
06.
07.
<servlet>
08.
<servlet-name>initServlet</servlet-name>
09.
<servlet-
class
>
10.
org.liufeng.weixin.servlet.InitServlet
11.
</servlet-
class
>
12.
<!-- 配置獲取access_token所需參數appid和appsecret -->
13.
<init-param>
14.
<param-name>appid</param-name>
15.
<param-value>wx617a123bb8bc99cd</param-value>
16.
</init-param>
17.
<init-param>
18.
<param-name>appsecret</param-name>
19.
<param-value>4d82cbbbb08714c12345b62d7hn3dcb8</param-value>
20.
</init-param>
21.
<load-on-startup>
0
</load-on-startup>
22.
</servlet>
23.
24.
<welcome-file-list>
25.
<welcome-file>index.<a href=
"http://www.it165.net/pro/webjsp/"
target=
"_blank"
class
=
"keylink"
>jsp</a></welcome-file>
26.
</welcome-file-list>
27.
</web-app>
InitServlet在web.xml中的配置與普通Servlet的配置有幾點區別:1)通過配置<init-param>向Servlet中傳入參數;2)通過配置<load-on-startup>使得Web服務器啟動時就加載該Servlet;3)沒有配置<servlet-mapping>,因為InitServlet並不對外提供訪問。
TokenThread的源代碼如下:
01.
package
org.liufeng.weixin.thread;
02.
03.
import
org.liufeng.weixin.pojo.AccessToken;
04.
import
org.liufeng.weixin.util.WeixinUtil;
05.
import
org.slf4j.Logger;
06.
import
org.slf4j.LoggerFactory;
07.
08.
/**
09.
* 定時獲取微信access_token的線程
10.
*
11.
* @author liuyq
12.
* @date 2013-05-02
13.
*/
14.
public
class
TokenThread
implements
Runnable {
15.
private
static
Logger log = LoggerFactory.getLogger(TokenThread.
class
);
16.
// 第三方用戶唯一憑證
17.
public
static
String appid =
""
;
18.
// 第三方用戶唯一憑證密鑰
19.
public
static
String appsecret =
""
;
20.
public
static
AccessToken accessToken =
null
;
21.
22.
public
void
run() {
23.
while
(
true
) {
24.
try
{
25.
accessToken = WeixinUtil.getAccessToken(appid, appsecret);
26.
if
(
null
!= accessToken) {
27.
log.info(
"獲取access_token成功,有效時長{}秒 token:{}"
, accessToken.getExpiresIn(), accessToken.getToken());
28.
// 休眠7000秒
29.
Thread.sleep((accessToken.getExpiresIn() -
200
) *
1000
);
30.
}
else
{
31.
// 如果access_token為null,60秒后再獲取
32.
Thread.sleep(
60
*
1000
);
33.
}
34.
}
catch
(InterruptedException e) {
35.
try
{
36.
Thread.sleep(
60
*
1000
);
37.
}
catch
(InterruptedException e1) {
38.
log.error(
"{}"
, e1);
39.
}
40.
log.error(
"{}"
, e);
41.
}
42.
}
43.
}
44.
}
代碼中的第23行通過while(true){}構造了一個死循環(永久執行);第25行調用公眾平台接口獲取access_token;第29行讓線程休眠7000秒再運行,即每隔7000秒獲取一次access_token,保證access_token永不失效。在項目中的其他類,可以通過調用 TokenThread.accessToken.getToken() 來得到接口訪問憑證access_token。在本地部署運行該程序,Tomcat啟動完成后就會在控制台顯示如下日志:
1.
[INFO ] weixin api appid:wx617a123bb8bc99cd
2.
[INFO ] weixin api appsecret:4d82cbbbb08714c12345b62d7hn3dcb8
3.
[INFO ] 獲取access_token成功,有效時長
7200
秒 token:sFopJ9lMmLl4u-ad61ojKpS0TolhN2s3SnHoI2Mh5GgdiYb35i-7DG2T2CDyQKMe
為了能夠直觀看到定期獲取access_token的效果,可以試着將TokenThread里的線程休眠時間修改為30秒或60秒。最后,附上本文所涉及的項目源代碼,下載地址:http://download.csdn.net/detail/lyq8479/7300501
PS:2014年4月25日微信團隊發布了修改access_token長度的通知,很多開發者問這次修改會對我們的程序產生什么影響,這里順便回答一下:如果開發者將獲取到的access_token存入數據庫,就必須保證對應的字段長度足夠大,至少能存儲512個字符;如果開發者是將access_token存儲在內存中,那什么都不需要修改。
如果覺得文章對你有所幫助,請通過留言或關注微信公眾帳號xiaoqrobot來支持柳峰!