使用Java语言开发微信公众平台(五)——获取access_to
在前四期的文章中，我们分别学习了“环境搭建与开发接入”、“文本消息的接收与响应”、“被关注回复与关键词回复”、“图文消息的发送与响应”等环节。那么，从本篇博文开始，我们将进去更高级的开发层面，调用微信公众平台提供的各种接口。
今天，我们来学习一下微信公众平台最基础的一个接口——access_token，access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。
当然，从本章开始，我们需要调用的各种接口，均需使用服务号开发。没有服务号的小伙伴，可以选择申请一个测试账号，详情查看系列博文第一篇<环境搭建与开发接入>
一、了解access_token
正如前言所述，access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。
公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在微信公众平台官网-开发者中心页中获得。且一个公众号每天获取access_token的次数上限为2000次。
①接口调用请求地址
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
② 需要传递参数说明
③ 返回参数说明
从上述请求地址，以及参数和响应表格可以知道，我们需要通过请求传递三个参数给微信公众平台，分别是grant_type（获取access_token填写client_credential）、appid、appsecret，请求成功后，公众平台会将access_token以及有效期返回给我们。
二、组装请求access_token的工具类
在了解了access_token之后，我们开始组装一个工具类，来向服务器发送请求获取access_token。在我们之前的Util包下，新建一个WeiXinUtil.java工具类
[剧透一下]由于在开发过程中，我们需要①将接收过来的结果转成JSON格式 ② 使用HttpClient发送HTTP请求，所以需要导入几个Jar包，导入Jar包列表如下（其中，红色框为第①部分所需，蓝色框为第②部分所需）：
Jar包导入完成后，进入我们的代码实战环节，打开我们的WeiXinUtil.java工具类，封装三个常量，分别是我们的APPID、APPSECRET、以及请求access_token的URL：
接下来我们组装两个方法，分别是使用Get和Post对我们的URL发起请求，当我们直接请求URL而不需要传递参数时，可使用Get请求，而当我们需要传递参数的时候，就需要使用Post请求，这两个请求的实现，均需借助我们导入HttpClient这两个Jar包：
① Get请求的实现（相关代码解释已在注释阐明）
② Post请求的实现（相关代码解释已在注释阐明）
三、创建AccessToken实体类
由第一部分返回结果说明我们可以知道，当我们执行请求URL，并且请求成功后，公众平台会将access_token以及有效期返回给我们。所以我们需要新建一个AccessToken实体类用于组装返回结果，实体类属性如下：
四、获取Access_Token并编写测试类
① 在WeiXinUtil.java工具类中，新增getAccessToken方法
② 编写测试类，测试方法
③ 运行测试类，即可取到Access_Token及有效期
由于每个公众账号一天请求2000次Access_Token，在一些访问量大的公众号上显然是不够用的，因此我们可以将取到的Access_Token存到本地，每次使用时判断是否过期，如果没有过期就不要再发送请求啦~
这个问题呢，作为一个课后练习，有能力的小伙伴可能自行尝试哦~
【附】WeiXinUtil.Java 源码部分
package com.jredu.util;
import java.io.IOException;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;
import com.jredu.entity.AccessToken;
import net.sf.json.JSONObject;
public class WeiXinUtil {
//从微信后台拿到APPID和APPSECRET 并封装为常量
private static final String APPID = "wxe09763a06d980f09";
private static final String APPSECRET = "3a6005a4c7589ca9e93297c72f7eaf4d";
private static final String ACCESS_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
/**
* 编写Get请求的方法。但没有参数传递的时候，可以使用Get请求
*
* @param url 需要请求的URL
* @return 将请求URL后返回的数据，转为JSON格式，并return
*/
public static JSONObject doGetStr(String url) throws ClientProtocolException, IOException {
DefaultHttpClient client = new DefaultHttpClient();//获取DefaultHttpClient请求
HttpGet httpGet = new HttpGet(url);//HttpGet将使用Get方式发送请求URL
JSONObject jsonObject = null;
HttpResponse response = client.execute(httpGet);//使用HttpResponse接收client执行httpGet的结果
HttpEntity entity = response.getEntity();//从response中获取结果，类型为HttpEntity
if(entity != null){
String result = EntityUtils.toString(entity,"UTF-8");//HttpEntity转为字符串类型
jsonObject = JSONObject.fromObject(result);//字符串类型转为JSON类型
}
return jsonObject;
}
/**
* 编写Post请求的方法。当我们需要参数传递的时候，可以使用Post请求
*
* @param url 需要请求的URL
* @param outStr 需要传递的参数
* @return 将请求URL后返回的数据，转为JSON格式，并return
*/
public static JSONObject doPostStr(String url,String outStr) throws ClientProtocolException, IOException {
DefaultHttpClient client = new DefaultHttpClient();//获取DefaultHttpClient请求
HttpPost httpost = new HttpPost(url);//HttpPost将使用Get方式发送请求URL
JSONObject jsonObject = null;
httpost.setEntity(new StringEntity(outStr,"UTF-8"));//使用setEntity方法，将我们传进来的参数放入请求中
HttpResponse response = client.execute(httpost);//使用HttpResponse接收client执行httpost的结果
String result = EntityUtils.toString(response.getEntity(),"UTF-8");//HttpEntity转为字符串类型
jsonObject = JSONObject.fromObject(result);//字符串类型转为JSON类型
return jsonObject;
}
/**
* 获取AccessToken
* @return 返回拿到的access_token及有效期
*/
public static AccessToken getAccessToken() throws ClientProtocolException, IOException{
AccessToken token = new AccessToken();
String url = ACCESS_TOKEN_URL.replace("APPID", APPID).replace("APPSECRET", APPSECRET);//将URL中的两个参数替换掉
JSONObject jsonObject = doGetStr(url);//使用刚刚写的doGet方法接收结果
if(jsonObject!=null){ //如果返回不为空，将返回结果封装进AccessToken实体类
token.setToken(jsonObject.getString("access_token"));//取出access_token
token.setExpiresIn(jsonObject.getInt("expires_in"));//取出access_token的有效期
}
return token;
}
}
