access_token の長期有効性を保証する WeChat パブリック プラットフォームの開発方法

サードパーティ開発者がより価値のあるパーソナライズされたサービスをユーザーに提供できるようにするために、WeChat パブリック プラットフォームは、カスタム メニュー インターフェイス、カスタマー サービス インターフェイス、ユーザー情報取得インターフェイス、ユーザー グループ化インターフェイス、グループ送信インターフェイスなどを含む多くのインターフェイスをオープンしました。開発者がこれらのインターフェイスを呼び出すときは、同じパラメーター access_token を渡す必要があります。これは、パブリック アカウントのグローバルに一意のチケットであり、インターフェイスのアクセス資格情報です。

access_tokenの有効期間は7200秒(2時間)です。有効期間中は、access_tokenの有効期限が切れた場合に限り、再度インターフェースを呼び出してaccess_tokenを取得する必要があります。理想的な状況では、24 時間 365 日稼働しているシステムは、access_token を 1 日 12 回、つまり 2 時間に 1 回取得するだけで済みます。有効期間内に再度access_tokenを取得した場合、前回取得したaccess_tokenは無効となります。

現在、access_token インターフェイスの呼び出し頻度は 1 日あたり 2000 回に制限されています。カスタマー サービス メッセージの送信前、ユーザー情報の取得前、またはグループ メッセージの送信前に、毎回 access_token インターフェイスを呼び出してインターフェイスのアクセス資格情報を取得するのは明らかに不合理です。一方で、より時間がかかります (インターフェイス呼び出し操作が 1 回増えます)。一方で、1 日あたり 2000 件の呼び出し制限では十分ではない可能性があります。したがって、実際のアプリケーションでは、取得した access_token を保存し、定期的に access_token インターフェイスを呼び出して更新し、いつでも取り出した access_token が有効であることを確認する必要があります。

定期的にaccess_tokenを取得、保存する方法を紹介します。注意: これは、access_token を取得するためのインターフェイスを呼び出す方法を説明する記事ではありません。access_token の取得については、「WeChat パブリック アカウント開発チュートリアル パート 14 - カスタム メニューの作成とメニュー イベントの応答」の記事を参照してください。

アクションを起こす前に簡単な分析をしてみましょう。解決しなければならないのは次の 2 つの問題だけです:

1. access_token を定期的に取得する方法。

Java では、タスクを定期的に実行したい場合は、java.util.Timer クラスを使用する必要があります。フレームワークを使用したい場合は、Spring フレームワークもサポートしているオープンソースのタスク スケジューリング フレームワークを使用できます。石英。さらに、スレッドを開始し、スレッドの run() メソッドに無限ループを記述してから、Thread.sleep() を使用して、スレッドが特定のタスクを定期的に実行するようにする方法もあります。

2. access_token をどこに保存するか?

access_token の保存については、ファイル、データベース、またはメモリに保存することを検討できます。具体的な保管方法はプロジェクトの実情に応じて決定する必要があります。サーバーが 1 台しかない場合は、access_token をメモリに直接保存するのが最も簡単で効果的な方法です。

この記事では、著者は次のように定期的に access_token を取得して保存するプロセスを示します: Web サーバーの起動時にサーブレットをロードし、サーブレットの init() メソッドでスレッドを開始し、スレッドの run() でデスを渡します。 )メソッドでaccess_tokenを定期的にループ+Thread.sleep()で取得し、取得した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 を定期的に取得します。

web.xml の InitServlet の構成は次のとおりです:

<?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>

web.xml の InitServlet の構成は、いくつかの点で通常のサーブレットの構成と異なります。 1) ; 2) Web サーバーの起動時にサーブレットをロードするように を設定します。 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 秒スリープさせます。つまり、access_token が期限切れにならないように 7000 秒ごとに 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 の長期有効性を保証する WeChat パブリック プラットフォームの開発方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。