Java开发微信公众号（二）——开发请求校验程序

开发IDE：MyEclipse或Eclipse或IDEA都可以，我现在用的是MyEclipse。

请求校验流程分析

上一篇中我们讲了微信开发环境的搭建，下面就来写请求校验程序的开发，目的是是为了验证消息的确来自微信服务器。
开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带参数如下表所示：

开发者通过检验signature对请求进行校验，若确认此次GET请求来自微信服务器，原样返回echostr参数内容，则接入生效，否则接入失败。加密/校验流程如下：
- 将token、timestamp、nonce三个参数进行字典排序；
- 将三个参数字符串拼接成一个字符串进行sha1加密；
- 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信。

注意：微信公众号接口必须以http://或https://开头，分别支持80端口和443端口。

请求校验程序的实现

SignUtil类封装请求校验流程

新建一个名为wechat_read的web项目，在项目的src下新建一个工具类SignUtil，该类对请求校验流程的实现进行了封装，方便在Servlet中调用。SignUtil类的代码如下【参考书籍《微信公众平台应用开发》——柳峰】：

package com.zrxjuly.read.util;

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;

/**
 * 描述：请求校验工具类.
 * @author zrxJuly
 * @createDate 2017-12-9
 * @since 1.0
 *
 */
public class SignUtil {

    // 与开发模式接口配置信息中的Token保持一致.
    private static String token = "weixinCourse";

    /**
     * 校验签名
     * @param signature 微信加密签名.
     * @param timestamp 时间戳.
     * @param nonce 随机数.
     * @return
     */
    public static boolean checkSignature(String signature, String timestamp, String nonce) {
        // 对token、timestamp、和nonce按字典排序.
        String[] paramArr = new String[] {token, timestamp, nonce};
        Arrays.sort(paramArr);

        // 将排序后的结果拼接成一个字符串.
        String content  = paramArr[0].concat(paramArr[1]).concat(paramArr[2]);

        String ciphertext = null;
        try {
            MessageDigest md = MessageDigest.getInstance("SHA-1");
            // 对拼接后的字符串进行sha1加密.
            byte[] digest = md.digest(content.toString().getBytes());
            ciphertext = byteToStr(digest);
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        }

        // 将sha1加密后的字符串与signature进行对比.
        return ciphertext != null ? ciphertext.equals(signature.toUpperCase()) : false;
    }

    /**
     * 将字节数组转换为十六进制字符串.
     * @param byteArray
     * @return
     */
    private static String byteToStr(byte[] byteArray) {
        String strDigest = "";
        for (int i = 0; i < byteArray.length; i++) {
            strDigest += byteToHexStr(byteArray[i]);
        }
        return strDigest;
    }

    /**
     * 将字节转换为十六进制字符串.
     * @param mByte
     * @return
     */
    private static String byteToHexStr(byte mByte) {
        char[] Digit = { '0', '1' , '2', '3', '4' , '5', '6', '7' , '8', '9', 'A' , 'B', 'C', 'D' , 'E', 'F'};
        char[] tempArr = new char[2];
        tempArr[0] = Digit[(mByte >>> 4) & 0X0F];
        tempArr[1] = Digit[mByte & 0X0F];

        String s = new String(tempArr);
        return s;
    }


}

CoreServlet类接收GET请求传递的参数

创建一个Servlet类，用于接收Get请求传递的4个参数，并调用SignUtil工具类中封装的checkSignature()方法进行请求校验，如果校验成功，则将接收到的参数echostr原样返回。CoreServlet类：

package com.zrxjuly.read.servlet;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Map;

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

import com.zrxjuly.read.util.MessageHandlerUtil;
import com.zrxjuly.read.util.SignUtil;

/**
 * 请求处理的核心类.
 * @author zrxJuly
 * @createDate 2017-12-9
 * @since TODO: 1.0
 *
 */
public class CoreServlet extends HttpServlet {

    /**
     * 请求校验(确认请求来自微信服务器).
     * @see javax.servlet.http.HttpServlet#doGet(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)
     */
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("=======开始请求校验======");

        // 微信加密签名.
        String signature = request.getParameter("signature");
        System.out.println("signature====" + signature);
        // 时间戳.
        String timestamp = request.getParameter("timestamp");
        System.out.println("timestamp====" + timestamp);
        // 随机数.
        String nonce = request.getParameter("nonce");
        System.out.println("nonce====" + nonce);
        // 随机字符串.
        String echostr = request.getParameter("echostr");
        System.out.println("echostr====" + echostr);

        PrintWriter out = response.getWriter();

        // 请求校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败.
        if (SignUtil.checkSignature(signature, timestamp, nonce)) {
            System.out.println("=======请求校验成功======" + echostr);
            out.print(echostr);
        }

        out.close();
        out = null;
    }

    /**
     * 处理微信服务器发来的消息.
     * @see javax.servlet.http.HttpServlet#doPost(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)
     */
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 将请求、响应的编码均设置为UTF-8（防止中文乱码）

    }

}

web.xml中配置servlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <display-name></display-name>

  <servlet>
    <servlet-name>coreServlet</servlet-name>
    <servlet-class>com.zrxjuly.read.servlet.CoreServlet</servlet-class>
  </servlet>


  <servlet-mapping>
    <servlet-name>coreServlet</servlet-name>
    <url-pattern>/coreServlet</url-pattern>
  </servlet-mapping>    
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
</web-app>

部署运行项目

请求校验程序写完后，我们将项目部署到tomcat（tomcat端口号是8080）上，运行。用上一节的公网映射：首先找到我们之前下载的natapp.exe，因为上一篇中我们已经运行了，所以这一次直接双击打开就可以了。在浏览器地址栏中输入forwarding
这里写图片描述
然后输入项目启动完整路径：http://你的forwarding/wechat_read/coreServlet，发现项目报空指针异常，如下图：

这是因为没有传那四个参数，我们下一步需要配置接口配置信息。

接口配置信息中填入映射的外网地址和token

登录进入微信公众平台接口测试管理页面https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login，配置接口配置信息：

特别注意：一定要先将本地项目部署运行之后再配置该接口信息，才能配置成功，否则就会配置失败。

这样我们的请求校验程序就完成了。简单来理解，请求校验的目的就是为了证明请求是微信服务器发出的，为了验证消息是来自微信服务器。
如果在操作过程中有问题，欢迎随时讨论^.^