微信公众平台开发教程Java版(三) 消息接收和发送

https://www.iteye.com/blog/tuposky-2017429

前面两章已经介绍了如何接入微信公众平台，这一章说说消息的接收和发送

可以先了解公众平台的消息api接口（接收消息，发送消息）

http://mp.weixin.qq.com/wiki/index.php

接收消息

当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。

http://mp.weixin.qq.com/wiki/index.php?title=%E6%8E%A5%E6%94%B6%E6%99%AE%E9%80%9A%E6%B6%88%E6%81%AF

接收的消息类型有6种，分别为：

• 1 文本消息
• 2 图片消息
• 3 语音消息
• 4 视频消息
• 5 地理位置消息
• 6 链接消息

可以根据官方的api提供的字段建立对应的实体类

如：文本消息

有很多属性是所有消息类型都需要的，可以把这些信息提取出来建立一个基类

1. package com.ifp.weixin.entity.Message.req;
2. /**
3. * 消息基类（用户 -> 公众帐号）
4. *
5. */
6. public class BaseMessage {
7. /**
8. * 开发者微信号
9. */
10. private String ToUserName;
11. /**
12. * 发送方帐号（一个OpenID）
13. */
14. private String FromUserName;
15. /**
16. * 消息创建时间 （整型）
17. */
18. private long CreateTime;
19. /**
20. * 消息类型 text、image、location、link
21. */
22. private String MsgType;
23. /**
24. * 消息id，64位整型
25. */
26. private long MsgId;
27. public String getToUserName() {
28. return ToUserName;
29. }
30. public void setToUserName(String toUserName) {
31. ToUserName = toUserName;
32. }
33. public String getFromUserName() {
34. return FromUserName;
35. }
36. public void setFromUserName(String fromUserName) {
37. FromUserName = fromUserName;
38. }
39. public long getCreateTime() {
40. return CreateTime;
41. }
42. public void setCreateTime(long createTime) {
43. CreateTime = createTime;
44. }
45. public String getMsgType() {
46. return MsgType;
47. }
48. public void setMsgType(String msgType) {
49. MsgType = msgType;
50. }
51. public long getMsgId() {
52. return MsgId;
53. }
54. public void setMsgId(long msgId) {
55. MsgId = msgId;
56. }
57. }

接收的文本消息

1. package com.ifp.weixin.entity.Message.req;
2. /**
3. * 文本消息
4. */
5. public class TextMessage extends BaseMessage {
6. /**
7. * 回复的消息内容
8. */
9. private String Content;
10. public String getContent() {
11. return Content;
12. }
13. public void setContent(String content) {
14. Content = content;
15. }
16. }

接收的图片消息

1. package com.ifp.weixin.entity.Message.req;
2. public class ImageMessage extends BaseMessage{
3. private String picUrl;
4. public String getPicUrl() {
5. return picUrl;
6. }
7. public void setPicUrl(String picUrl) {
8. this.picUrl = picUrl;
9. }
10. }

接收的链接消息

1. package com.ifp.weixin.entity.Message.req;
2. public class LinkMessage extends BaseMessage {
3. /**
4. * 消息标题
5. */
6. private String Title;
7. /**
8. * 消息描述
9. */
10. private String Description;
11. /**
12. * 消息链接
13. */
14. private String Url;
15. public String getTitle() {
16. return Title;
17. }
18. public void setTitle(String title) {
19. Title = title;
20. }
21. public String getDescription() {
22. return Description;
23. }
24. public void setDescription(String description) {
25. Description = description;
26. }
27. public String getUrl() {
28. return Url;
29. }
30. public void setUrl(String url) {
31. Url = url;
32. }
33. }

接收的语音消息

1. package com.ifp.weixin.entity.Message.req;
2. /**
3. * 语音消息
4. *
5. * @author Caspar
6. *
7. */
8. public class VoiceMessage extends BaseMessage {
9. /**
10. * 媒体ID
11. */
12. private String MediaId;
13. /**
14. * 语音格式
15. */
16. private String Format;
17. public String getMediaId() {
18. return MediaId;
19. }
20. public void setMediaId(String mediaId) {
21. MediaId = mediaId;
22. }
23. public String getFormat() {
24. return Format;
25. }
26. public void setFormat(String format) {
27. Format = format;
28. }
29. }

