java微信開發API服務器接入的示例

這篇文章將為大家詳細講解有關java微信開發API服務器接入的示例，小編覺得挺實用的，因此分享給大家做個參考，希望大家閱讀完這篇文章后可以有所收獲。

一、說明

* 本示例根據微信開發文檔：http://mp.weixin.qq.com/wiki/home/index.html最新版(4/3/2016 5:34:36 PM )進行開發演示。

* 編輯平臺：myeclipse10.7+win32+jdk1.7+tomcat7.0

* 服務器： windows server 2008 64bits
* 平臺要求：servlet使用注解方式，平臺要求：j2ee6.0+、jdk6.0+、tomcat7.0+
* 演示更加注重于api解析。
* 為了便于測試說明，每個測試用例為獨立，不依賴于其它方法。對于封裝，不多加考慮。
* 演示盡可能按照API要求進行，目的：了解文檔使用方式，達到舉一反三的效果。
* 知識要求：牢固的java基礎、了解http網絡通信知識、對于javaweb有足夠了解、json解析
* 當前時間：4/3/2016 5:32:57 PM ，以該時間為準。

二、文檔原文（摘要）

文檔地址：http://mp.weixin.qq.com/wiki/8/f9a0b8382e0b77d87b3bcc1ce6fbc104.html
接入微信公眾平臺開發，開發者需要按照如下步驟完成：

1、填寫服務器配置
2、驗證服務器地址的有效性  
3、依據接口文檔實現業務邏輯

三、文檔理解

驗證服務器地址的有效性

1、api這樣介紹：

開發者提交信息后，微信服務器將發送GET請求到填寫的服務器地址URL上，GET請求攜帶四個參數：signature、timestamp、nonce、echostr
開發者通過檢驗signature對請求進行校驗（下面有校驗方式）。
若確認此次GET請求來自微信服務器，請原樣返回echostr參數內容，則接入生效，成為開發者成功，否則接入失敗。
加密/校驗流程如下：
1）、將token、timestamp、nonce三個參數進行字典序排序
2）、將三個參數字符串拼接成一個字符串進行sha1加密
3）、開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信

2、理解

說明該請求是“GET”方式，并且訪問該請求會返回四個參數：signature、timestamp、nonce、echostr。
我們需要接受這幾個參數，然后進行處理。如果驗證成功，返回接收到的“echostr”，否則驗證失敗。
驗證方式是對接受到的token、timestamp、nonce三個參數進行字典序排序，然后進行sha1加密，最后和signature對比。
*加密后的字符串可與signature對比，如果相等【該處api可能解釋不是太明白】，返回“echostr”，驗證成功。

3、實現

創建一個servlet CoreServlet實現HttpServlet，重載doGet方法。
參數準備

// 設置一個全局的token,開發者自己設置。api這樣解釋：Token可由開發者可以任意填寫，
// 用作生成簽名（該Token會和接口URL中包含的Token進行比對，從而驗證安全性）
String token = "wgyscsf";
// 根據api說明，獲取上述四個參數
String signature = req.getParameter("signature");
String timestamp = req.getParameter("timestamp");
String nonce = req.getParameter("nonce");
String echostr = req.getParameter("echostr");

根據api所說的三步驟進行操作

// 第一步:將token、timestamp、nonce三個參數進行字典序排序
String[] parms = new String[] { token, timestamp, nonce };// 將需要字典序排列的字符串放到數組中
Arrays.sort(parms);// 按照api要求進行字典序排序【百度：什么是字典序排序】




// 第二步:將三個參數字符串拼接成一個字符串進行sha1加密【百度：java sha1加密】
// 拼接字符串
String parmsString = "";// 注意，此處不能=null。
for (int i = 0; i < parms.length; i++) {
  parmsString += parms[i];
}
// sha1加密
String mParms = null;// 加密后的結果

... //該地方是sha1加密的實現，不再貼代碼    

mParms = hexString.toString();// 加密結果




/*
 * api要求： 若確認此次GET請求來自微信服務器，請原樣返回echostr參數內容， 則接入生效， 成為開發者成功，否則接入失敗。
 */
// 第三步： 開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信接入成功。
System.out.println(TAG + ":" + mParms + "---->" + signature);
if (mParms.equals(signature)) {
  // System.out.println(TAG + ":" + mParms + "---->" + signature);
  printWriter.write(echostr);
} else {
  // 接入失敗,不用回寫
  // System.out.println(TAG + "接入失敗");
}

4、填寫服務器配置

1）、包括內容
服務器配置主要是當我們寫好自己的接入微信開發平臺的代碼之后要配置的服務器和微信接入接口。
2）、服務器操作
打開服務器的tomcat,將寫好的代碼放到webapps文件下。
3）、微信公眾平臺操作
*申請微信測試賬號（直接用微信掃一掃即可以登錄）：http://www.php.cn/
*打開微信公眾平臺測試號，配置接口配置信息。配置如下
       URL:http://www.php.cn/
       Token:wgyscsf
