微信公眾平台開發保證access_token長期有效的方法

高洛峰
發布: 2017-03-22 15:54:03
原創
2840 人瀏覽過

為了使第三方開發者能夠為用戶提供更多更有價值的個人化服務,微信公眾平台開放了許多接口,包括自定義菜單接口、客服接口、獲取用戶信息接口、用戶分組接口、群發介面等,開發者在呼叫這些介面時,都需要傳入一個相同的參數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類,該類別的程式碼如下:

package org.liufeng.weixin.servlet;    
    
import javax.servlet.ServletException;    
import javax.servlet.http.HttpServlet;    
import org.liufeng.weixin.thread.TokenThread;    
import org.liufeng.weixin.util.WeixinUtil;    
import org.slf4j.Logger;    
import org.slf4j.LoggerFactory;    
    
/**  
 * 初始化servlet  
 *   
 * @author liuyq  
 * @date 2013-05-02  
 */    
public class InitServlet extends HttpServlet {    
    private static final long serialVersionUID = 1L;    
    private static Logger log = LoggerFactory.getLogger(WeixinUtil.class);    
    
    public void init() throws ServletException {    
        // 获取web.xml中配置的参数    
        TokenThread.appid = getInitParameter("appid");    
        TokenThread.appsecret = getInitParameter("appsecret");    
    
        log.info("weixin api appid:{}", TokenThread.appid);    
        log.info("weixin api appsecret:{}", TokenThread.appsecret);    
    
        // 未配置appid、appsecret时给出提示    
        if ("".equals(TokenThread.appid) || "".equals(TokenThread.appsecret)) {    
            log.error("appid and appsecret configuration error, please check carefully.");    
        } else {    
            // 启动定时获取access_token的线程    
            new Thread(new TokenThread()).start();    
        }    
    }    
}
登入後複製

從上面的程式碼可以看出,InitServlet類別只重寫了init()方法,並沒有重寫doGet()和doPost()兩個方法,因為我們並不打算讓InitServlet來處理存取請求。 init()方法的實作也比較簡單,先取得在web.xml中設定的參數appid和appsecret,再啟動執行緒TokenThread定時取得access_token。

InitServlet在web.xml中的設定如下:

<?xml version="1.0" encoding="UTF-8"?>    
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"    
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee     
    <a href="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" "="">http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"</a>>    
    
    <servlet>    
        <servlet-name>initServlet</servlet-name>    
        <servlet-class>    
            org.liufeng.weixin.servlet.InitServlet    
        </servlet-class>    
        <!-- 配置获取access_token所需参数appid和appsecret -->    
        <init-param>    
            <param-name>appid</param-name>    
            <param-value>wx617a123bb8bc99cd</param-value>    
        </init-param>    
        <init-param>    
            <param-name>appsecret</param-name>    
            <param-value>4d82cbbbb08714c12345b62d7hn3dcb8</param-value>    
        </init-param>    
        <load-on-startup>0</load-on-startup>    
    </servlet>    
    
    <welcome-file-list>    
        <welcome-file>index.jsp</welcome-file>    
    </welcome-file-list>    
</web-app>
登入後複製

InitServlet在web.xml中的設定與普通Servlet的設定有幾點差異:1)透過設定使得Web伺服器啟動時就載入該Servlet;3)沒有設定,因為InitServlet不會對外提供存取。

TokenThread的原始程式碼如下:

package org.liufeng.weixin.thread;    
    
import org.liufeng.weixin.pojo.AccessToken;    
import org.liufeng.weixin.util.WeixinUtil;    
import org.slf4j.Logger;    
import org.slf4j.LoggerFactory;    
    
/**  
 * 定时获取微信access_token的线程  
 *   
 * @author liuyq  
 * @date 2013-05-02  
 */    
public class TokenThread implements Runnable {    
    private static Logger log = LoggerFactory.getLogger(TokenThread.class);    
    // 第三方用户唯一凭证    
    public static String appid = "";    
    // 第三方用户唯一凭证密钥    
    public static String appsecret = "";    
    public static AccessToken accessToken = null;    
    
    public void run() {    
        while (true) {    
            try {    
                accessToken = WeixinUtil.getAccessToken(appid, appsecret);    
                if (null != accessToken) {    
                    log.info("获取access_token成功,有效时长{}秒 token:{}", accessToken.getExpiresIn(), accessToken.getToken());    
                    // 休眠7000秒    
                    Thread.sleep((accessToken.getExpiresIn() - 200) * 1000);    
                } else {    
                    // 如果access_token为null,60秒后再获取    
                    Thread.sleep(60 * 1000);    
                }    
            } catch (InterruptedException e) {    
                try {    
                    Thread.sleep(60 * 1000);    
                } catch (InterruptedException e1) {    
                    log.error("{}", e1);    
                }    
                log.error("{}", e);    
            }    
        }    
    }    
}
登入後複製

程式碼中的第23行透過while(true){}建構了一個死迴圈(永久執行);第25行呼叫公眾平台介面取得access_token;第29行讓執行緒休眠7000秒再運行,即每隔7000秒獲取一次access_token,保證access_token永不失效。在專案中的其他類,可以透過呼叫 TokenThread.accessToken.getToken() 來得到介面存取憑證access_token。在本地部署運行該程序,Tomcat啟動完成後就會在控制台顯示如下日誌:

[INFO ] weixin api appid:wx617a123bb8bc99cd    
[INFO ] weixin api appsecret:4d82cbbbb08714c12345b62d7hn3dcb8    
[INFO ] 获取access_token成功,有效时长7200秒 token:sFopJ9lMmLl4u-ad61ojKpS0TolhN2s3SnHoI2Mh5GgdiYb35i-7DG2T2CDyQKMe
登入後複製

為了能夠直觀看到定期獲取access_token的效果,可以試著將TokenThread裡的線程休眠時間修改為30秒或60秒。

以上是微信公眾平台開發保證access_token長期有效的方法的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!