温馨提示:
这篇文章是依赖前几篇的文章的。
第一篇:微信公众平台开发实战之了解微信公众平台基础知识以及资料准备
第二篇 :微信公众平台开发实战之开启开发者模式,接入微信公众平台开发
第三篇 :微信公众平台开发实战之请求消息,响应消息以及事件消息类的封装
首先,我们看看原来写的dopost方法:
/**
* 处理微信服务器发来的消息
*/
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // TODO 消息的接收、处理、响应 }
doPost方法有两个参数:
1.request中封装了请求相关的所有内容,可以从request中取出微信服务器发来的消息;
2.response我们可以对接收到的消息进行响应,即发送消息。
一、解析微信服务器传来的消息
因为微信服务器发送过来的是xml格式的消息,所以我们可以采用 开源框架dom4j去解析xml 。
所用到的jar 包是:dom4j-1.6.1.jar
官网下载地址:http://www.dom4j.org/dom4j-1.6.1/
网盘下载地址:http://yunpan.cn/cQyR8KkIXxHXn 访问密码 0f2e
二、将响应消息转换成xml返回给微信服务器
如何将响应消息转换成xml返回的问题,这里我们将 采用开源框架xstream来实现Java类到xml的转换
所用到的jar包为:xstream-1.3.1.jar
网盘下载地址:http://yunpan.cn/cQyBU2vTYAe2f 访问密码 ad36
封装消息处理工具:
import
java.io.InputStream;
import
java.io.Writer;
import
java.util.HashMap;
import
java.util.List;
import
java.util.Map;
import
javax.servlet.http.HttpServletRequest;
import
org.dom4j.Document;
import
org.dom4j.Element;
import
org.dom4j.io.SAXReader;
import
com.souvc.weixin.message.resp.Article;
import
com.souvc.weixin.message.resp.ImageMessage;
import
com.souvc.weixin.message.resp.MusicMessage;
import
com.souvc.weixin.message.resp.NewsMessage;
import
com.souvc.weixin.message.resp.TextMessage;
import
com.souvc.weixin.message.resp.VideoMessage;
import
com.souvc.weixin.message.resp.VoiceMessage;
import
com.thoughtworks.xstream.XStream;
import
com.thoughtworks.xstream.core.util.QuickWriter;
import
com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import
com.thoughtworks.xstream.io.xml.PrettyPrintWriter;
import
com.thoughtworks.xstream.io.xml.XppDriver;
/*** 类名: MessageUtil </br>* 描述: 消息处理工具类</br>* 开发人员: souvc </br>* 创建时间: 2015-9-30 </br>* 发布版本:V1.0 </br> */
public
class
MessageUtil {
// 请求消息类型:文本
public
static
final
String REQ_MESSAGE_TYPE_TEXT = "text";
// 请求消息类型:图片
public
static
final
String REQ_MESSAGE_TYPE_IMAGE = "image";
// 请求消息类型:语音
public
static
final
String REQ_MESSAGE_TYPE_VOICE = "voice";
// 请求消息类型:视频
public
static
final
String REQ_MESSAGE_TYPE_VIDEO = "video";
// 请求消息类型:小视频
public
static
final
String REQ_MESSAGE_TYPE_SHORTVIDEO = "shortvideo";
// 请求消息类型:地理位置
public
static
final
String REQ_MESSAGE_TYPE_LOCATION = "location";
// 请求消息类型:链接
public
static
final
String REQ_MESSAGE_TYPE_LINK = "link";
// 请求消息类型:事件推送
public
static
final
String REQ_MESSAGE_TYPE_EVENT = "event";
// 事件类型:subscribe(订阅)
public
static
final
String EVENT_TYPE_SUBSCRIBE = "subscribe";
// 事件类型:unsubscribe(取消订阅)
public
static
final
String EVENT_TYPE_UNSUBSCRIBE = "unsubscribe";
// 事件类型:scan(用户已关注时的扫描带参数二维码)
public
static
final
String EVENT_TYPE_SCAN = "scan";
// 事件类型:LOCATION(上报地理位置)
public
static
final
String EVENT_TYPE_LOCATION = "LOCATION";
// 事件类型:CLICK(自定义菜单)
public
static
final
String EVENT_TYPE_CLICK = "CLICK";
// 响应消息类型:文本
public
static
final
String RESP_MESSAGE_TYPE_TEXT = "text";
// 响应消息类型:图片
public
static
final
String RESP_MESSAGE_TYPE_IMAGE = "image";
// 响应消息类型:语音
public
static
final
String RESP_MESSAGE_TYPE_VOICE = "voice";
// 响应消息类型:视频
public
static
final
String RESP_MESSAGE_TYPE_VIDEO = "video";
// 响应消息类型:音乐
public
static
final
String RESP_MESSAGE_TYPE_MUSIC = "music";
// 响应消息类型:图文
public
static
final
String RESP_MESSAGE_TYPE_NEWS = "news";
/** * 解析微信发来的请求(XML) * *
@param
request *
@return
Map<String, String> *
@throws
Exception */
@SuppressWarnings("unchecked")
public
static
Map<String, String> parseXml(HttpServletRequest request)
throws
Exception {
// 将解析结果存储在HashMap中
Map<String, String> map =
new
HashMap<String, String>();
// 从request中取得输入流
InputStream inputStream = request.getInputStream();
// 读取输入流
SAXReader reader =
new
SAXReader(); Document document = reader.read(inputStream);
// 得到xml根元素
Element root = document.getRootElement();
// 得到根元素的所有子节点
List<Element> elementList = root.elements();
// 遍历所有子节点
for
(Element e : elementList) map.put(e.getName(), e.getText());
// 释放资源
inputStream.close(); inputStream =
null
;
return
map; }
/** * 扩展xstream使其支持CDATA */
private
static
XStream xstream =
new
XStream(
new
XppDriver() {
public
HierarchicalStreamWriter createWriter(Writer out) {
return
new
PrettyPrintWriter(out) {
// 对所有xml节点的转换都增加CDATA标记
boolean
cdata =
true
; @SuppressWarnings("unchecked")
public
void
startNode(String name, Class clazz) {
super
.startNode(name, clazz); }
protected
void
writeText(QuickWriter writer, String text) {
if
(cdata) { writer.write("<![CDATA["); writer.write(text); writer.write("]]>"); }
else
{ writer.write(text); } } }; } });
/** * 文本消息对象转换成xml * *
@param
textMessage 文本消息对象 *
@return
xml */
public
static
String messageToXml(TextMessage textMessage) { xstream.alias("xml", textMessage.getClass());
return
xstream.toXML(textMessage); }
/** * 图片消息对象转换成xml * *
@param
imageMessage 图片消息对象 *
@return
xml */
public
static
String messageToXml(ImageMessage imageMessage) { xstream.alias("xml", imageMessage.getClass());
return
xstream.toXML(imageMessage); }
/** * 语音消息对象转换成xml * *
@param
voiceMessage 语音消息对象 *
@return
xml */
public
static
String messageToXml(VoiceMessage voiceMessage) { xstream.alias("xml", voiceMessage.getClass());
return
xstream.toXML(voiceMessage); }
/** * 视频消息对象转换成xml * *
@param
videoMessage 视频消息对象 *
@return
xml */
public
static
String messageToXml(VideoMessage videoMessage) { xstream.alias("xml", videoMessage.getClass());
return
xstream.toXML(videoMessage); }
/** * 音乐消息对象转换成xml * *
@param
musicMessage 音乐消息对象 *
@return
xml */
public
static
String messageToXml(MusicMessage musicMessage) { xstream.alias("xml", musicMessage.getClass());
return
xstream.toXML(musicMessage); }
/** * 图文消息对象转换成xml * *
@param
newsMessage 图文消息对象 *
@return
xml */
public
static
String messageToXml(NewsMessage newsMessage) { xstream.alias("xml", newsMessage.getClass()); xstream.alias("item",
new
Article().getClass());
return
xstream.toXML(newsMessage); }}
使用CoreServlet 类完成消息的接受与响应:
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
com.souvc.weixin.service.CoreService;
import
com.souvc.weixin.util.SignUtil;
/** * 类名: CoreServlet </br> * 描述: 来接收微信服务器传来信息 </br> * 开发人员: souvc</br> * 创建时间:2015-9-29 </br> * 发布版本:V1.0 </br> */
public
class
CoreServlet
extends
HttpServlet {
private
static
final
long
serialVersionUID = 4323197796926899691L;
/** * 确认请求来自微信服务器 */
public
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
// 微信加密签名
String signature = request.getParameter("signature");
// 时间戳
String timestamp = request.getParameter("timestamp");
// 随机数
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
; }
/** * 处理微信服务器发来的消息 */
public
void
doPost(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
// 消息的接收、处理、响应 // 将请求、响应的编码均设置为UTF-8(防止中文乱码)
request.setCharacterEncoding("UTF-8"); response.setCharacterEncoding("UTF-8");
// 调用核心业务类接收消息、处理消息
String respXml = CoreService.processRequest(request);
// 响应消息
PrintWriter out = response.getWriter(); out.print(respXml); out.close(); }}
使用CoreService类完成消息的处理:
import
java.util.Date;
import
java.util.Map;
import
javax.servlet.http.HttpServletRequest;
import
com.souvc.weixin.message.resp.TextMessage;
import
com.souvc.weixin.util.MessageUtil;
/*** 类名: CoreService </br>* 描述: 核心服务类 </br>* 开发人员: souvc </br>* 创建时间: 2015-9-30 </br>* 发布版本:V1.0 </br> */
public
class
CoreService {
/** * 处理微信发来的请求 *
@param
request *
@return
xml */
public
static
String processRequest(HttpServletRequest request) {
// xml格式的消息数据
String respXml =
null
;
// 默认返回的文本消息内容
String respContent = "未知的消息类型!";
try
{
// 调用parseXml方法解析请求消息
Map<String, String> requestMap = MessageUtil.parseXml(request);
// 发送方帐号
String fromUserName = requestMap.get("FromUserName");
// 开发者微信号
String toUserName = requestMap.get("ToUserName");
// 消息类型
String msgType = requestMap.get("MsgType");
// 回复文本消息
TextMessage textMessage =
new
TextMessage(); textMessage.setToUserName(fromUserName); textMessage.setFromUserName(toUserName); textMessage.setCreateTime(
new
Date().getTime()); textMessage.setMsgType(MessageUtil.RESP_MESSAGE_TYPE_TEXT);
// 文本消息
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) { respContent = "您发送的是文本消息!"; }
// 图片消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_IMAGE)) { respContent = "您发送的是图片消息!"; }
// 语音消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_VOICE)) { respContent = "您发送的是语音消息!"; }
// 视频消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_VIDEO)) { respContent = "您发送的是视频消息!"; }
// 视频消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_SHORTVIDEO)) { respContent = "您发送的是小视频消息!"; }
// 地理位置消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LOCATION)) { respContent = "您发送的是地理位置消息!"; }
// 链接消息
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_LINK)) { respContent = "您发送的是链接消息!"; }
// 事件推送
else
if
(msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_EVENT)) {
// 事件类型
String eventType = requestMap.get("Event");
// 关注
if
(eventType.equals(MessageUtil.EVENT_TYPE_SUBSCRIBE)) { respContent = "谢谢您的关注!"; }
// 取消关注
else
if
(eventType.equals(MessageUtil.EVENT_TYPE_UNSUBSCRIBE)) {
// TODO 取消订阅后用户不会再收到公众账号发送的消息,因此不需要回复
}
// 扫描带参数二维码
else
if
(eventType.equals(MessageUtil.EVENT_TYPE_SCAN)) {
// TODO 处理扫描带参数二维码事件
}
// 上报地理位置
else
if
(eventType.equals(MessageUtil.EVENT_TYPE_LOCATION)) {
// TODO 处理上报地理位置事件
}
// 自定义菜单
else
if
(eventType.equals(MessageUtil.EVENT_TYPE_CLICK)) {
// TODO 处理菜单点击事件
} }
// 设置文本消息的内容
textMessage.setContent(respContent);
// 将文本消息对象转换成xml
respXml = MessageUtil.messageToXml(textMessage); }
catch
(Exception e) { e.printStackTrace(); }
return
respXml; }}
然后部署到我们的BAE上面,体验一下。(部署方法请参照 第二篇 :微信公众平台开发实战之开启开发者模式,接入微信公众平台开发)。
效果如下:
----------------------------------------------------------------------------------------------------------------------------------------
如果您认为本教程质量不错,读后觉得收获很大,预期工资能蹭蹭蹭的往上涨,那么不妨小额赞助我一下,让我有动力继续写出高质量的教程。
----------------------------------------------------------------------------------------------------------------------------------------