開發微信已經將近4個月了,但是還是不會本地調試,只能部署到服務器上,通過打日誌,來看是否有錯,@ALL哪位同志,如果有好的方法,可以告訴我。
先簡要介紹一下微信公衆號,消息推送的原理。
微信公衆號只是一個平臺,這個平臺的功能是一樣的,但是這個功能的內容卻可以由這個公衆號的主人決定。這些內容實現了微信公衆號的私人訂製。
就像關注一個公衆號之後,會有一個歡迎詞,都是歡迎詞的功能。有的公衆號推送了滿滿一屏的文字,有的公衆號只是寥寥數字。
利用內容的不同,微信公衆號得以推廣。
這個功能一個測試公衆號就可以完成,對微信開發有興趣的同學可以嘗試一下。
https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
本姑娘從事的是java開發,所以文中所有的代碼均爲java。
- 第一步,我們要寫代碼部署到一個解析了域名的服務器上,讓外界可以訪問到。
爲了實現消息推送功能,我們需要@RequestMapping value值一樣的2個方法,但是RequestMethod一個爲GET,一個爲POST.
GET方法,用於微信公衆號後臺配置url+token,POST方法用於接收微信公衆號推送的消息。
無論GET方法,還是POST方法,都需要驗證簽名的正確性。
代碼附上: |
/** * 驗證url+token token+timestamp+nonce asc排序SHA1加密與signature對比,相同 * *@param request *@return ture驗證通過,false驗證未通過 */ public boolean checkSignature(HttpServletRequestrequest) {
String signature = request.getParameter("signature"); String timestamp = request.getParameter("timestamp"); String nonce = request.getParameter("nonce"); String echostr = request.getParameter("echostr");
logger.debug("signature=============================:" +signature); logger.debug("timestamp=============================:" +timestamp); logger.debug("nonce=================================:" +nonce); logger.debug("echostr===============================:" +echostr);
// 1.將token,timestamp,nonce三個參數排序 //TODO 這個參數之後可能會變,暫時先寫死 String token = "qichejiadaojavaweixintoken";//這裏的token值就是微信公衆號後臺配置的token,值必須一樣。 String[] str = new String[] { token, timestamp, nonce }; Arrays.sort(str); // 2.將三個參數字符串接成一個字符串 StringBuilder buff = new StringBuilder(); for (inti = 0; i <str.length;i++) { buff.append(str[i]); } // 3.進行sha1加密 MessageDigest md = null; String result = ""; try { md = MessageDigest.getInstance("SHA-1"); byte[]date = md.digest(buff.toString().getBytes()); // 將字節數組轉換成字符串 result = bytesToStr(date); logger.debug("加密後" +result);
} catch (NoSuchAlgorithmException e) { e.printStackTrace(); } returnresult != null ? (result.equals(signature.toUpperCase())) :false; }
// 將直接數組轉換成十六進制字符串 private static String bytesToStr(byte[]byteArray) { String strDigest = ""; for (inti = 0; i <byteArray.length;i++) { strDigest += byteToHexStr(byteArray[i]); } returnstrDigest; }
// 將一個字節轉換成16進制字符串 private static String byteToHexStr(bytemByte) { char[]Digit = { '0','1', '2', '3', '4', '5','6', '7', '8', '9', 'A','B', 'C', 'D', 'E', 'F' }; char[]temp1 = new char[2]; temp1[0] =Digit[mByte >>> 4 & 0X0F]; temp1[1] =Digit[mByte & 0X0F]; String str = new String(temp1); returnstr; } |
GET方法驗證簽名正確後,直接返回簽名,微信服務端得到的簽名與後臺配置的簽名一致。url+token,即可配置成功。
代碼附上: |
/** * 驗證url和token,當所請求的方法爲GET時,正常返回echostr即可 * *@param request *@param response *@throws IOException */ @RequestMapping(value ="/eventpush", method = RequestMethod.GET) public void EventPushGet(HttpServletRequestrequest, HttpServletResponse response) throws IOException {
logger.debug("==================eventpush:Get========================"); PrintWriter out = response.getWriter(); if (checkSignature(request)) { out.write(request.getParameter("echostr")); } else { out.write("error"); } } |
完成了GET方法,我們將代碼部署到服務器上。到微信公衆號後臺,找到開發-->基本配置。
url處填寫,我們剛剛完成的get方法的訪問地址,當然要是全域名的例如:http://test.mywechat.cn/eventpush
Token處填寫我們代碼中用到的token,這個值可以隨便定義,但是驗證簽名的代碼用到的token值一定要和這裏的一致。否則驗證不通過。
EncodingASEKey處生成就可以。
消息加解密方式沒有深的研究。
提交併啓用。
url+token,配置成功,我們只做到了消息推送的第一步。
- 接下來我們來看一下,我們第一步中強調的POST方法能爲我們做些什麼。
附上controller代碼: |
@RequestMapping(value ="/eventpush", method = RequestMethod.POST) public void EventPushPost(HttpServletRequestrequest, HttpServletResponse response) throws IOException {
// 1.判斷推動的數據類型 logger.debug("==================eventpush:POST========================"); PrintWriter out = response.getWriter(); if (checkSignature(request)) { String message = eventPushService.DoEvent(request); out.write(message); } else { out.write("error"); } } |
微信公衆號會將用戶發送的消息(語音,圖片),點擊的事件(例如用戶點擊的底部的菜單)推送到我們上邊完成的POST方法中。
我們如何處理這些消息,這些事件,就是我們的私人訂製。
附上service代碼: |
public String DoEvent(HttpServletRequestrequest) {
String respContent = "success"; try { // 調用parseXml方法解析請求消息 Map<String, String> requestMap = MessageUtil.parseXml(request); // 發送方帳號 String fromUserName = requestMap.get("FromUserName").toString(); logger.debug("FromUserName==================================>" +fromUserName); // 開發者微信號 String toUserName = requestMap.get("ToUserName").toString(); logger.debug("ToUserName====================================>" +toUserName); // 消息類型 String msgType = requestMap.get("MsgType").toString(); logger.debug("MsgType=======================================>" +msgType);
String eventKey = requestMap.get("EventKey") ==null ? null :requestMap.get("EventKey").toString(); logger.debug("EventKey===========================>" +eventKey);
String ticket = requestMap.get("Ticket") ==null ? null :requestMap.get("Ticket").toString(); logger.debug("Ticket===========================> " +ticket);
// 回覆文本消息 TextMessage textMessage = new TextMessage(); textMessage.setToUserName(fromUserName); textMessage.setFromUserName(toUserName); textMessage.setCreateTime(new Date().getTime()); textMessage.setMsgType(MessageConstant.RESP_MESSAGE_TYPE_TEXT);
// 文本消息 if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_TEXT)) {
} // 圖片消息 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_IMAGE)) {
} // 語音消息 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_VOICE)) {
} // 視頻消息 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_VIDEO)) {
} // 地理位置消息 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_LOCATION)) {
} // 鏈接消息 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_LINK)) {
} // 事件推送 else if (msgType.equals(MessageConstant.REQ_MESSAGE_TYPE_EVENT)) { // 事件類型 String eventType = requestMap.get("Event").toString();
logger.debug("Event================================>" +eventType);
// 關注 if (eventType.equals(MessageConstant.EVENT_TYPE_SUBSCRIBE)) { booleanbool = false; logger.debug(eventType +"==" + MessageConstant.EVENT_TYPE_SUBSCRIBE +":" + eventType.equals(MessageConstant.EVENT_TYPE_SUBSCRIBE)); if (true ==bool) {
String content = "關注歡迎詞"; Integer time = (int) (new Date().getTime() / 1000); respContent ="<xml><ToUserName><![CDATA[" + fromUserName + "]]></ToUserName><FromUserName><![CDATA[" + toUserName + "]]></FromUserName><CreateTime>" + time + "</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[" + content + "]]></Content></xml>"; } } // 取消關注 else if (eventType.equals(MessageConstant.EVENT_TYPE_UNSUBSCRIBE)) { logger.debug(eventType +"==" + MessageConstant.EVENT_TYPE_UNSUBSCRIBE +":" + eventType.equals(MessageConstant.EVENT_TYPE_UNSUBSCRIBE));
// wxUserService.AddOrUpdateWxUser(requestMap); } // 掃描帶參數二維碼 else if (eventType.equals(MessageConstant.EVENT_TYPE_SCAN)) {
} // 上報地理位置 else if (eventType.equals(MessageConstant.EVENT_TYPE_LOCATION)) {
} // 自定義菜單 CLICK else if (eventType.equals(MessageConstant.EVENT_TYPE_CLICK)) { logger.debug("EVENTKEY==================>" +requestMap.get("EventKey").toString()); if (requestMap.get("EventKey").toString().equals("V1001_GOOD")) { String content = "推送消息內容"; Integer time = (int) (new Date().getTime() / 1000); respContent ="<xml><ToUserName><![CDATA[" + fromUserName + "]]></ToUserName><FromUserName><![CDATA[" + toUserName + "]]></FromUserName><CreateTime>" + time + "</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[" + content + "]]></Content></xml>"; }
} }
} catch (Exception e) { e.printStackTrace(); } logger.debug("respContent==>" +respContent); returnrespContent; } |
MessageConstant類
|
/** * 此類用來彙總公衆號消息類型和事件類型 *@author zeqi * */ public class MessageConstant { public static final StringRESP_MESSAGE_TYPE_TEXT = null; public static final StringREQ_MESSAGE_TYPE_TEXT = "text"; public static final StringREQ_MESSAGE_TYPE_IMAGE = "image"; public static final StringREQ_MESSAGE_TYPE_VOICE = "voice"; public static final StringREQ_MESSAGE_TYPE_VIDEO = "video"; public static final StringREQ_MESSAGE_TYPE_SHORT_VIDEO = "shortvideo"; public static final StringREQ_MESSAGE_TYPE_LOCATION = "location"; public static final StringREQ_MESSAGE_TYPE_LINK = "link"; public static final StringREQ_MESSAGE_TYPE_EVENT = "event"; public static final StringEVENT_TYPE_SUBSCRIBE = "subscribe"; public static final StringEVENT_TYPE_UNSUBSCRIBE = "unsubscribe"; public static final StringEVENT_TYPE_SCAN = "SCAN"; public static final StringEVENT_TYPE_LOCATION = "LOCATION"; public static final StringEVENT_TYPE_CLICK = "CLICK"; public static final StringEVENT_TYPE_VIEW = "VIEW"; } |
當然如果不是特別個性的公衆號,許多私人訂製是不需要的,那麼那些不需要回復的消息,響應的事件,我們統一回復“success”字符串,如果我們不回覆任何內容,微信這邊會發送5次重試,如果我們的服務器5秒之內給不出任何回覆,微信公衆號提示用戶的就:
下篇博客,說一下我遇到的“該公衆號暫時無法提供服務,請稍後再試”的坑。