使用Java语言开发微信公众平台——被关注回复与关键词回复

Posted 2020-09-03 杰瑞教育

在上一篇文章中，我们实现了文本消息的接收与响应。可以在用户发送任何内容的时候，回复一段固定的文字。本章节中，我们将对上一章节的代码进行适当的完善，同时实现【被关注回复与关键词回复】功能。

一、微信可提供的消息类型

在上一篇文章中，在我们的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();

}