明確在哪接收消息

從微信公眾平臺(tái)接口消息指南中可以了解到，當(dāng)用戶向公眾帳號(hào)發(fā)消息時(shí)，微信服務(wù)器會(huì)將消息通過(guò)POST方式提交給我們?cè)诮涌谂渲眯畔⒅刑顚懙腢RL，而我們就需要在URL所指向的請(qǐng)求處理類CoreServlet的doPost方法中接收消息、處理消息和響應(yīng)消息。

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

下面先來(lái)看我已經(jīng)寫好的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; 
 
/** 
 * 核心請(qǐng)求處理類 
 *  
 * @author liufeng 
 * @date 2013-05-18 
 */ 
public class CoreServlet extends HttpServlet { 
    private static final long serialVersionUID = 4440739483644821986L; 
 
    /** 
     * 確認(rèn)請(qǐng)求來(lái)自微信服務(wù)器 
     */ 
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
        // 微信加密簽名 
        String signature = request.getParameter("signature"); 
        // 時(shí)間戳 
        String timestamp = request.getParameter("timestamp"); 
        // 隨機(jī)數(shù) 
        String nonce = request.getParameter("nonce"); 
        // 隨機(jī)字符串 
        String echostr = request.getParameter("echostr"); 
 
        PrintWriter out = response.getWriter(); 
        // 通過(guò)檢驗(yàn)signature對(duì)請(qǐng)求進(jìn)行校驗(yàn)，若校驗(yàn)成功則原樣返回echostr，表示接入成功，否則接入失敗 
        if (SignUtil.checkSignature(signature, timestamp, nonce)) { 
            out.print(echostr); 
        } 
        out.close(); 
        out = null; 
    } 
 
    /** 
     * 處理微信服務(wù)器發(fā)來(lái)的消息 
     */ 
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
        // 將請(qǐng)求、響應(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(); 
    } 
 
} 

代碼說(shuō)明：

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

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

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

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

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

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ā)來(lái)的請(qǐng)求 
     *  
     * @param request 
     * @return 
     */ 
    public static String processRequest(HttpServletRequest request) { 
        String respMessage = null; 
        try { 
            // 默認(rèn)返回的文本消息內(nèi)容 
            String respContent = "請(qǐng)求處理異常，請(qǐng)稍候嘗試！"; 
 
            // xml請(qǐng)求解析 
            Map<String, String> requestMap = MessageUtil.parseXml(request); 
 
            // 發(fā)送方帳號(hào)（open_id） 
            String fromUserName = requestMap.get("FromUserName"); 
            // 公眾帳號(hào) 
            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 取消訂閱后用戶再收不到公眾號(hào)發(fā)送的消息，因此不需要回復(fù)消息 
                } 
                // 自定義菜單點(diǎn)擊事件 
                else if (eventType.equals(MessageUtil.EVENT_TYPE_CLICK)) { 
                    // TODO 自定義菜單權(quán)沒(méi)有開放，暫不處理該類消息 
                } 
            } 
 
            textMessage.setContent(respContent); 
            respMessage = MessageUtil.textMessageToXml(textMessage); 
        } catch (Exception e) { 
            e.printStackTrace(); 
        } 
 
        return respMessage; 
    } 
} 

代碼說(shuō)明：

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

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

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

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

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

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

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

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