开发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,配置接口配置信息:
特别注意:一定要先将本地项目部署运行之后再配置该接口信息,才能配置成功,否则就会配置失败。
这样我们的请求校验程序就完成了。简单来理解,请求校验的目的就是为了证明请求是微信服务器发出的,为了验证消息是来自微信服务器。
如果在操作过程中有问题,欢迎随时讨论^.^