[037] 微信公众帐号开发教程第13篇

引言及内容概要

已经有几位读者抱怨“柳峰只用到文本消息作为示例，从来不提图文消息，都不知道图文消息该如何使用”，好吧，我错了，原本以为把基础API封装完、框架搭建好，再给出一个文本消息的使用示例，大家就能够照猫画虎的，或许是因为我的绘画功底太差，画出的那只猫本来就不像猫吧……

本篇主要介绍微信公众帐号开发中图文消息的使用，以及图文消息的几种表现形式。标题取名为“图文消息全攻略”，这绝对不是标题党，是想借此机会把大家对图文消息相关的问题、疑虑、障碍全部清除掉。

图文消息的主要参数说明

通过微信官方的，可以看到对图文消息的参数介绍，如下图所示：

从图中可以了解到：

1）图文消息的个数限制为10，也就是图中ArticleCount的值（图文消息的个数，限制在10条以内）；

2）对于多图文消息，第一条图文的图片显示为大图，其他图文的图片显示为小图；

3）第一条图文的图片大小建议为640*320，其他图文的图片大小建议为80*80；

好了，了解这些，再结合第4篇文章所讲的消息及消息处理工具的封装，想要回复图文消息给用户也就不是什么难事了。

图文消息的多种表现形式

下面直接通过代码演示图文消息最主要的五种表现形式的用法，源代码如下：

package org.liufeng.course.service;import java.util.ArrayList;import java.util.Date;import java.util.List;import java.util.Map;import javax.servlet.http.HttpServletRequest;import org.liufeng.course.message.resp.Article;import org.liufeng.course.message.resp.NewsMessage;import org.liufeng.course.message.resp.TextMessage;import org.liufeng.course.util.MessageUtil;/** * 核心服务类 * * @author liufeng * @date 2013-07-25 */public class CoreService {/** * 处理微信发来的请求 ** @param request * @return */public static String processRequest(HttpServletRequest request) {String respMessage = null;try {// xml请求解析Map<String, String> requestMap = MessageUtil.parseXml(request);// 发送方帐号（open_id）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);textMessage.setFuncFlag(0);// 由于href属性值必须用双引号引起，这与字符串本身的双引号冲突，，所以要转义textMessage.setContent("欢迎访问<a href=\&;\&;>柳峰的博客</a>!");// 将文本消息对象转换成xml字符串respMessage = MessageUtil.textMessageToXml(textMessage);// 文本消息if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) {// 接收用户发送的文本消息内容String content = requestMap.get("Content");// 创建图文消息NewsMessage newsMessage = new NewsMessage();newsMessage.setToUserName(fromUserName);newsMessage.setFromUserName(toUserName);newsMessage.setCreateTime(new Date().getTime());newsMessage.setMsgType(MessageUtil.RESP_MESSAGE_TYPE_NEWS);newsMessage.setFuncFlag(0);List<Article> articleList = new ArrayList<Article>();// 单图文消息if ("1".equals(content)) {Article article = new Article();article.setTitle("微信公众帐号开发教程Java版");article.setDescription("柳峰，80后，微信公众帐号开发经验4个月。为帮助初学者入门，特推出此系列教程，也希望借此机会认识更多同行！");article.setPicUrl("");article.setUrl("");articleList.add(article);// 设置图文消息个数newsMessage.setArticleCount(articleList.size());// 设置图文消息包含的图文集合newsMessage.setArticles(articleList);// 将图文消息对象转换成xml字符串respMessage = MessageUtil.newsMessageToXml(newsMessage);}// 单图文消息—不含图片else if ("2".equals(content)) {Article article = new Article();article.setTitle("微信公众帐号开发教程Java版");// 图文消息中可以使用QQ表情、符号表情article.setDescription("柳峰，80后，" + emoji(0x1F6B9)+ "，微信公众帐号开发经验4个月。为帮助初学者入门，特推出此系列连载教程，也希望借此机会认识更多同行！\n\n目前已推出教程共12篇，包括接口配置、消息封装、框架搭建、QQ表情发送、符号表情发送等。\n\n后期还计划推出一些实用功能的开发讲解，例如：天气预报、周边搜索、聊天功能等。");// 将图片置为空article.setPicUrl("");article.setUrl("");articleList.add(article);newsMessage.setArticleCount(articleList.size());newsMessage.setArticles(articleList);respMessage = MessageUtil.newsMessageToXml(newsMessage);}// 多图文消息else if ("3".equals(content)) {Article article1 = new Article();article1.setTitle("微信公众帐号开发教程\n引言");article1.setDescription("");article1.setPicUrl("");article1.setUrl("");Article article2 = new Article();article2.setTitle("第2篇\n微信公众帐号的类型");article2.setDescription("");article2.setPicUrl("");article2.setUrl("");Article article3 = new Article();article3.setTitle("第3篇\n开发模式启用及接口配置");article3.setDescription("");article3.setPicUrl("");article3.setUrl("");articleList.add(article1);articleList.add(article2);articleList.add(article3);newsMessage.setArticleCount(articleList.size());newsMessage.setArticles(articleList);respMessage = MessageUtil.newsMessageToXml(newsMessage);}// 多图文消息—首条消息不含图片else if ("4".equals(content)) {Article article1 = new Article();article1.setTitle("微信公众帐号开发教程Java版");article1.setDescription("");// 将图片置为空article1.setPicUrl("");article1.setUrl("");Article article2 = new Article();article2.setTitle("第4篇\n消息及消息处理工具的封装");article2.setDescription("");article2.setPicUrl("");article2.setUrl("");Article article3 = new Article();article3.setTitle("第5篇\n各种消息的接收与响应");article3.setDescription("");article3.setPicUrl("");article3.setUrl("");Article article4 = new Article();article4.setTitle("第6篇\n文本消息的内容长度限制揭秘");article4.setDescription("");article4.setPicUrl("");article4.setUrl("");articleList.add(article1);articleList.add(article2);articleList.add(article3);articleList.add(article4);newsMessage.setArticleCount(articleList.size());newsMessage.setArticles(articleList);respMessage = MessageUtil.newsMessageToXml(newsMessage);}// 多图文消息—最后一条消息不含图片else if ("5".equals(content)) {Article article1 = new Article();article1.setTitle("第7篇\n文本消息中换行符的使用");article1.setDescription("");article1.setPicUrl("");article1.setUrl("");Article article2 = new Article();article2.setTitle("第8篇\n文本消息中使用网页超链接");article2.setDescription("");article2.setPicUrl("");article2.setUrl("");Article article3 = new Article();article3.setTitle("如果觉得文章对你有所帮助，请通过博客留言或关注微信公众帐号xiaoqrobot来支持柳峰！");article3.setDescription("");// 将图片置为空article3.setPicUrl("");article3.setUrl("");articleList.add(article1);articleList.add(article2);articleList.add(article3);newsMessage.setArticleCount(articleList.size());newsMessage.setArticles(articleList);respMessage = MessageUtil.newsMessageToXml(newsMessage);}}} catch (Exception e) {e.printStackTrace();}return respMessage;}/** * emoji表情转换(hex -> utf-16) ** @param hexEmoji * @return */public static String emoji(int hexEmoji) {return String.valueOf(Character.toChars(hexEmoji));}}

如果不明白CoreService类放在什么位置，该如何使用，请查看本系列教程的第5篇。上面代码实现的功能是当用户发送数字1-5时，分别回复五种不同表现形式的图文消息给用户，如下：

a）用户发送1，回复单图文消息。参考代码68~81行，运行效果如下：

旅行是一种病，当你把身边的人都传染了，