AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

[029] 微信公众帐号开发教程第5篇-各种消息的接收与响应（转）

2017-12-04 1423
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介：

前一篇文章里我们已经把微信公众平台接口中消息及相关操作都进行了封装，本章节将主要介绍怎样接收微信server发送的消息并做出响应。

 

明确在哪接收消息

从微信公众平台接口消息指南中能够了解到，当用户向公众帐号发消息时，微信server会将消息通过POST方式提交给我们在接口配置信息中填写的URL，而我们就须要在URL所指向的请求处理类CoreServlet的doPost方法中接收消息、处理消息和响应消息。

 

接收、处理、响应消息

以下先来看我已经写好的CoreServlet的完整代码：

 

[java]  view plain copy
 
  1. package org.liufeng.course.servlet;  
  2.   
  3. import java.io.IOException;  
  4. import java.io.PrintWriter;  
  5.   
  6. import javax.servlet.ServletException;  
  7. import javax.servlet.http.HttpServlet;  
  8. import javax.servlet.http.HttpServletRequest;  
  9. import javax.servlet.http.HttpServletResponse;  
  10.   
  11. import org.liufeng.course.service.CoreService;  
  12. import org.liufeng.course.util.SignUtil;  
  13.   
  14. /** 
  15.  * 核心请求处理类 
  16.  *  
  17.  * @author liufeng 
  18.  * @date 2013-05-18 
  19.  */  
  20. public class CoreServlet extends HttpServlet {  
  21.     private static final long serialVersionUID = 4440739483644821986L;  
  22.   
  23.     /** 
  24.      * 确认请求来自微信server 
  25.      */  
  26.     public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
  27.         // 微信加密签名  
  28.         String signature = request.getParameter("signature");  
  29.         // 时间戳  
  30.         String timestamp = request.getParameter("timestamp");  
  31.         // 随机数  
  32.         String nonce = request.getParameter("nonce");  
  33.         // 随机字符串  
  34.         String echostr = request.getParameter("echostr");  
  35.   
  36.         PrintWriter out = response.getWriter();  
  37.         // 通过检验signature对请求进行校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败  
  38.         if (SignUtil.checkSignature(signature, timestamp, nonce)) {  
  39.             out.print(echostr);  
  40.         }  
  41.         out.close();  
  42.         out = null;  
  43.     }  
  44.   
  45.     /** 
  46.      * 处理微信server发来的消息 
  47.      */  
  48.     public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
  49.         // 将请求、响应的编码均设置为UTF-8（防止中文乱码）  
  50.         request.setCharacterEncoding("UTF-8");  
  51.         response.setCharacterEncoding("UTF-8");  
  52.   
  53.         // 调用核心业务类接收消息、处理消息  
  54.         String respMessage = CoreService.processRequest(request);  
  55.           
  56.         // 响应消息  
  57.         PrintWriter out = response.getWriter();  
  58.         out.print(respMessage);  
  59.         out.close();  
  60.     }  
  61.   
  62. }  

代码说明：

 

1）第51行代码：微信serverPOST消息时用的是UTF-8编码，在接收时也要用相同的编码，否则中文会乱码；

2）第52行代码：在响应消息（回复消息给用户）时，也将编码方式设置为UTF-8，原理同上；

3）第54行代码：调用CoreService类的processRequest方法接收、处理消息，并得到处理结果；

4）第57~59行：调用response.getWriter().write()方法将消息的处理结果返回给用户

从doPost方法的实现能够看到，它是通过调用CoreService类的processRequest方法接收、处理消息的，这样做的目的是为了解耦，即业务相关的操作都不在Servlet里处理，而是全然交由业务核心类CoreService去做。以下来看CoreService类的代码实现：

 

