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.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对浏览器可见，需要对其进行映射：

coreServletorg.weixin.servlet.CoreServletcoreServlet/coreServletindex.jsp

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