前期准备
注册一个公众号,完成认证,阅读开发手册,选取开发工具,配置环境等等。
微信公众号开发标准
通过阅读文档我们了解到微信服务器向开发者提供接口,具体的流程如下
由上图可以看出,开发者需要做的:接入接口;解析数据包判断消息类型;设置对于消息的回复;以及部署程序到服务器,而用户和微信服务器之间的通讯我们并不需要关注。
接口的接入:get
消息的传输:post
消息传输类型:
微信——>开发者:XML,JSON格式
开发者——–>微信:XML,JSON格式
我们以文本信息为例:
/**
ToUserName 开发者微信号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间 (整型)
MsgType text
Content 文本消息内容
MsgId 消息id,64位整型
**/
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>1234567890123456</MsgId>
</xml>
这里可以看出微信给出的格式并不适标准的XML格式,当我们后台接受到这个数据包时要,要进行解析,通过这个数据包里的MsgType来判断这个是什么type的信息来选择回复什么样的内容。
验证接口
登录微信公众号测试平台,配置接口的信息:
设置token字段,这个字段将用来验证接口。
借口验证的逻辑:获取微信get的数据包,解析数据包signature字段:
1)将token、timestamp、nonce三个参数进行字典序排序
2)将三个参数字符串拼接成一个字符串进行sha1加密
3)开发者获得加密后的字符串可与signature对比,标识该请求来源于微信)
若一致,原样返回数据包中eschor字段。
程序编写
这里我选择的是servlet,新建一个web工程,在src下建立一个WxServlet类,继承HttpServlet类,,重写doGet方法:
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
try {
System.out.println("beginning");
String signature=request.getParameter("signature");
String timestamp=request.getParameter("timestamp");
String nonce =request.getParameter("nonce");
String echostr=request.getParameter("echostr");
PrintWriter out = response.getWriter();
if (SignUtil.checkSignature(signature, timestamp, nonce)) {
System.out.println("success");
out.print(echostr);//如果检验成功输出echostr,微信服务器接收到此输出,才会确认检验完成。
out.close();
out=null;
} else {
System.out.println("failed");
}
} catch (Exception e) {
// TODO: handle exception
System.out.println(e.getMessage());
}
SignUtil类代码:
public class SignUtil {
// 与接口配置信息中的Token要一致
private static String token = "keke24";
/**
* @param signature
* @param timestamp
* @param nonce
* @return
* @throws
*/
public static boolean checkSignature(String signature, String timestamp,String nonce) {
// 1.将token、timestamp、nonce三个参数进行字典序排序
String[] arr = new String[] { token, timestamp, nonce };
Arrays.sort(arr);
// 2. 将三个参数字符串拼接成一个字符串进行sha1加密
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;
// 3.将sha1加密后的字符串可与signature对比,标识该请求来源于微信
return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;
}
/**
* @param byteArray
* @return
* @throws
*/
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
* @throws
*/
private static String byteToHexStr(byte mByte) {
final 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信息
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>weixin_servlet</servlet-name>
<display-name>This is the display name of my J2EE component</display-name>
<description>This is the description of my J2EE component</description>
<servlet-class>weixing.WxServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>weixin_servlet</servlet-name>
<url-pattern>/weixin_servlet</url-pattern>
</servlet-mapping>
</web-app>
紧接着部署程序到服务器,因为博主还在上学,没有服务器可以用,这里教一个简单省钱的办法,通过ngrok将本机的8080端口映射到外网,这样微信服务器就可以访问到我们的程序了,详情可参考上篇文章,ngrok的使用。
以上就配置好了微信接口,真正成为开发者对公众号进行开发了