[java]  view plain copy
 
  1. package org.liufeng.course.service;  
  2.   
  3. import java.util.Date;  
  4. import java.util.Map;  
  5. import javax.servlet.http.HttpServletRequest;  
  6. import org.liufeng.course.message.resp.TextMessage;  
  7. import org.liufeng.course.util.MessageUtil;  
  8.   
  9. /** 
  10.  * 核心服务类 
  11.  *  
  12.  * @author liufeng 
  13.  * @date 2013-05-20 
  14.  */  
  15. public class CoreService {  
  16.     /** 
  17.      * 处理微信发来的请求 
  18.      *  
  19.      * @param request 
  20.      * @return 
  21.      */  
  22.     public static String processRequest(HttpServletRequest request) {  
  23.         String respMessage = null;  
  24.         try {  
  25.             // 默认返回的文本消息内容  
  26.             String respContent = "请求处理异常，请稍候尝试！";  
  27.   
  28.             // xml请求解析  
  29.             Map<String, String> requestMap = MessageUtil.parseXml(request);  
  30.   
  31.             // 发送方帐号（open_id）  
  32.             String fromUserName = requestMap.get("FromUserName");  
  33.             // 公众帐号  
  34.             String toUserName = requestMap.get("ToUserName");  
  35.             // 消息类型  
  36.             String msgType = requestMap.get("MsgType");  
  37.   
  38.             // 回复文本消息  
  39.             TextMessage textMessage = new TextMessage();  
  40.             textMessage.setToUserName(fromUserName);  
  41.             textMessage.setFromUserName(toUserName);  
  42.             textMessage.setCreateTime(new Date().getTime());  
  43.             textMessage.setMsgType(MessageUtil.RESP_MESSAGE_TYPE_TEXT);  
  44.             textMessage.setFuncFlag(0);  
  45.   
  46.             // 文本消息  
  47.             if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) {  
  48.                 respContent = "您发送的是文本消息！";  
  49.             }  
  50.             // 图片消息  
  51.             else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_IMAGE)) {  
  52.                 respContent = "您发送的是图片消息！";  
  53.             }  
  54.             // 地理位置消息  
  55.             else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LOCATION)) {  
  56.                 respContent = "您发送的是地理位置消息！";  
  57.             }  
  58.             // 链接消息  
  59.             else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LINK)) {  
  60.                 respContent = "您发送的是链接消息！";  
  61.             }  
  62.             // 音频消息  
  63.             else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_VOICE)) {  
  64.                 respContent = "您发送的是音频消息！";  
  65.             }  
  66.             // 事件推送  
  67.             else if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_EVENT)) {  
  68.                 // 事件类型  
  69.                 String eventType = requestMap.get("Event");  
  70.                 // 订阅  
  71.                 if (eventType.equals(MessageUtil.EVENT_TYPE_SUBSCRIBE)) {  
  72.                     respContent = "谢谢您的关注！";  
  73.                 }  
  74.                 // 取消订阅  
  75.                 else if (eventType.equals(MessageUtil.EVENT_TYPE_UNSUBSCRIBE)) {  
  76.                     // TODO 取消订阅后用户再收不到公众号发送的消息，因此不须要回复消息  
  77.                 }  
  78.                 // 自己定义菜单点击事件  
  79.                 else if (eventType.equals(MessageUtil.EVENT_TYPE_CLICK)) {  
  80.                     // TODO 自己定义菜单权沒有开放，暂不处理该类消息  
  81.                 }  
  82.             }  
  83.   
  84.             textMessage.setContent(respContent);  
  85.             respMessage = MessageUtil.textMessageToXml(textMessage);  
  86.         } catch (Exception e) {  
  87.             e.printStackTrace();  
  88.         }  
  89.   
  90.         return respMessage;  
  91.     }  
  92. }  

代码说明：

1）第29行：调用消息工具类MessageUtil解析微信发来的xml格式的消息，解析的结果放在HashMap里；

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

3）39-44、84行：组装要返回的文本消息对象；

4）47~82行：演示了怎样接收微信发送的各类型的消息，依据MsgType推断属于哪种类型的消息；

5）85行：调用消息工具类MessageUtil将要返回的文本消息对象TextMessage转化成xml格式的字符串；

关于事件推送（关注、取消关注、菜单点击）

对于消息类型的推断，像文本消息、图片消息、地理位置消息、链接消息和语音消息都比較好理解，有非常多刚接触的朋友搞不懂事件推送消息有什么用，或者不清晰该怎样推断用户关注的消息。那我们就专门来看下事件推送，下图是官方消息接口文档中关于事件推送的说明：

这里我们仅仅要关心两个參数：MsgType和Event。当MsgType=event时，就表示这是一条事件推送消息；而Event表示事件类型，包含订阅、取消订阅和自己定义菜单点击事件。也就是说，不管用户是关注了公众帐号、取消对公众帐号的关注，还是在使用公众帐号的菜单，微信server都会发送一条MsgType=event的消息给我们，而至于详细这条消息表示关注、取消关注，还是菜单的点击事件，就须要通过Event的值来推断了。（注意区分Event和event）

 

连载五篇教程总结

