[置顶] java微信开发API解析（三）-高级功能的前奏----获取以及保存接口调用凭证

说明

*详细说明请参考前两篇文章。
*本文分为三部分：
    接口调用凭证access_token的作用以及解释
    如何获取接口调用凭证access_token
    如何实现微信文档所说的“中控服务器”的实现以保存access_token
* 本文结束会给出包括本文前三篇文章的所有演示源码

为什么要获取和保存接口调用凭证access_token

• 开始开发-获取接口调用凭据

  • 文档地址：http://mp.weixin.qq.com/wiki/14/9f9c82c1af308e3b14ba9b973f99a8ba.html

• 官网文档给出这样解释：

  • access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。

• 理解：

  • 我们简单翻阅文档可以发现，许多高级功能，例如：自定义菜单、素材管理、用户管理、账号管理等各种高级功能请求的链接中都有“?access_token=TOKEN”这个参数，这是全局调用参数，微信后台需要根据这个参数确定身份，保证我们的微信公众号的安全。
  • 为了防止公众号的程序错误而引发微信服务器负载异常，默认情况下，每个公众号调用接口都不能超过一定限制，这里微信限制每天2000次。所以，如果我们想要频繁调用这个参数，需要我们开发者手动保存，每个access_token有效期是2个小时。

获取接口调用凭证access_token

• 官网文档给出这样解释：

  • 接口调用请求说明

    http请求方式: GET
    https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

    • 返回说明

    正常情况下，微信会返回下述JSON数据包给公众号：
    {“access_token”:”ACCESS_TOKEN”,”expires_in”:7200}

    错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:
    {“errcode”:40013,”errmsg”:”invalid appid”}

• 理解：

  • GET请求，该方式直接在本地就可以实现。因为只是一个普通的GET请求，类似于访问网址。所以，不需要上传该部分代码到服务器就可以直接操作。
  • http请求协议是GET请求，说明我们需要通过GET请求获取返回流，返回流是json形式。调用时我们需要携带三个参数：grant_type、appid、secret。其中appid和secret是我们微信公众号关键的参数，在前文已经阐述。返回结果分为正确和错误两种结果。【百度：json】
  • 其实，我们可以直接在地址栏输入文档给的示例：https://api.weixin.qq.com/cgi-bin/token？grant_type=client_credential&appid=APPID&secret=APPSECRET，我们会看到这样的信息：“{“errcode”:40013,”errmsg”:”invalid appid hint: [pQKl0120ic11]”}”，因为这是一个无效的请求，返回的是错误的结果。
  • 当我们把自己的测试号APPID和APPSECRET替换上面的那两个参数，会看到这样的信息：“{“access_token”:”XrllR3fNf…bADAMIO”,”expires_in”:7200}”,代表获取成功。
  • 现在我们通过java 代码获取返回流，拿取access_token。

• 实现

  private static final long MAX_TIME = 7200 * 1000;// 微信允许最长Access_token有效时间（ms）
  private static final String TAG = "WeixinApiTest";// TAG
  private static final String APPID = "wx889b****b3666b0b8";// APPID
  private static final String SECERT = "6da7676***f0a9f15fbf06027856bb";// 秘钥
  
  /*
   * 该测试用例演示了如何获取access_token。
   * access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。
   */
  @Test
  public void getAccess_token() throws IOException {
      // 拼接api要求的httpsurl链接
      String urlString = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="
              + APPID + "&secret=" + SECERT;
      // 创建一个url
      URL reqURL = new URL(urlString);
      // 拿取链接
      HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL
              .openConnection();
      // 取得该连接的输入流，以读取响应内容
      InputStreamReader isr = new InputStreamReader(
              httpsConn.getInputStream());
      // 读取服务器的响应内容并显示
      char[] chars = new char[1024];
      String reslut = "";
      int len;
      while ((len = isr.read(chars)) != -1) {
          reslut += new String(chars, 0, len);
      }
      isr.close();
      /*
       * 转化json成javabean。引入了第三方jar:GSON
       */
      Gson gson = new Gson();// 将获取的json转化为java中的bean
      // 注意：Access_token access_token是一个自己创建的javabean
      Access_token access_token = gson.fromJson(reslut,
              new Access_token().getClass());
      if (access_token.getAccess_token() != null) {
          System.out.println("获取的access_token是："
                  + access_token.getAccess_token());
          System.out.println("该access_token的有效时间是："
                  + access_token.getExpires_in() + "s");
      } else {
          System.out.println(TAG + "获取access_token失败，请检查");
  
      }
  
  }
  