接收的地理位置消息

1. package com.ifp.weixin.entity.Message.req;
2. /**
3. * 位置消息
4. *
5. * @author caspar
6. *
7. */
8. public class LocationMessage extends BaseMessage {
9. /**
10. * 地理位置维度
11. */
12. private String Location_X;
13. /**
14. * 地理位置经度
15. */
16. private String Location_Y;
17. /**
18. * 地图缩放大小
19. */
20. private String Scale;
21. /**
22. * 地理位置信息
23. */
24. private String Label;
25. public String getLocation_X() {
26. return Location_X;
27. }
28. public void setLocation_X(String location_X) {
29. Location_X = location_X;
30. }
31. public String getLocation_Y() {
32. return Location_Y;
33. }
34. public void setLocation_Y(String location_Y) {
35. Location_Y = location_Y;
36. }
37. public String getScale() {
38. return Scale;
39. }
40. public void setScale(String scale) {
41. Scale = scale;
42. }
43. public String getLabel() {
44. return Label;
45. }
46. public void setLabel(String label) {
47. Label = label;
48. }
49. }

发送被动响应消息

    对于每一个POST请求，开发者在响应包（Get）中返回特定XML结构，对该消息进行响应（现支持回复文本、图片、图文、语音、视频、音乐）。请注意，回复图片等多媒体消息时需要预先上传多媒体文件到微信服务器，只支持认证服务号。

同样，建立响应消息的对应实体类

也把公共的属性提取出来，封装成基类

响应消息的基类

1. package com.ifp.weixin.entity.Message.resp;
2. /**
3. * 消息基类（公众帐号 -> 用户）
4. */
5. public class BaseMessage {
6. /**
7. * 接收方帐号（收到的OpenID）
8. */
9. private String ToUserName;
10. /**
11. * 开发者微信号
12. */
13. private String FromUserName;
14. /**
15. * 消息创建时间 （整型）
16. */
17. private long CreateTime;
18. /**
19. * 消息类型
20. */
21. private String MsgType;
22. /**
23. * 位0x0001被标志时，星标刚收到的消息
24. */
25. private int FuncFlag;
26. public String getToUserName() {
27. return ToUserName;
28. }
29. public void setToUserName(String toUserName) {
30. ToUserName = toUserName;
31. }
32. public String getFromUserName() {
33. return FromUserName;
34. }
35. public void setFromUserName(String fromUserName) {
36. FromUserName = fromUserName;
37. }
38. public long getCreateTime() {
39. return CreateTime;
40. }
41. public void setCreateTime(long createTime) {
42. CreateTime = createTime;
43. }
44. public String getMsgType() {
45. return MsgType;
46. }
47. public void setMsgType(String msgType) {
48. MsgType = msgType;
49. }
50. public int getFuncFlag() {
51. return FuncFlag;
52. }
53. public void setFuncFlag(int funcFlag) {
54. FuncFlag = funcFlag;
55. }
56. }

响应文本消息

1. package com.ifp.weixin.entity.Message.resp;
2. /**
3. * 文本消息
4. */
5. public class TextMessage extends BaseMessage {
6. /**
7. * 回复的消息内容
8. */
9. private String Content;
10. public String getContent() {
11. return Content;
12. }
13. public void setContent(String content) {
14. Content = content;
15. }
16. }

响应图文消息