经过5篇的解说，已经把开发模式启用，接口配置，消息相关工具类的封装，消息的接收与响应所有解说完了，并且贴上了完整的源码，相信有一定Java基础的朋友能够看的明确，能够通过系列文章基本掌握微信公众平台开发的相关技术知识。以下我把眼下项目的完整结构贴出，方便大家对比：

本文转自博客园知识天地的博客，原文链接：[029] 微信公众帐号开发教程第5篇-各种消息的接收与响应（转），如需转载请自行联系原博主。


文章标签：
Java
定位技术
数据格式
XML
关键词：
微信开发
微信响应
微信教程
微信开发教程
微信接收
云栖希望。
目录
相关文章
邹荣乐
|
2月前
|
JSON 小程序 JavaScript
uni-app开发微信小程序的报错[渲染层错误]排查及解决
uni-app开发微信小程序的报错[渲染层错误]排查及解决
邹荣乐
695 7
邹荣乐
|
2月前
|
小程序 JavaScript 前端开发
uni-app开发微信小程序：四大解决方案，轻松应对主包与vendor.js过大打包难题
uni-app开发微信小程序：四大解决方案，轻松应对主包与vendor.js过大打包难题
邹荣乐
750 1
yuanzhengme
|
2月前
|
存储 小程序 安全
微信的开发管理都需要配置什么？
【10月更文挑战第17天】微信的开发管理都需要配置什么？
yuanzhengme
36 0
邹荣乐
|
2月前
|
JavaScript 小程序 开发者
uni-app开发实战：利用Vue混入(mixin)实现微信小程序全局分享功能，一键发送给朋友、分享到朋友圈、复制链接
uni-app开发实战：利用Vue混入(mixin)实现微信小程序全局分享功能，一键发送给朋友、分享到朋友圈、复制链接
邹荣乐
469 0
yuanzhengme
|
2月前
|
小程序 前端开发 测试技术
微信小程序的开发完整流程是什么？
微信小程序的开发完整流程是什么？
yuanzhengme
146 7
ly~
|
3月前
|
存储 供应链 小程序
除了微信小程序，PHP 还可以用于开发哪些类型的小程序？
除了微信小程序，PHP 还可用于开发多种类型的小程序，包括支付宝小程序、百度智能小程序、抖音小程序、企业内部小程序及行业特定小程序。在电商、生活服务、资讯、工具、娱乐、营销等领域，PHP 能有效管理商品信息、订单处理、支付接口、内容抓取、复杂计算、游戏数据、活动规则等多种业务。同时，在企业内部，PHP 可提升工作效率，实现审批流程、文件共享、生产计划等功能；在医疗和教育等行业，PHP 能管理患者信息、在线问诊、课程资源、成绩查询等重要数据。
ly~
86 6
邹荣乐
|
2月前
|
缓存 小程序 索引
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
邹荣乐
251 1
众所周知
|
2月前
|
小程序 前端开发 数据安全/隐私保护
微信小程序全栈开发中的身份认证与授权机制
【10月更文挑战第3天】随着移动互联网的发展，微信小程序凭借便捷的用户体验和强大的社交传播能力，成为企业拓展业务的新渠道。本文探讨了小程序全栈开发中的身份认证与授权机制，包括手机号码验证、微信登录、第三方登录及角色权限控制等方法，并强调了安全性、用户体验和合规性的重要性，帮助开发者更好地理解和应用这一关键技术。
众所周知
87 5
众所周知
|
2月前
|
小程序 前端开发 JavaScript
微信小程序全栈开发中的PWA技术应用
【10月更文挑战第3天】微信小程序作为新兴应用形态，凭借便捷体验与社交传播能力，成为企业拓展业务的新渠道。本文探讨了微信小程序全栈开发中的PWA技术应用，包括离线访问、后台运行、桌面图标及原生体验等方面，助力开发者提升小程序性能与用户体验。PWA技术在不同平台的兼容性、性能优化及用户体验是实践中需注意的关键点。
众所周知
72 5
java冯坚持
|
2月前
|
小程序 JavaScript API
微信小程序开发之：保存图片到手机，使用uni-app 开发小程序；还有微信原生保存图片到手机
这篇文章介绍了如何在uni-app和微信小程序中实现将图片保存到用户手机相册的功能。
java冯坚持
1004 0
微信小程序开发之：保存图片到手机，使用uni-app 开发小程序；还有微信原生保存图片到手机