*提交，配置成功和失敗均會有提醒。

該部分所有操作源碼，可以直接使用

package com.gist.servlet;

import java.io.IOException;
import java.io.PrintWriter;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author 高遠</n> 郵箱：wgyscsf@163.com</n> 博客 http://www.php.cn/;/n>
 *     編寫時期 2016-4-3 下午4:34:05
 */
@WebServlet("/CoreServlet")
public class CoreServlet extends HttpServlet {
  String TAG = "CoreServlet";

  /*
   * 第二步：驗證服務器地址的有效性 開發者提交信息后，微信服務器將發送GET請求到填寫的服務器地址URL上，
   * GET請求攜帶四個參數：signature、timestamp、nonce、echostr
   * 開發者通過檢驗signature對請求進行校驗（下面有校驗方式）。 若確認此次GET請求來自微信服務器，請原樣返回echostr參數內容，
   * 則接入生效， 成為開發者成功，否則接入失敗。
   * 
   * 加密/校驗流程如下： 1. 將token、timestamp、nonce三個參數進行字典序排序 2.
   * 將三個參數字符串拼接成一個字符串進行sha1加密 3. 開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信
   */
  /*
   * 字典排序（lexicographical
   * order）是一種對于隨機變量形成序列的排序方法。其方法是，按照字母順序，或者數字小大順序，由小到大的形成序列。
   */
  @Override
  protected void doGet(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {

    // 設置編碼
    req.setCharacterEncoding("utf-8");
    resp.setContentType("html/text;charset=utf-8");
    resp.setCharacterEncoding("utf-8");
    // 獲取輸出流
    PrintWriter printWriter = resp.getWriter();

    // 設置一個全局的token,開發者自己設置。api這樣解釋：Token可由開發者可以任意填寫，
    // 用作生成簽名（該Token會和接口URL中包含的Token進行比對，從而驗證安全性）
    String token = "wgyscsf";
    // 根據api說明，獲取上述四個參數
    String signature = req.getParameter("signature");
    String timestamp = req.getParameter("timestamp");
    String nonce = req.getParameter("nonce");
    String echostr = req.getParameter("echostr");
    // // temp:臨時打印，觀看返回參數情況
    // System.out.println(TAG + ":signature:" + signature + ",timestamp:"
    // + timestamp + ",nonce:" + nonce + ",echostr:" + echostr);
    // 根據api所說的“加密/校驗流程”進行接入。共計三步

    // 第一步:將token、timestamp、nonce三個參數進行字典序排序
    String[] parms = new String[] { token, timestamp, nonce };// 將需要字典序排列的字符串放到數組中
    Arrays.sort(parms);// 按照api要求進行字典序排序
    // 第二步:將三個參數字符串拼接成一個字符串進行sha1加密
    // 拼接字符串
    String parmsString = "";// 注意，此處不能=null。
    for (int i = 0; i < parms.length; i++) {
      parmsString += parms[i];
    }
    // sha1加密
    String mParms = null;// 加密后的結果
    MessageDigest digest = null;
    try {
      digest = java.security.MessageDigest.getInstance("SHA");
    } catch (NoSuchAlgorithmException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
    digest.update(parmsString.getBytes());
    byte messageDigest[] = digest.digest();
    // Create Hex String
    StringBuffer hexString = new StringBuffer();
    // 字節數組轉換為 十六進制 數
    for (int i = 0; i < messageDigest.length; i++) {
      String shaHex = Integer.toHexString(messageDigest[i] & 0xFF);
      if (shaHex.length() < 2) {
        hexString.append(0);
      }
      hexString.append(shaHex);
    }
    mParms = hexString.toString();// 加密結果

    /*
     * api要求： 若確認此次GET請求來自微信服務器，請原樣返回echostr參數內容， 則接入生效， 成為開發者成功，否則接入失敗。
     */
    // 第三步： 開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信接入成功。
    System.out.println(TAG + ":" + mParms + "---->" + signature);
    if (mParms.equals(signature)) {
      // System.out.println(TAG + ":" + mParms + "---->" + signature);
      printWriter.write(echostr);
    } else {
      // 接入失敗,不用回寫
      // System.out.println(TAG + "接入失敗");
    }
  }

  @Override
  protected void doPost(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    doGet(req, resp);
  }

}

關于“java微信開發API服務器接入的示例”這篇文章就分享到這里了，希望以上內容可以對大家有一定的幫助，使各位可以學到更多知識，如果覺得文章不錯，請把它分享出去讓更多的人看到。