微信公众帐号开发-消息的接收与响应

注：文章来源于柳峰的微信公众平台应用开发

当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。我们就需要在URL所指向的请求处理类CoreServlet的doPost方法中接收消息、处理消息和响应消息。

1：使用CoreServlet类完成消息的接受与响应

  接下来，在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;  
  
    /** 
     * 确认请求来自微信服务器 
     */  
    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 {  
        // 将请求、响应的编码均设置为UTF-8（防止中文乱码）  
        request.setCharacterEncoding("UTF-8");  
        response.setCharacterEncoding("UTF-8");  
  
        // 调用核心业务类接收消息、处理消息  
        String respMessage = CoreService.processRequest(request);  
          
        // 响应消息  
        PrintWriter out = response.getWriter();  
        out.print(respMessage);  
        out.close();  
    }  
  
}  

从代码中可以看出，doPost()方法的实现可以分为编码设置、请求校验、请求处理和响应消息4个部分

1.编码设置

50~51行代码用于编码设置。微信服务器想公众账号服务器post（发送）消息时采用的是UTF-8编码，因此在doPost()方法的最开始处需要将请求、响应的字符集编码方式统一设置为UTF-8，否则可能出现乱码问题。

2.请求校验

在60行代码用于请求校验。为防止他人向公众账号服务器发送恶意请求，需要对每个消息请求进行合法性验证。微信服务器向公众账号服务器POST消息时，也会在URL后面追加4个参数signature, timestamp, nonce和echostr，仍然是通过校验签名判断消息的真实性。

3.请求处理

第62行代码用于请求处理。我们并没有将请求处理代码直接写在doPost()方法中，而是将这部分代码封装在CoreService类中，这样可以一定程度上实现解耦。CoreServlet类不用关心具体的业务处理逻辑，而是完全由核心服务类CoreService处理。CoreService类处理结果respXml是一个XML格式的消息。

4.响应消息

第63行代码用于响应消息。通过调用PrintWriter类的print()方法将处理结果respXml返回给微信服务器。微信服务器在收到消息后，会通过公众账号将消息发送给用户。

2：使用CoreService类完成消息的处理

本例中，CoreService类只有一个processRequest()方法，用于处理请求消息。首先从request对象中解析出请求消息参数，再根据参数MsgType判断请求消息类型，最后返回XML格式的文本消息。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格式的字符串；