上次介绍了开发环境的基本搭建,这次开始讲微信公众号的开发。
首先,安装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文件中使用
一个
浏览器访问的时候只需输入: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;
}
}
coreServlet
org.weixin.servlet.CoreServlet
coreServlet/coreServletindex.jsp
最后可以开始测试了,在eclipse中导出war包,放到vps上的tomcat\webapps下,来到bin目录运行startup.bat。在微信基本配置中点击提交,显示token验证成功!等下一步开发好servlet后,记得点启用配置。