使用Java開發微信公衆平臺(二)——消息的接收與響應

上一篇文章中,我們學習了使用Java語言開發微信公衆平臺的第一部分——環境搭建與開發接入。那麼,本篇文章,我們將在此基礎上,學習【消息的接收與響應】。

喜歡本文,請點擊下方喜歡按鈕唄!❤️

當然,我們在後續的開發過程中肯定還是離不開微信提供的開發者文檔:http://mp.weixin.qq.com/wiki/home/,打開開發文檔,點擊左側的“消息管理”——“接受普通消息”,本節內容,我們來學習普通消息的接收與響應。

微信開發文檔

之前我們強調過,接入微信公衆平臺的時候,微信將發送Get請求給我們的校驗方法。那當我們接收消息的時候,微信將向我們發送Post請求,並以XML的格式發送與接收數據。並且在開發過程中,我們需要注意一點小細節:

微信服務器在五秒內收不到響應會斷掉連接,並且重新發起請求,總共重試三次。假如服務器無法保證在五秒內處理並回復,可以直接回復空串,微信服務器不會對此作任何處理,並且不會發起重試。

下面,我們來看一下微信發給我們的普通文本消息的XML包結構,各標籤所包裹的內容,在官方文檔中說的很詳細:

普通文本消息的XML包結構

瞭解了微信給我們推送的XML包結構,下面我們就通過創建文本消息,來實現消息的接收與響應:

繼續打開我們上次編寫的Servlet,即微信請求的Servlet地址。在Post方法中,接收微信發送的XML內容,當然在此之前,爲了方便我們的數據處理,我們需要新建兩個方法,將XML數據類型,轉成我們熟悉的集合類型。反之,能夠將我們的對象類型,轉成XML類型,並返回給微信公衆平臺:

1、將接收到的XML格式,轉爲集合對象(Map)

這裏,我們在我們的Util包下,新建一個Message工具類:

首先,新建一個方法,將我們接收到的XML格式,轉化爲Map格式。在這個過程中,我們需要藉助一個dom4j的jar包。並將其放置在Web-INF下的lib包中。這個jar包很容易下載,此處提供一個下載鏈接,如果下載遇到問題,可加入傑瑞教育技術交流羣(452379712)下載。

好了,藉助dom4j的jar包,我們可以編寫方法,將XML格式,轉化對Map對象格式,方法實現如下:

2、類似上述方法,我們需要編寫方法,將我們的消息對象,轉成XML。

此處,我們仍需藉助一個jar包:xstream-x.x.jar,導入方式同dom4j

當然,首先,我們需要新建一個實體類,用於承載消息對象,實體類中6個屬性,分別對應上述微信給我們發送的XML文本的6個參數,並提供對應Get/Set方法以及空參/全參構造,此處不做贅述:

接下來,我們編寫方法,來轉換此文本消息類的對象,將其轉換爲XML格式返回:

3、寫完上述兩個處理方法後,我們來實現【消息的接收與響應】,

回到我們最開始的Servlet中,在doPost方法中進行編寫操作:

這樣,我們就成功的完成了文本消息的接收與響應。實現效果如下,用戶發送任何內容,將會返回各種信息:

運行效果圖

【附錄】相關代碼:

一、Servlet中的doPost方法

public void doPost(HttpServletRequest request, HttpServletResponse response)

throws ServletException, IOException {

request.setCharacterEncoding("UTF-8");

response.setCharacterEncoding("UTF-8");

PrintWriter out = response.getWriter();

String str = null;

try {

//將request請求,傳到Message工具類的轉換方法中,返回接收到的Map對象

Map map = Message.xmlToMap(request);

//從集合中,獲取XML各個節點的內容

String ToUserName = map.get("ToUserName");

String FromUserName = map.get("FromUserName");

String CreateTime = map.get("CreateTime");

String MsgType = map.get("MsgType");

String Content = map.get("Content");

String MsgId = map.get("MsgId");

if(MsgType.equals("text")){//判斷消息類型是否是文本消息(text)

TestMessage message = new TestMessage();

message.setFromUserName(ToUserName);//原來【接收消息用戶】變爲回覆時【發送消息用戶】

message.setToUserName(FromUserName);

message.setMsgType("text");

message.setCreateTime(new Date().getTime());//創建當前時間爲消息時間

message.setContent("您好,"+FromUserName+"\n我是:"+ToUserName

+"\n您發送的消息類型爲:"+MsgType+"\n您發送的時間爲"+CreateTime

+"\n我回復的時間爲:"+message.getCreateTime()+"您發送的內容是"+Content);

str = Message.objectToXml(message); //調用Message工具類,將對象轉爲XML字符串

}

二、Message處理工具類

/**

  • 新建方法,將接收到的XML格式,轉化爲Map對象

  • @param request 將request對象,通過參數傳入

  • @return 返回轉換後的Map對象

*/

public static Map xmlToMap(HttpServletRequest request) throws IOException, DocumentException{

Map map = new HashMap();

//從dom4j的jar包中,拿到SAXReader對象。

SAXReader reader = new SAXReader();

InputStream is = request.getInputStream();//從request中,獲取輸入流

Document doc =  reader.read(is);//從reader對象中,讀取輸入流

Element root = doc.getRootElement();//獲取XML文檔的根元素

List list = root.elements();//獲得根元素下的所有子節點

for (Element e : list) {

map.put(e.getName(), e.getText());//遍歷list對象,並將結果保存到集合中

}

is.close();

return map;

}

/**

  • 將文本消息對象轉化成XML格式

  • @param message 文本消息對象

  • @return 返回轉換後的XML格式

*/

public static String objectToXml(TestMessage message){

XStream xs = new XStream();

//由於轉換後xml根節點默認爲class類,需轉化爲

xs.alias("xml", message.getClass());

return xs.toXML(message);

}

三、TestMessage實體類

//屬性如下

private String ToUserName;

private String FromUserName;

private Long CreateTime;

private String MsgType;

private String Content;

private String MsgId;

//以及Get/Set方法


【版權聲明】

原創內容,歡迎轉載!轉載請註明出處!需要源碼下載,請聯繫博主!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章