接入微信公众平台
验证消息是否来自于微信服务器
开发者提交信息后,微信服务器将发送GET请求到填写的服务器地址URL上,GET请求携带参数如下表所示:
参数 | 概述 |
---|---|
signature | 微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。加密/校验流程如下:
1)将token、timestamp、nonce三个参数进行字典序排序
2)将三个参数字符串拼接成一个字符串进行sha1加密
3)开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
新建一个Java web工程创建一个Servlet
package org.sm.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.sm.util.SignUtil;
/**
* 核心请求处理类
*
* @author sunming
* @date 2017-08-1
*/
public class ServiceServlet extends HttpServlet {
private static final long serialVersionUID = 2844745299238798077L;
/**
* 确认请求来自微信服务器
*/
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 微信加密签名
String signature = request.getParameter("signature");
// 时间戳
String timestamp = request.getParameter("timestamp");
// 随机数
String nonce = request.getParameter("nonce");
// 随机字符串
String echostr = request.getParameter("echostr");
PrintWriter out = response.getWriter();
// 通过检验signature对请求进行校验,若校验成功则原样返回echostr,表示接入成功,否则接入失败
if (SignUtil.checkSignature(signature, timestamp, nonce)) {
out.print(echostr);
System.out.println("恭喜连接成功..");
}
out.close();
out = null;
}
/**
* 处理微信服务器发来的消息
*/
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// do some things
}
}
Servlet中用到的SignUtil工具类
package org.sm.util;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/**
* 请求校验工具类
*
* @author sunming
* @date 2017-08-1
*/
public class SignUtil {
// 与接口配置信息中的Token要一致
private static String token = "weixintoken";
/**
* 验证签名
*
* @param signature
* 微信加密签名
* @param timestamp
* 时间戳
* @param nonce
* 随机数
* @return
*/
public static boolean checkSignature(String signature, String timestamp, String nonce) {
List<String> list = new ArrayList();
list.add(token);
list.add(timestamp);
list.add(nonce);
Collections.sort(list);
StringBuilder content = new StringBuilder();
for (String param : list) {
content.append(param);
}
MessageDigest md = null;
String tmpStr = null;
try {
md = MessageDigest.getInstance("SHA-1");
// 将三个参数字符串拼接成一个字符串进行sha1加密
byte[] digest = md.digest(content.toString().getBytes());
tmpStr = byteToStr(digest);
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
content = null;
// 将sha1加密后的字符串可与signature对比,标识该请求来源于微信
return tmpStr != null ? tmpStr.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;
}
}
web.xml中配置
<servlet>
<servlet-name>serviceServlet</servlet-name>
<servlet-class>
org.sm.servlet.ServiceServlet
</servlet-class>
</servlet>
<!-- url-pattern中配置的/coreServlet用于指定该Servlet的访问路径 -->
<servlet-mapping>
<servlet-name>serviceServlet</servlet-name>
<url-pattern>/serviceServlet</url-pattern>
</servlet-mapping>
整个项目结构
将项目部署到tomcat中,启动服务器。
二.内网穿透
tomcat服务器启动了,回头再看下微信公众平台服务器配置
其中token就是咱请求校验工具类SignUtil中定义的token,EncodingAESKey是随机生成的,主要看下URL。咱们的项目是起在本地的想要在外网上访问怎么办呢那就需要用到内网穿透工具,我用的是ngrok,使用很简单,将工具下下来后解压,在鼠标移到解压路径上敲“cmd”命令
然后敲入 ngrok http tomcat端口号 就得到外网地址
URL由外网地址/项目名称/指定Servlet的访问路径 组成。
修改配置提交成功之后,控制台打印 恭喜连接成功.. 说明与接入微信公众平台成功了然后点击启用,下面的工作就是编写咱们自己需要的业务。