1. package com.ifp.weixin.entity.Message.resp;
2. import java.util.List;
3. /**
4. * 多图文消息，
5. * 单图文的时候 Articles 只放一个就行了
6. * @author Caspar.chen
7. */
8. public class NewsMessage extends BaseMessage {
9. /**
10. * 图文消息个数，限制为10条以内
11. */
12. private int ArticleCount;
13. /**
14. * 多条图文消息信息，默认第一个item为大图
15. */
16. private List<Article> Articles;
17. public int getArticleCount() {
18. return ArticleCount;
19. }
20. public void setArticleCount(int articleCount) {
21. ArticleCount = articleCount;
22. }
23. public List<Article> getArticles() {
24. return Articles;
25. }
26. public void setArticles(List<Article> articles) {
27. Articles = articles;
28. }
29. }

图文消息的定义

1. package com.ifp.weixin.entity.Message.resp;
2. /**
3. * 图文消息
4. *
5. */
6. public class Article {
7. /**
8. * 图文消息名称
9. */
10. private String Title;
11. /**
12. * 图文消息描述
13. */
14. private String Description;
15. /**
16. * 图片链接，支持JPG、PNG格式，<br>
17. * 较好的效果为大图640*320，小图80*80
18. */
19. private String PicUrl;
20. /**
21. * 点击图文消息跳转链接
22. */
23. private String Url;
24. public String getTitle() {
25. return Title;
26. }
27. public void setTitle(String title) {
28. Title = title;
29. }
30. public String getDescription() {
31. return null == Description ? "" : Description;
32. }
33. public void setDescription(String description) {
34. Description = description;
35. }
36. public String getPicUrl() {
37. return null == PicUrl ? "" : PicUrl;
38. }
39. public void setPicUrl(String picUrl) {
40. PicUrl = picUrl;
41. }
42. public String getUrl() {
43. return null == Url ? "" : Url;
44. }
45. public void setUrl(String url) {
46. Url = url;
47. }
48. }

响应音乐消息

1. package com.ifp.weixin.entity.Message.resp;
2. /**
3. * 音乐消息
4. */
5. public class MusicMessage extends BaseMessage {
6. /**
7. * 音乐
8. */
9. private Music Music;
10. public Music getMusic() {
11. return Music;
12. }
13. public void setMusic(Music music) {
14. Music = music;
15. }
16. }

音乐消息的定义

1. package com.ifp.weixin.entity.Message.resp;
2. /**
3. * 音乐消息
4. */
5. public class Music {
6. /**
7. * 音乐名称
8. */
9. private String Title;
10. /**
11. * 音乐描述
12. */
13. private String Description;
14. /**
15. * 音乐链接
16. */
17. private String MusicUrl;
18. /**
19. * 高质量音乐链接，WIFI环境优先使用该链接播放音乐
20. */
21. private String HQMusicUrl;
22. public String getTitle() {
23. return Title;
24. }
25. public void setTitle(String title) {
26. Title = title;
27. }
28. public String getDescription() {
29. return Description;
30. }
31. public void setDescription(String description) {
32. Description = description;
33. }
34. public String getMusicUrl() {
35. return MusicUrl;
36. }
37. public void setMusicUrl(String musicUrl) {
38. MusicUrl = musicUrl;
39. }
40. public String getHQMusicUrl() {
41. return HQMusicUrl;
42. }
43. public void setHQMusicUrl(String musicUrl) {
44. HQMusicUrl = musicUrl;
45. }
46. }

构建好之后的项目结构图为

到这里，请求消息和响应消息的实体类都定义好了

解析请求消息

用户向微信公众平台发送消息后，微信公众平台会通过post请求发送给我们。

上一章中WeixinController 类的post方法我们空着

现在我们要在这里处理用户请求了。

因为微信的发送和接收都是用xml格式的，所以我们需要处理请求过来的xml格式。

发送的时候也需要转化成xml格式再发送给微信，所以封装了消息处理的工具类，用到dome4j和xstream两个jar包

