使用Java语言开发微信公众平台(五)——被关注回复与关键词回复
在上一篇文章中,我们实现了文本消息的接收与响应。可以在用户发送任何内容的时候,回复一段固定的文字。本章节中,我们将对上一章节的代码进行适当的完善,同时实现【被关注回复与关键词回复】功能。
一、微信可提供的消息类型
在上一篇文章中,在我们的Servalet中,我们有这样的一段代码:
我们说这是用于判断接收的消息类型是否为text,即是否为文本消息时,将用户发送的给信息拼接后返回。但这个这个功能现在不足以满足我们的时候,我们将重写代码,实现被关注时自动回复,以及根据关键词自动回复。而首先,我们需要了解微信公众平台支持的消息类型以及对应的事件关键字:
1、可接收消息类型:
文本消息——text,语音消息——voice,图片消息——image,
视频消息——video,链接消息——link,位置消息——location,
消息视频消息——shortvideo,
2、支持的事件推送——event
关注——subscribe,取消关注——unsubscribe,上传地理位置——location
菜单点击——点击菜单获取消息时触发click/点击菜单跳转链接时触发view
扫描带参数二维码——未关注时触发subscribe/已关注时触发scan
那我们可以清楚的看到,微信可接收的消息类型以及可触发的事件类型有很多种,而每种类型都对应着详细的XML包,在微信公众平台开发文档中有详细解析,此处不做赘述,详情可参考开发文档内容:
可接受消息类型:
http://mp.weixin.qq.com/wiki/10/79502792eef98d6e0c6e1739da387346.html
可支持事件类型:
http://mp.weixin.qq.com/wiki/2/5baf56ce4947d35003b86a9805634b1e.html
二、实现被关注自动回复
根据上述消息类型的描述,我们可以重写一下我们上周的MessageUtil类,让我们的工具类可以提供更完善的功能:
1、根据消息类型,提供各种常量:
在我们的工具类中提供各种常量,方便在使用不同消息类型的时候,可以直接调用:
2、修改Servlet中的文本消息判断方式
有了这样的一些常量呢,我们就需要将上周判断文本消息的代码,替换为用常量判断
替换为
同时,添加一种类型判断,判断接收的消息类型,是否为事件类型,添加完后,if-else结构框架如下:
而在传入事件过程中,我们知道又细分为关注、取消关注、点击菜单等多种功能,那如何细分呢?我们可以在else if 中继续做判断,通过我们上周将xml转换为的map中,直接get(“Event”),从而取到详细的事件类型,然后可以进一步判断事件为subscribe还是unsubscribe等,详细如下:
通过上述if结构,我们可以精确的判断到关注时所触发的事件,也就是说我们可以在用户关注时,推送一条消息主菜单,那么我们需要在MessageUtil类中,新建两个方法:
3、撰写拼接主菜单方法&初始化消息方法
① 拼接主菜单方法,此方法比较简单,只是简单地字符串拼接,方便后期频繁使用:
② 初始化消息方法,此方法用于传入接收用户、发送用户、消息内容,进而进行拼接组装,并转换为XML结构:
完成上述两个方法后,我们就可以在用户关注的if结构中,调用initText方法,传入我们拼接的主菜单,在用户关注时,推送我们的功能主菜单:
截止到这,我们就完成了用户关注时,推送主菜单的功能,实现效果如下:
三、实现关键词自动回复
有了上述关注自动回复的基础,我们再实现关键词自动回复,就会非常的简单,只需要在原始判断消息类型为Text的if条件中,继续进行二次判断,判断用户发送的消息为“1”、“2”、“?”还是其他内容,当然为了更好地体验,我们判定中英文?均会调出主菜单,详细实现代码如下:
通过上述代码,我们就顺利的完成了关键词回复功能,详细实现效果如下:
至此,我们本篇文章的“被关注回复与关键词回复”功能就已经介绍并开发完毕。同学们可下载源码或加入杰瑞教育开发交流QQ群(452379712),进行进一步的学习交流。
【附】源码参考:
1、MessageUtil类:
package com.jredu.util;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;
import com.jredu.entity.TextMessage;
import com.thoughtworks.xstream.XStream;
public class MessageUtil {
public static final String MESSAGE_TEXT = "text";
public static final String MESSAGE_IMAGE = "image";
public static final String MESSAGE_VOICE = "voice";
public static final String MESSAGE_VIDEO = "video";
public static final String MESSAGE_SHORTVIDEO = "shortvideo";
public static final String MESSAGE_LINK = "link";
public static final String MESSAGE_LOCATION = "location";
public static final String MESSAGE_EVENT = "event";
public static final String MESSAGE_SUBSCRIBE = "subscribe";
public static final String MESSAGE_UNSUBSCRIBE = "unsubscribe";
public static final String MESSAGE_CLICK = "CLICK";
public static final String MESSAGE_VIEW = "VIEW";
public static final String MESSAGE_SCAN = "SCAN";
/**
* 将XML转为MAP集合
* @param request
* @return
* @throws IOException
* @throws DocumentException
*/
public static Map<String , String> xmlToMap(HttpServletRequest request) throws IOException, DocumentException{
Map<String , String> map = new HashMap<String, String>();
SAXReader reader = new SAXReader();
//从request对象中获取输入流
InputStream ins = request.getInputStream();
//使用reader对象读取输入流,解析为XML文档
Document doc = reader.read(ins);
//获取XML根元素
Element root = doc.getRootElement();
//将根元素的所有节点,放入列表中
List<Element> list = root.elements();
//遍历list对象,并保存到集合中
for (Element element : list) {
map.put(element.getName(), element.getText());
}
ins.close();
return map;
}
/**
* 将文本消息对象转成XML
* @param text
* @return
*/
public static String textMessageToXml(TextMessage textMessage){
XStream xstream = new XStream();
//将xml的根节点替换成<xml> 默认为TextMessage的包名
xstream.alias("xml", textMessage.getClass());
return xstream.toXML(textMessage);
}
/**
* 拼接关注主菜单
*/
public static String menuText(){
StringBuffer sb = new StringBuffer();
sb.append("欢迎关注史上最帅公众号,请选择:\n\n");
sb.append("1、姜浩真帅。\n");
sb.append("2、姜浩并不帅。\n\n");
sb.append("回复?调出主菜单。\n\n");
return sb.toString();
}
/**
* 初始化回复消息
*/
public static String initText(String toUSerName,String fromUserName,String content){
TextMessage text = new TextMessage();
text.setFromUserName(toUSerName);
text.setToUserName(fromUserName);
text.setMsgType(MESSAGE_TEXT);
text.setCreateTime(new Date().getTime()+"");
text.setContent(content);
return MessageUtil.textMessageToXml(text);
}
}
2、Servlet中的doPost方法:
request.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
PrintWriter out = response.getWriter();
try {
Map<String , String> map = MessageUtil.xmlToMap(request);
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 ");
String message = null;
if (MsgType.equals(MessageUtil.MESSAGE_TEXT)) {//判断是否为文本消息类型
if (Content.equals("1")) {
message = MessageUtil.initText(ToUserName, FromUserName,
"对啊!我也是这么觉得!姜浩帅哭了!");
} else if(Content.equals("2")){
message = MessageUtil.initText(ToUserName, FromUserName,
"好可怜啊!你年级轻轻地就瞎了!");
} else if(Content.equals("?") || Content.equals("?")){
message = MessageUtil.initText(ToUserName, FromUserName,
MessageUtil.menuText());
} else {
message = MessageUtil.initText(ToUserName, FromUserName,
"没让你选的就别瞎嘚瑟!!!");
}
}else if(MsgType.equals(MessageUtil.MESSAGE_EVENT)){//判断是否为事件类型
//从集合中,或许是哪一种事件传入
String eventType = map.get("Event");
//关注事件
if (eventType.equals(MessageUtil.MESSAGE_SUBSCRIBE)) {
message = MessageUtil.initText(ToUserName, FromUserName,
MessageUtil.menuText());
}
}
System.out.println(message);
out.print(message);
} catch (DocumentException e) {
e.printStackTrace();
}finally{
out.close();
作者:KeerDi —— 北方的后生
出处:http://www.cnblogs.com/keerdi/
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。