access_token是與微信服務器交互過程中的一個憑證,每次客戶服務器主動與微信服務器通信都需要帶上access_token以確認自己的身份。wechat4j內部封裝了對access_token的操作,包括獲取access_token和access_token中控服務器的實現。
access_token獲取
要獲取access_token可以使用如下的方法
String accessToken = TokenProxy.accessToken();
access_token中控服務器
access_token每日有一個次數限制,所以客戶服務器不能每次是都去請求一個新的access_token,每次請求之后,access_token都有一個過期時間。因此微信平台建議你使用一個中控服務器來定時刷新token,取得之后存起來不用再去請求token,因為access_token請求有次數限制。 這樣處理只有有兩個好處:
- 保證access_token每日都不會超出訪問限制,保證服務的正常。
- 提高服務的性能,不用每次發送業務請求之前都先發送一次access_token獲取請求。
wechat4j獲取access_token是通過access_token的代理TokenProxy來獲取,而此代理封裝了access_token的中控服務器。對access_token的保存有兩種方式,一種是內存保存,一種是持久化保存(數據庫或者文件)。內存保存方式的中控服務器由wehcat4j實現,客戶不做任何操作。如果客戶要使用持久化保存,那么就需要自己去定義中控服務器。所以有如下兩種中控服務器:
- access_token默認中控服務器
- access_token自定義中控服務器
默認中控服務器
wechat4j的默認中控服務器是內存模式,即將access_token保存在內存中,直到過期的時候再去請求一個新的來替代。默認中控服務器對應的類是AccessTokenMemServer。
- 優點:此模式的中控服務器有點是效率高,使用方便,客戶不用關心。
- 缺點:無法支持多服務器的集群,如果多個服務器的時候,此方式將不被支持。
自定義中控服務器
如果你需要將access_token保存在數據庫或者文件中,那么就需要使用自定義的中控服務器。自定義的服務器需要客戶自己完成,必須繼承抽象類CustomerServer,完成其中的保存和查詢方法即可,同時自定義的服務器是由定時器來驅動操作的,需要配置監聽器。
配置自定義access_token服務器的詳細步驟:
- 創建自己的服務器類,需要繼承wechat4j的CustomerServer類,實現save和find方法,前者是將access_token保存到數據庫的操作,后者是從數據庫中查詢access_token的方法,里面可以是一個sql操作之類的。
public class CustomerAccessTokenServer extends CustomerServer{
/* (non-Javadoc)
* @see org.sword.wechat4j.token.DbAccessTokenServer#find()
*/
@Override
public String find() {
String accessToken = null;
//執行數據庫操作
// String sql = "select cfgValue from cfg where cfg.cfgKey = 'access_token'";
// accessToken = DBUtil.query(sql);
return accessToken;
}
/* (non-Javadoc)
* @see org.sword.wechat4j.token.DbAccessTokenServer#save()
*/
@Override
public boolean save(Token accessToken) {
//如果沒有需要插入,如果有的就更新,假設已經有了數據庫配置項
// String sql = "update cfg set cfg.cfgValue=" + accessToken.getToken() +
// " where cfg.cfgKey= 'access_token'";
// DBUtil.execute(sql);
return true;
}
}
- 在wechat4j.properties配置文件中配置wechat.accessToken.server.class項,配上剛才新建的服務器類的路徑,示例如下:
wechat.accessToken.server.class=com.sample.wechat.CustomerAccessTokenServer
- 在web.xml中配置wechat4j的access_token監聽器。代碼如下:
<listener>
<listener-class>org.sword.wechat4j.token.TokenListener</listener-class>
</listener>
通過如上三步就能配置好自己的數據庫access_token服務器。這樣由中控服務器定時去刷新access_token,然后保存到數據庫中,業務邏輯中要使用access_token的時候,是通過代理去數據庫拿到數據。
定時刷新任務會提前200秒運行,防止到有效期之后運行過程中新access_token沒有取得舊的access_token過期的情況發生。
wechat4j框架官方文檔: https://github.com/sword-org/wechat4j/wiki
wechat4j技術交流QQ群: 423134346