微信公眾賬號開發(fā)教程第5篇-各種消息的接收與響應(yīng)

fshell 2013-06-26

展開全文

前一篇文章里我們已經(jīng)把微信公眾平臺接口中消息及相關(guān)操作都進行了封裝，本章節(jié)將主要介紹如何接收微信服務(wù)器發(fā)送的消息并做出響應(yīng)。

明確在哪接收消息

從微信公眾平臺接口消息指南中可以了解到，當(dāng)用戶向公眾賬號發(fā)消息時，微信服務(wù)器會將消息通過POST方式提交給我們在接口配置信息中填寫的URL，而我們就需要在URL所指向的請求處理類CoreServlet的doPost方法中接收消息、處理消息和響應(yīng)消息。

接收、處理、響應(yīng)消息

下面先來看我已經(jīng)寫好的CoreServlet的完整代碼：

[java]view plaincopy
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;  
  
    /** 
     * 確認(rèn)請求來自微信服務(wù)器 
     */  
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
        // 微信加密簽名  
        String signature = request.getParameter("signature");  
        // 時間戳  
        String timestamp = request.getParameter("timestamp");  
        // 隨機數(shù)  
        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;  
    }  
  
    /** 
     * 處理微信服務(wù)器發(fā)來的消息 
     */  
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
        // 將請求、響應(yīng)的編碼均設(shè)置為UTF-8（防止中文亂碼）  
        request.setCharacterEncoding("UTF-8");  
        response.setCharacterEncoding("UTF-8");  
  
        // 調(diào)用核心業(yè)務(wù)類接收消息、處理消息  
        String respMessage = CoreService.processRequest(request);  
          
        // 響應(yīng)消息  
        PrintWriter out = response.getWriter();  
        out.print(respMessage);  
        out.close();  
    }  
  
}  

代碼說明：

1）第51行代碼：微信服務(wù)器POST消息時用的是UTF-8編碼，在接收時也要用同樣的編碼，否則中文會亂碼；

2）第52行代碼：在響應(yīng)消息（回復(fù)消息給用戶）時，也將編碼方式設(shè)置為UTF-8，原理同上；

3）第54行代碼：調(diào)用CoreService類的processRequest方法接收、處理消息，并得到處理結(jié)果；

4）第57~59行：調(diào)用response.getWriter().write()方法將消息的處理結(jié)果返回給用戶

從doPost方法的實現(xiàn)可以看到，它是通過調(diào)用CoreService類的processRequest方法接收、處理消息的，這樣做的目的是為了解耦，即業(yè)務(wù)相關(guān)的操作都不在Servlet里處理，而是完全交由業(yè)務(wù)核心類CoreService去做。下面來看CoreService類的代碼實現(xiàn)：

[java]view plaincopy
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;  
  
/** 
 * 核心服務(wù)類 
 *  
 * @author liufeng 
 * @date 2013-05-20 
 */  
public class CoreService {  
    /** 
     * 處理微信發(fā)來的請求 
     *  
     * @param request 
     * @return 
     */  
    public static String processRequest(HttpServletRequest request) {  
        String respMessage = null;  
        try {  
            // 默認(rèn)返回的文本消息內(nèi)容  
            String respContent = "請求處理異常，請稍候嘗試！";  
  
            // xml請求解析  
            Map<String, String> requestMap = MessageUtil.parseXml(request);  
  
            // 發(fā)送方賬號（open_id）  
            String fromUserName = requestMap.get("FromUserName");  
            // 公眾賬號  
            String toUserName = requestMap.get("ToUserName");  
            // 消息類型  
            String msgType = requestMap.get("MsgType");  
  
            // 回復(fù)文本消息  
            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 = "您發(fā)送的是文本消息！";  
            }  
            // 圖片消息  
            else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_IMAGE)) {  
                respContent = "您發(fā)送的是圖片消息！";  
            }  
            // 地理位置消息  
            else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LOCATION)) {  
                respContent = "您發(fā)送的是地理位置消息！";  
            }  
            // 鏈接消息  
            else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LINK)) {  
                respContent = "您發(fā)送的是鏈接消息！";  
            }  
            // 音頻消息  
            else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_VOICE)) {  
                respContent = "您發(fā)送的是音頻消息！";  
            }  
            // 事件推送  
            else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_EVENT)) {  
                // 事件類型  
                String eventType = requestMap.get("Event");  
                // 訂閱  
                if (eventType.equals(MessageUtil.EVENT_TYPE_SUBSCRIBE)) {  
                    respContent = "謝謝您的關(guān)注！";  
                }  
                // 取消訂閱  
                else if (eventType.equals(MessageUtil.EVENT_TYPE_UNSUBSCRIBE)) {  
                    // TODO 取消訂閱后用戶再收不到公眾號發(fā)送的消息，因此不需要回復(fù)消息  
                }  
                // 自定義菜單點擊事件  
                else if (eventType.equals(MessageUtil.EVENT_TYPE_CLICK)) {  
                    // TODO 自定義菜單權(quán)沒有開放，暫不處理該類消息  
                }  
            }  
  
            textMessage.setContent(respContent);  
            respMessage = MessageUtil.textMessageToXml(textMessage);  
        } catch (Exception e) {  
            e.printStackTrace();  
        }  
  
        return respMessage;  
    }  
}  

代碼說明：

1）第29行：調(diào)用消息工具類MessageUtil解析微信發(fā)來的xml格式的消息，解析的結(jié)果放在HashMap里；

2）32~36行：從HashMap中取出消息中的字段；

3）39-44、84行：組裝要返回的文本消息對象；

4）47~82行：演示了如何接收微信發(fā)送的各類型的消息，根據(jù)MsgType判斷屬于哪種類型的消息；

5）85行：調(diào)用消息工具類MessageUtil將要返回的文本消息對象TextMessage轉(zhuǎn)化成xml格式的字符串；

關(guān)于事件推送（關(guān)注、取消關(guān)注、菜單點擊）

對于消息類型的判斷，像文本消息、圖片消息、地理位置消息、鏈接消息和語音消息都比較好理解，有很多剛接觸的朋友搞不懂事件推送消息有什么用，或者不清楚該如何判斷用戶關(guān)注的消息。那我們就專門來看下事件推送，下圖是官方消息接口文檔中關(guān)于事件推送的說明：

這里我們只要關(guān)心兩個參數(shù)：MsgType和Event。當(dāng)MsgType=event時，就表示這是一條事件推送消息；而Event表示事件類型，包括訂閱、取消訂閱和自定義菜單點擊事件。也就是說，無論用戶是關(guān)注了公眾賬號、取消對公眾賬號的關(guān)注，還是在使用公眾賬號的菜單，微信服務(wù)器都會發(fā)送一條MsgType=event的消息給我們，而至于具體這條消息表示關(guān)注、取消關(guān)注，還是菜單的點擊事件，就需要通過Event的值來判斷了。（注意區(qū)分Event和event）

連載五篇教程總結(jié)

經(jīng)過5篇的講解，已經(jīng)把開發(fā)模式啟用，接口配置，消息相關(guān)工具類的封裝，消息的接收與響應(yīng)全部講解完了，而且貼上了完整的源代碼，相信有一定Java基礎(chǔ)的朋友可以看的明白，能夠通過系列文章基本掌握微信公眾平臺開發(fā)的相關(guān)技術(shù)知識。下面我把目前項目的完整結(jié)構(gòu)貼出，方便大家對照：