java微信公众号开发学习笔记（二）——安装eclipse 及token验证

        上次介绍了开发环境的基本搭建，这次开始讲微信公众号的开发。

        首先，安装eclipse EE或者eclipse（自己下载相关插件就可以），我就是用的eclipse。在Eclipse中菜单help选项中选择installnew software选项，在work with 栏中输入 http://download.eclipse.org/releases/ganymede/，选择web and java ee development选项，然后选择next。在About Eclipse中就可以看到图标变了，反正相关都下载一下，不占什么空间。

        其实VPS配置好的话，可以安装在vps上，这样调试可以方便些。不过呢，这也不是问题，可以借助花生壳内网穿透在本地调试。悲催的是，我现在用的网络是共用网络，域名解析ip时总是解析到交换机出口ip，所以没法调。自己注意查看自己解析ip是否与你的ip一致（反正是实验了不行，或许是我哪里没理解正确）。

        需要掌握两个概念：1：serverlet；2：微信公众号验证服务器地址的有效性。

        1、关于详细地serverlet介绍可以参照《Servlet 工作原理解析》https://www.ibm.com/developerworks/cn/java/j-lo-servlet。我理解也不透彻，只知道怎么用，主要是服务端解析处理http/https网络操作，一个是doGet，一个是doPost。doGet()当一个客户通过HTML 表单发出一个HTTP GET请求或直接请求一个URL时，doGet()方法被调用。与GET请求相关的参数添加到URL的后面，并与这个请求一起发送。当不会修改服务器端的数据时，应该使用doGet()方法。doPost()当一个客户通过HTML 表单发出一个HTTPPOST请求时，doPost()方法被调用。与POST请求相关的参数作为一个单独的HTTP 请求从浏览器发送到服务器。当需要修改服务器端的数据时，应该使用doPost()方法。

        另外，由于客户端是通过URL地址访问web服务器中的资源，所以Servlet程序若想被外界访问，必须把servlet程序映射到一个URL地址上，这个工作在web.xml文件中使用元素和元素完成。元素用于注册Servlet，它包含有两个主要的子元素：和，分别用于设置Servlet的注册名称和Servlet的完整类名。 
一个元素用于映射一个已注册的Servlet的一个对外访问路径，它包含有两个子元素：和，分别用于指定Servlet的注册名称和Servlet的对外访问路径。例如：

    ServletDemo

    servlet.ServletDemo

 

 

 

    ServletDemo

    /ServletDemo

 

        浏览器访问的时候只需输入：http://localhost:8080/工程名/ServletDemo，要想访问其他的资源，自己可以尝试一下，基本是这个机构。由于不停地修改代码，有时候eclipse访问会出错，重新启动就Eclipse就好了。

        2、关于接口认证：

        点击网页左侧基本配置，这时将看到接口配置信息界面，如下图所示：

        这里需要填写URL和Token两个值。URL指的是能够接收处理微信服务器发送的GET/POST请求的地址，并且是已经存在的，现在就能够在浏览器访问到的地址(可以是ip也可以是域名)，这就要求我们先把公众帐号后台处理程序开发好（至少应该完成了对GET请求的处理）并部署在公网服务器上（第一节的VPS）。Token相当于自己的钥匙，只有自己可以打开调试微信公众号的大门。

        填写的URL需要正确响应微信发送的Token验证，请阅读接入指南。

        什么意思？就是微信服务器向自己的服务器发出get请求，其中包含四个参数signature、timestamp、nonce、echostr,我们的服务器进行校验。注意：这里就用到了之前说的token。我们在程序中根据加密/校验流程来进行，同样得到一个signature与微信服务器发过来的signature做比较，相等则验证通过，说明自己的服务器可信。否则，验证不通过，自己的服务器无法接受来自微信服务器的数据。

        代码

package org.weixin.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.weixin.util.SignUtil;

/**
  核心请求处理类
 */
public class CoreServlet extends HttpServlet {
	private static final long serialVersionUID = 4440739483644821986L;

	/**
	 * 确认请求来自微信服务器
	 */
	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);
		}
		out.close();
		out = null;
	}

	/**
	 * 处理微信服务器发来的消息
	 */
	public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		// TODO 消息的接收、处理、响应
		this.doget(request,response);
	}

}

package org.weixin.util;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;

/**
 * 请求校验工具类
 */
public class SignUtil {
	// 与接口配置信息中的Token要一致
	private static String token = "XXXX";

	/**
	 * 验证签名
	 * 
	 * @param signature
	 * @param timestamp
	 * @param nonce
	 * @return
	 */
	public static boolean checkSignature(String signature, String timestamp, String nonce) {
		String[] arr = new String[] { token, timestamp, nonce };
		// 将token、timestamp、nonce三个参数进行字典序排序
		Arrays.sort(arr);
		StringBuilder content = new StringBuilder();
		for (int i = 0; i < arr.length; i++) {
			content.append(arr[i]);
		}
		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;
	}
}

          注意要让servlet对浏览器可见，需要对其进行映射：

coreServlet
			org.weixin.servlet.CoreServlet
		
      coreServlet/coreServletindex.jsp

        最后可以开始测试了，在eclipse中导出war包，放到vps上的tomcat\webapps下，来到bin目录运行startup.bat。在微信基本配置中点击提交，显示token验证成功！等下一步开发好servlet后，记得点启用配置。