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-mapping>元素完成。<servlet>元素用于注册Servlet，它包含有两个主要的子元素：<servlet-name>和<servlet-class>，分别用于设置Servlet的注册名称和Servlet的完整类名。 

一个<servlet-mapping>元素用于映射一个已注册的Servlet的一个对外访问路径，它包含有两个子元素：<servlet-name>和<url-pattern>，分别用于指定Servlet的注册名称和Servlet的对外访问路径。例如：

<servlet>

    <servlet-name>ServletDemo</servlet-name>

    <servlet-class>servlet.ServletDemo</servlet-class>

  </servlet>

 

  <servlet-mapping>

    <servlet-name>ServletDemo</servlet-name>

    <url-pattern>/ServletDemo</url-pattern>

  </servlet-mapping>

        浏览器访问的时候只需输入：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.checkSignatur
a257
e(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对浏览器可见，需要对其进行映射：

<?xml version="1.0" encoding="UTF-8"?>
coreServlet
org.weixin.servlet.CoreServlet
coreServlet/coreServletindex.jsp

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