保存接口调用凭证access_token

• 思路

  将获取到的Access_token和当前时间存储到file里， 取出时判断当前时间和存储里面的记录的时间的时间差，如果大于MAX_TIME,重新获取，并且将获取到的存储到file替换原来的内容，如果小于MAX_TIME，直接获取。

• 实现

      /*
       * 该方法实现获取Access_token、保存并且只保存2小时Access_token。如果超过两个小时重新获取；如果没有超过两个小时，直接获取。该方法依赖
       * ：public static String getAccessToken()；
       * 
       * 思路:将获取到的Access_token和当前时间存储到file里，
       * 取出时判断当前时间和存储里面的记录的时间的时间差，如果大于MAX_TIME,重新获取，并且将获取到的存储到file替换原来的内容
       * ，如果小于MAX_TIME，直接获取。
       */
      @Test
      public void getSavedAccess_token() throws IOException {
          Gson gson = new Gson();
          String mAccess_token = null;// 需要获取的Access_token；
          File file = new File("temp_access_token.temp");// Access_token保存的位置
          // 如果文件不存在，创建
          if (!file.exists())
              file.createNewFile();
          // 如果文件大小等于0，说明第一次使用，存入Access_token
          if (file.length() == 0) {
              mAccess_token = getAccessToken();
              FileOutputStream fos = new FileOutputStream(file, false);// 不允许追加
              Access_token at = new Access_token();
              at.setAccess_token(mAccess_token);
              at.setExpires_in(System.currentTimeMillis() + "");
              String json = gson.toJson(at);
              fos.write((json).getBytes());
              fos.close();
          } else {
              // 读取文件内容
              FileInputStream fis = new FileInputStream(file);
              byte[] b = new byte[2048];
              int len = fis.read(b);
              String mJsonAccess_token = new String(b, 0, len);// 读取到的文件内容
              Access_token access_token = gson.fromJson(mJsonAccess_token,
                      new Access_token().getClass());
              if (access_token.getExpires_in() != null) {
                  long saveTime = Long.parseLong(access_token.getExpires_in());
                  long nowTime = System.currentTimeMillis();
                  long remianTime = nowTime - saveTime;
                  // System.out.println(TAG + "时间差：" + remianTime);
                  if (remianTime < MAX_TIME) {
                      Access_token at = gson.fromJson(mJsonAccess_token,
                              new Access_token().getClass());
                      mAccess_token = at.getAccess_token();
                  } else {
                      mAccess_token = getAccessToken();
                      FileOutputStream fos = new FileOutputStream(file, false);// 不允许追加
                      Access_token at = new Access_token();
                      at.setAccess_token(mAccess_token);
                      at.setExpires_in(System.currentTimeMillis() + "");
                      String json = gson.toJson(at);
                      fos.write((json).getBytes());
                      fos.close();
                  }
  
              }
          }
  
          System.out.println("获取到的Access_token是：" + mAccess_token);
      }
  
      /*
       * 获取微信服务器AccessToken。该部分和getAccess_token() 一致，不再加注释
       */
      public static String getAccessToken() {
          String urlString = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="
                  + APPID + "&secret=" + SECERT;
          String reslut = null;
          try {
              URL reqURL = new URL(urlString);
              HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL
                      .openConnection();
              InputStreamReader isr = new InputStreamReader(
                      httpsConn.getInputStream());
              char[] chars = new char[1024];
              reslut = "";
              int len;
              while ((len = isr.read(chars)) != -1) {
                  reslut += new String(chars, 0, len);
              }
              isr.close();
          } catch (IOException e) {
  
              e.printStackTrace();
          }
          Gson gson = new Gson();
          Access_token access_token = gson.fromJson(reslut,
                  new Access_token().getClass());
          if (access_token.getAccess_token() != null) {
              return access_token.getAccess_token();
          } else {
              return null;
          }
      }
  

前三篇文章演示源码：http://download.csdn.net/detail/wgyscsf/9483087