官網說明
access_token是公眾號的全局唯一票據,公眾號調用各接口時都需使用access_token。開發人員須要進行妥善保存。
access_token的存儲至少要保留512個字符空間。access_token的有效期眼下為2個小時。需定時刷新,反復獲取將導致上次獲取的access_token失效。
公眾平台的API調用所需的access_token的使用及生成方式說明:
1、為了保密appsecrect,第三方須要一個access_token獲取和刷新的中控server。而其它業務邏輯server所使用的access_token均來自於該中控server。不應該各自去刷新。否則會造成access_token覆蓋而影響業務; 2、眼下access_token的有效期通過返回的expire_in來傳達,眼下是7200秒之內的值。中控server須要依據這個有效時間提前去刷新新access_token。在刷新過程中,中控server對外輸出的依舊是老access_token,此時公眾平台后台會保證在刷新短時間內。新老access_token都可用,這保證了第三方業務的平滑過渡。 3、access_token的有效時間可能會在未來有調整,所以中控server不僅須要內部定時主動刷新,還須要提供被動刷新access_token的接口,這樣便於業務server在API調用獲知access_token已超時的情況下,能夠觸發access_token的刷新流程。
假設第三方不使用中控server。而是選擇各個業務邏輯點各自去刷新access_token,那么就可能會產生沖突。導致服務不穩定。
公眾號能夠使用AppID和AppSecret調用本接口來獲取access_token。AppID和AppSecret可在微信公眾平台官網-開發人員中心頁中獲得(須要已經成為開發人員。且帳號沒有異常狀態)。
注意調用全部微信接口時均需使用https協議。
接口調用請求說明
http請求方式: GET https://api.weixin.qq.com/cgi-bin/token?
參數說明
參數 | 是否必須 | 說明 |
---|---|---|
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,而token,每日上線10W次,假設用戶量比較大帶根本不夠用,節約資源,將token儲存起來,在實際開發中,並不能把APPID,SECRET寫死,我們將保存在數據配置表中,所以看代碼吧!
1.微信工具類定義獲取token方法.
public static GeneralToken getToken(String appid, String secret){ GeneralToken gt = null; try { HttpClient hc = new HttpClient(); Map<String, String> params = new HashMap<String, String>(); params.put("appid", appid); params.put("secret", secret); params.put("grant_type", "client_credential"); String url = "https://api.weixin.qq.com/cgi-bin/token"; gt = hc.post(url, params, new JsonParser<GeneralToken>(GeneralToken.class)); } catch (IOException e) { log.error("get token error message:" + e.getMessage() , e); e.printStackTrace(); } return gt; }
public class GeneralToken { private String expires_in; //成功有效時間 private String access_token; // 普通Token private String errcode; //失敗ID private String errmsg; //失敗消息 //get set 忽略 }
2.自己定義單例類(單例類一個實例,而且實例化由類帶本身完畢,並向其他類提供使用)
public class Token { private Token() {} private String token; private static Token instance = new Token(); public static Token getInstance() { return instance; } public String getToken() { return token; } public void setToken(String token) { this.token = token; } }
3.給Token類中token變量賦值,
在 Servlet API 中有一個 ServletContextListener 接口,它可以監聽 ServletContext 對象的生命周期,實際上就是監聽 Web 應用的生命周期。當Servlet 容器啟動或終止Web 應用時。會觸發ServletContextEvent 事件。該事件由ServletContextListener 來處理。在 ServletContextListener 接口中定義了處理ServletContextEvent事件的兩個方法。
方法1:contextInitialized(ServletContextEvent sce) :當Servlet 容器啟動Web 應用時調用該方法。在調用完該方法之后,容器再對Filter 初始化。而且對那些在Web 應用啟動時就須要被初始化的Servlet進行初始化。
方法2:contextDestroyed(ServletContextEvent sce) :當Servlet 容器終止Web 應用時調用該方法。在調用該方法之前,容器會先銷毀全部的Servlet 和Filter 過濾器。
public class ContextListener implements ServletContextListener { @Override public void contextInitialized(ServletContextEvent sce) { ConfigurationService configurationService = ServerUtil.getBean(ConfigurationService.class); String appid = configurationService.getValue(Constants.WX_APPID, Constants.CONFIGURATION_GROUP_WEIXIN); String secret = configurationService.getValue(Constants.WX_APPSECRET, Constants.CONFIGURATION_GROUP_WEIXIN); GeneralToken gt = WeixinMessageUtil.getToken(appid, secret); if(gt != null && !StringUtil.isNullOrEmpty(gt.getAccess_token())){ Token.getInstance().setToken(gt.getAccess_token()); } } }
4.使用Spring quartz讓Token永只是期。
applicationContext.xml,加入配置。
<bean id="getTokenTask" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean"> <property name="targetObject"> <ref bean="taskService" /> </property> <property name="targetMethod"> <value>getToken</value> </property> <property name="concurrent" value="true" /> </bean> <bean id="getTokenTime" class="org.springframework.scheduling.quartz.CronTriggerBean"> <property name="jobDetail"> <ref bean="getTokenTask"/> </property> <property name="cronExpression"> <value>0 0 0/2 * * ?</value> </property> </bean> <bean id="startQuertz" lazy-init="false" class="org.springframework.scheduling.quartz.SchedulerFactoryBean"> <property name="triggers"> <list> <ref bean="getTokenTime"/> </list> </property> </bean>
加入創建TaskService接口
public interface TaskService { public void getToken(); }
實現TaskService接口
@Service("taskService") public class TaskServiceImpl implements TaskService { private static Token tokenCache = Token.getInstance(); @Override public void getToken() { try { HttpClient hc = new HttpClient(); if (!StringUtil.isNullOrEmpty(Constants.WX_APPID) && !StringUtil.isNullOrEmpty(Constants.WX_APPSECRET)) { Map<String, String> params = new HashMap<String, String>(); params.put("appid", Constants.WX_APPID); params.put("secret", Constants.WX_APPSECRET); params.put("grant_type", "client_credential"); String url = "https://api.weixin.qq.com/cgi-bin/token"; GeneralToken gt = hc.post(url, params, new JsonParser<GeneralToken>(GeneralToken.class)); if (gt != null && !StringUtil.isNullOrEmpty(gt.getAccess_token())) { System.out.println("token:" +gt.getAccess_token()); tokenCache.setToken(gt.getAccess_token()); } } } catch (IOException e) { e.printStackTrace(); } } }
注:當中HttpClient 類是被封裝過的工具類,