Java+微信公众号开发过程步骤详解2-java教程-PHP中文网

首页

Java

java教程

Java+微信公众号开发过程步骤详解2

php是最好的语言

Aug 10, 2018 pm 02:50 PM

上一篇文章总结了Java语言开发微信公众平台的第一部分——环境搭建与开发接入，这一篇总结消息的接收与响应。

接入微信公众平台的时候，微信将发送Get请求给我们的校验方法。那当我们接收消息的时候，微信将向我们发送Post请求，并以XML的格式发送与接收数据。

看一下微信发给我们的普通文本消息的XML包结构：

1348831860

1234567890123456

官方文档说明：

了解之后，开始敲代码：

1.将接收到的XML格式，转为集合对象（Map）

在Util包下，新建一个MessageUtil工具类：

将接收到的XML格式，转化为Map格式需要一个叫dom4j的jar包。并将其放置在Web-INF下的lib包中，在文章的末尾我会放上所需的所有jar包。借助dom4j的jar包，我们可以编写方法，将XML格式，转化对Map对象格式，方法实现如下：

/**
	 * 新建方法，将接收到的XML格式，转化为Map对象
	 * @param request 将request对象，通过参数传入
	 * @return 返回转换后的Map对象
	 */
	public static Map<String, String> xmlToMap(HttpServletRequest request) 
			throws IOException, DocumentException{
		Map<String, String> map = new HashMap<String, String>();
		//从dom4j的jar包中，拿到SAXReader对象。
		SAXReader reader = new SAXReader();
		InputStream is = request.getInputStream();//从request中，获取输入流
		Document doc =  reader.read(is);//从reader对象中,读取输入流
		Element root = doc.getRootElement();//获取XML文档的根元素
		List<Element> list = root.elements();//获得根元素下的所有子节点
		for (Element e : list) {
			map.put(e.getName(), e.getText());//遍历list对象，并将结果保存到集合中
		}
		is.close();
		return map;
	}

登录后复制

2、 类似上述方法，我们需要编写方法，将我们的消息对象，转成XML。

此处，我们仍需借助一个jar包：xstream.jar,导入方式同dom4j。（另说明一点，之前我导入的xstream是1.4的版本，回复消息总是缺少内容，于是在各种尝试后将jar包版本换成1.3后回复消息成功，特此说明一下，具体原因暂时未知，将此坑告诉后面学习的人以防浪费时间）

当然，首先，我们需要新建一个实体类TextMessage，用于承载消息对象，实体类中6个属性，分别对应上述微信给我们发送的XML文本的6个参数，并提供对应Get/Set方法以及空参/全参构造，此处不做赘述：

private String ToUserName;//开发者微信号
private String FromUserName;//发送方账号
private Long CreateTime;//消息创建时间
private String MsgType;//消息类型
private String Content;//文本消息内容
private String MsgId;//消息id，64位整型

登录后复制

接下来，我们编写方法，来转换此文本消息类的对象，将其转换为XML格式返回：

/**
* 将文本消息对象转化成XML格式
* @param message 文本消息对象
* @return 返回转换后的XML格式
*/
public static String textMessageToXml(TextMessage message){
	XStream xs = new XStream();
	//由于转换后xml根节点默认为class类，需转化为<xml>
	xs.alias("xml", message.getClass());
	return xs.toXML(message);
}

登录后复制

3、 写完上述两个处理方法后，我们来实现【消息的接收与响应】，

回到我们最开始的Servlet中，在doPost方法中进行编写操作：

public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

		request.setCharacterEncoding("UTF-8");
		response.setCharacterEncoding("UTF-8");
		PrintWriter out = response.getWriter();
		try {
			//将request请求，传到Message工具类的转换方法中，返回接收到的Map对象
			Map<String, String> map = MessageUtil.xmlToMap(request);
			//从集合中，获取XML各个节点的内容
			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");
			if(MsgType.equals("text")){//判断消息类型是否是文本消息(text)
				TextMessage message = new TextMessage();
                //原来【接收消息用户】变为回复时【发送消息用户】
				message.setFromUserName(ToUserName);
				message.setToUserName(FromUserName);
				message.setMsgType("text");
				message.setCreateTime(new Date().getTime());//创建当前时间为消息时间
				message.setContent("您好，"+FromUserName+"\n我是："+ToUserName
				+"\n您发送的消息类型为："+MsgType+"\n您发送的时间为"+CreateTime
				+"\n我回复的时间为："+message.getCreateTime()+"\n您发送的内容是："+Content);
				//调用Message工具类，将对象转为XML字符串
                str = MessageUtil.textMessageToXml(message); 
				System.out.println(str);
				out.print(str);
			}
		} catch (DocumentException e) {
			e.printStackTrace();
		}finally{
			out.close();
		}
		} catch (DocumentException e) {
			e.printStackTrace();
		}finally{
			out.close();
		}
	}

登录后复制

这样，我们就成功的完成了文本消息的接收与响应。