前一篇文章里我们已经把微信公众平台接口中消息及相关操作都进行了封装,本章节将主要介绍怎样接收微信server发送的消息并做出响应。
明确在哪接收消息
从微信公众平台接口消息指南中能够了解到,当用户向公众帐号发消息时,微信server会将消息通过POST方式提交给我们在接口配置信息中填写的URL,而我们就须要在URL所指向的请求处理类CoreServlet的doPost方法中接收消息、处理消息和响应消息。
接收、处理、响应消息
以下先来看我已经写好的CoreServlet的完整代码:
- package org.liufeng.course.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.liufeng.course.service.CoreService;
- import org.liufeng.course.util.SignUtil;
- /**
- * 核心请求处理类
- *
- * @author liufeng
- * @date 2013-05-18
- */
- public class CoreServlet extends HttpServlet {
- private static final long serialVersionUID = 4440739483644821986L;
- /**
- * 确认请求来自微信server
- */
- 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;
- }
- /**
- * 处理微信server发来的消息
- */
- public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
- // 将请求、响应的编码均设置为UTF-8(防止中文乱码)
- request.setCharacterEncoding("UTF-8");
- response.setCharacterEncoding("UTF-8");
- // 调用核心业务类接收消息、处理消息
- String respMessage = CoreService.processRequest(request);
- // 响应消息
- PrintWriter out = response.getWriter();
- out.print(respMessage);
- out.close();
- }
- }
代码说明:
1)第51行代码:微信serverPOST消息时用的是UTF-8编码,在接收时也要用相同的编码,否则中文会乱码;
2)第52行代码:在响应消息(回复消息给用户)时,也将编码方式设置为UTF-8,原理同上;
3)第54行代码:调用CoreService类的processRequest方法接收、处理消息,并得到处理结果;
4)第57~59行:调用response.getWriter().write()方法将消息的处理结果返回给用户
从doPost方法的实现能够看到,它是通过调用CoreService类的processRequest方法接收、处理消息的,这样做的目的是为了解耦,即业务相关的操作都不在Servlet里处理,而是全然交由业务核心类CoreService去做。以下来看CoreService类的代码实现:
- package org.liufeng.course.service;
- import java.util.Date;
- import java.util.Map;
- import javax.servlet.http.HttpServletRequest;
- import org.liufeng.course.message.resp.TextMessage;
- import org.liufeng.course.util.MessageUtil;
- /**
- * 核心服务类
- *
- * @author liufeng
- * @date 2013-05-20
- */
- public class CoreService {
- /**
- * 处理微信发来的请求
- *
- * @param request
- * @return
- */
- public static String processRequest(HttpServletRequest request) {
- String respMessage = null;
- try {
- // 默认返回的文本消息内容
- String respContent = "请求处理异常,请稍候尝试!";
- // xml请求解析
- Map<String, String> requestMap = MessageUtil.parseXml(request);
- // 发送方帐号(open_id)
- String fromUserName = requestMap.get("FromUserName");
- // 公众帐号
- String toUserName = requestMap.get("ToUserName");
- // 消息类型
- String msgType = requestMap.get("MsgType");
- // 回复文本消息
- TextMessage textMessage = new TextMessage();
- textMessage.setToUserName(fromUserName);
- textMessage.setFromUserName(toUserName);
- textMessage.setCreateTime(new Date().getTime());
- textMessage.setMsgType(MessageUtil.RESP_MESSAGE_TYPE_TEXT);
- textMessage.setFuncFlag(0);
- // 文本消息
- if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) {
- respContent = "您发送的是文本消息!";
- }
- // 图片消息
- else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_IMAGE)) {
- respContent = "您发送的是图片消息!";
- }
- // 地理位置消息
- else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LOCATION)) {
- respContent = "您发送的是地理位置消息!";
- }
- // 链接消息
- else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LINK)) {
- respContent = "您发送的是链接消息!";
- }
- // 音频消息
- else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_VOICE)) {
- respContent = "您发送的是音频消息!";
- }
- // 事件推送
- else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_EVENT)) {
- // 事件类型
- String eventType = requestMap.get("Event");
- // 订阅
- if (eventType.equals(MessageUtil.EVENT_TYPE_SUBSCRIBE)) {
- respContent = "谢谢您的关注!";
- }
- // 取消订阅
- else if (eventType.equals(MessageUtil.EVENT_TYPE_UNSUBSCRIBE)) {
- // TODO 取消订阅后用户再收不到公众号发送的消息,因此不须要回复消息
- }
- // 自己定义菜单点击事件
- else if (eventType.equals(MessageUtil.EVENT_TYPE_CLICK)) {
- // TODO 自己定义菜单权沒有开放,暂不处理该类消息
- }
- }
- textMessage.setContent(respContent);
- respMessage = MessageUtil.textMessageToXml(textMessage);
- } catch (Exception e) {
- e.printStackTrace();
- }
- return respMessage;
- }
- }
代码说明:
1)第29行:调用消息工具类MessageUtil解析微信发来的xml格式的消息,解析的结果放在HashMap里;
2)32~36行:从HashMap中取出消息中的字段;
3)39-44、84行:组装要返回的文本消息对象;
4)47~82行:演示了怎样接收微信发送的各类型的消息,依据MsgType推断属于哪种类型的消息;
5)85行:调用消息工具类MessageUtil将要返回的文本消息对象TextMessage转化成xml格式的字符串;
关于事件推送(关注、取消关注、菜单点击)
对于消息类型的推断,像文本消息、图片消息、地理位置消息、链接消息和语音消息都比較好理解,有非常多刚接触的朋友搞不懂事件推送消息有什么用,或者不清晰该怎样推断用户关注的消息。那我们就专门来看下事件推送,下图是官方消息接口文档中关于事件推送的说明:
这里我们仅仅要关心两个參数:MsgType和Event。当MsgType=event时,就表示这是一条事件推送消息;而Event表示事件类型,包含订阅、取消订阅和自己定义菜单点击事件。也就是说,不管用户是关注了公众帐号、取消对公众帐号的关注,还是在使用公众帐号的菜单,微信server都会发送一条MsgType=event的消息给我们,而至于详细这条消息表示关注、取消关注,还是菜单的点击事件,就须要通过Event的值来推断了。(注意区分Event和event)
连载五篇教程总结
经过5篇的解说,已经把开发模式启用,接口配置,消息相关工具类的封装,消息的接收与响应所有解说完了,并且贴上了完整的源码,相信有一定Java基础的朋友能够看的明确,能够通过系列文章基本掌握微信公众平台开发的相关技术知识。以下我把眼下项目的完整结构贴出,方便大家对比:
假设认为文章对你有所帮助,请留言支持或关注微信公众帐号xiaoqrobot支持柳峰哦!