1. package com.ifp.weixin.util;
2. import java.io.InputStream;
3. import java.io.Writer;
4. import java.util.HashMap;
5. import java.util.List;
6. import java.util.Map;
7. import javax.servlet.http.HttpServletRequest;
8. import org.dom4j.Document;
9. import org.dom4j.Element;
10. import org.dom4j.io.SAXReader;
11. import com.ifp.weixin.entity.Message.resp.Article;
12. import com.ifp.weixin.entity.Message.resp.MusicMessage;
13. import com.ifp.weixin.entity.Message.resp.NewsMessage;
14. import com.ifp.weixin.entity.Message.resp.TextMessage;
15. import com.thoughtworks.xstream.XStream;
16. import com.thoughtworks.xstream.core.util.QuickWriter;
17. import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
18. import com.thoughtworks.xstream.io.xml.PrettyPrintWriter;
19. import com.thoughtworks.xstream.io.xml.XppDriver;
20. /**
21. * 消息工具类
22. *
23. */
24. public class MessageUtil {
25. /**
26. * 解析微信发来的请求（XML）
27. *
28. * @param request
29. * @return
30. * @throws Exception
31. */
32. public static Map<String, String> parseXml(HttpServletRequest request) throws Exception {
33. // 将解析结果存储在HashMap中
34. Map<String, String> map = new HashMap<String, String>();
35. // 从request中取得输入流
36. InputStream inputStream = request.getInputStream();
37. // 读取输入流
38. SAXReader reader = new SAXReader();
39. Document document = reader.read(inputStream);
40. // 得到xml根元素
41. Element root = document.getRootElement();
42. // 得到根元素的所有子节点
43. @SuppressWarnings("unchecked")
44. List<Element> elementList = root.elements();
45. // 遍历所有子节点
46. for (Element e : elementList)
47. map.put(e.getName(), e.getText());
48. // 释放资源
49. inputStream.close();
50. inputStream = null;
51. return map;
52. }
53. /**
54. * 文本消息对象转换成xml
55. *
56. * @param textMessage 文本消息对象
57. * @return xml
58. */
59. public static String textMessageToXml(TextMessage textMessage) {
60. xstream.alias("xml", textMessage.getClass());
61. return xstream.toXML(textMessage);
62. }
63. /**
64. * 音乐消息对象转换成xml
65. *
66. * @param musicMessage 音乐消息对象
67. * @return xml
68. */
69. public static String musicMessageToXml(MusicMessage musicMessage) {
70. xstream.alias("xml", musicMessage.getClass());
71. return xstream.toXML(musicMessage);
72. }
73. /**
74. * 图文消息对象转换成xml
75. *
76. * @param newsMessage 图文消息对象
77. * @return xml
78. */
79. public static String newsMessageToXml(NewsMessage newsMessage) {
80. xstream.alias("xml", newsMessage.getClass());
81. xstream.alias("item", new Article().getClass());
82. return xstream.toXML(newsMessage);
83. }
84. /**
85. * 扩展xstream，使其支持CDATA块
86. *
87. */
88. private static XStream xstream = new XStream(new XppDriver() {
89. public HierarchicalStreamWriter createWriter(Writer out) {
90. return new PrettyPrintWriter(out) {
91. // 对所有xml节点的转换都增加CDATA标记
92. boolean cdata = true;
93. protected void writeText(QuickWriter writer, String text) {
94. if (cdata) {
95. writer.write("<![CDATA[");
96. writer.write(text);
97. writer.write("]]>");
98. } else {
99. writer.write(text);
100. }
101. }
102. };
103. }
104. });
105. }

接下来在处理业务逻辑，建立一个接收并响应消息的service类，并针对用户输入的1或2回复不同的信息给用户

1. package com.ifp.weixin.biz.core.impl;
2. import java.util.Date;
3. import java.util.Map;
4. import javax.servlet.http.HttpServletRequest;
5. import org.apache.log4j.Logger;
6. import org.springframework.stereotype.Service;
7. import com.ifp.weixin.biz.core.CoreService;
8. import com.ifp.weixin.constant.Constant;
9. import com.ifp.weixin.entity.Message.resp.TextMessage;
10. import com.ifp.weixin.util.MessageUtil;
11. @Service("coreService")
12. public class CoreServiceImpl implements CoreService{
13. public static Logger log = Logger.getLogger(CoreServiceImpl.class);
14. @Override
15. public String processRequest(HttpServletRequest request) {
16. String respMessage = null;
17. try {
18. // xml请求解析
19. Map<String, String> requestMap = MessageUtil.parseXml(request);
20. // 发送方帐号（open_id）
21. String fromUserName = requestMap.get("FromUserName");
22. // 公众帐号
23. String toUserName = requestMap.get("ToUserName");
24. // 消息类型
25. String msgType = requestMap.get("MsgType");
26. TextMessage textMessage = new TextMessage();
27. textMessage.setToUserName(fromUserName);
28. textMessage.setFromUserName(toUserName);
29. textMessage.setCreateTime(new Date().getTime());
30. textMessage.setMsgType(Constant.RESP_MESSAGE_TYPE_TEXT);
31. textMessage.setFuncFlag(0);
32. // 文本消息
33. if (msgType.equals(Constant.REQ_MESSAGE_TYPE_TEXT)) {
34. // 接收用户发送的文本消息内容
35. String content = requestMap.get("Content");
36. if ("1".equals(content)) {
37. textMessage.setContent("1是很好的");
38. // 将文本消息对象转换成xml字符串
39. respMessage = MessageUtil.textMessageToXml(textMessage);
40. }else if ("2".equals(content)) {
41. textMessage.setContent("我不是2货");
42. // 将文本消息对象转换成xml字符串
43. respMessage = MessageUtil.textMessageToXml(textMessage);
44. }
45. }
46. } catch (Exception e) {
47. e.printStackTrace();
48. }
49. return respMessage;
50. }
51. }

接下来在controller里面的post方法里面调用即可

WeixinController类的完整代码

1. package com.ifp.weixin.controller;
2. import java.io.IOException;
3. import java.io.PrintWriter;
4. import java.io.UnsupportedEncodingException;
5. import javax.annotation.Resource;
6. import javax.servlet.http.HttpServletRequest;
7. import javax.servlet.http.HttpServletResponse;
8. import org.springframework.stereotype.Controller;
9. import org.springframework.web.bind.annotation.RequestMapping;
10. import org.springframework.web.bind.annotation.RequestMethod;
11. import com.ifp.weixin.biz.core.CoreService;
12. import com.ifp.weixin.util.SignUtil;
13. @Controller
14. @RequestMapping("/weixinCore")
15. public class WeixinController {
16. @Resource(name="coreService")
17. private CoreService coreService;
18. @RequestMapping(method = RequestMethod.GET)
19. public void get(HttpServletRequest request, HttpServletResponse response) {
20. // 微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
21. String signature = request.getParameter("signature");
22. // 时间戳
23. String timestamp = request.getParameter("timestamp");
24. // 随机数
25. String nonce = request.getParameter("nonce");
26. // 随机字符串
27. String echostr = request.getParameter("echostr");
28. PrintWriter out = null;
29. try {
30. out = response.getWriter();
31. // 通过检验signature对请求进行校验，若校验成功则原样返回echostr，否则接入失败
32. if (SignUtil.checkSignature(signature, timestamp, nonce)) {
33. out.print(echostr);
34. }
35. } catch (IOException e) {
36. e.printStackTrace();
37. } finally {
38. out.close();
39. out = null;
40. }
41. }
42. @RequestMapping(method = RequestMethod.POST)
43. public void post(HttpServletRequest request, HttpServletResponse response) {
44. try {
45. request.setCharacterEncoding("UTF-8");
46. } catch (UnsupportedEncodingException e) {
47. e.printStackTrace();
48. }
49. response.setCharacterEncoding("UTF-8");
50. // 调用核心业务类接收消息、处理消息
51. String respMessage = coreService.processRequest(request);
52. // 响应消息
53. PrintWriter out = null;
54. try {
55. out = response.getWriter();
56. out.print(respMessage);
57. } catch (IOException e) {
58. e.printStackTrace();
59. } finally {
60. out.close();
61. out = null;
62. }
63. }
64. }

效果如下：

ok，大功告成，消息的接收和发送就写完了。