微信公众帐号开发教程(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="http://blog.csdn.net/lyq8479">柳峰的博客</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

("http://0.xiaoqrobot.duapp.com/images/avatar_liufeng.jpg");
                    article.setUrl("http://blog.csdn.net/lyq8479");
                    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个月。为帮助初学者入门，特推出此系列连载教程，也希望借此机会认识更多同行！nn目前已推出教程共12篇，包括接口配置、消息封装、框架搭建、QQ表情

发送、符号表情发送等。nn后期还计划推出一些实用功能的开发讲解，例如：天气预报、周边搜索、聊天功能等。");
                    // 将图片置为空
                    article.setPicUrl("");
                    article.setUrl("http://blog.csdn.net/lyq8479");
                    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("http://0.xiaoqrobot.duapp.com/images/avatar_liufeng.jpg");
                    article1.setUrl("http://blog.csdn.net/lyq8479/article/details/8937622");  

                    Article article2 = new Article();
                    article2.setTitle("第2篇n微信公众帐号的类型");
                    article2.setDescription("");
                    article2.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article2.setUrl("http://blog.csdn.net/lyq8479/article/details/8941577");  

                    Article article3 = new Article();
                    article3.setTitle("第3篇n开发模式启用及接口配置");
                    article3.setDescription("");
                    article3.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article3.setUrl("http://blog.csdn.net/lyq8479/article/details/8944988");  

                    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("http://blog.csdn.net/lyq8479");  

                    Article article2 = new Article();
                    article2.setTitle("第4篇n消息及消息处理工具的封装");
                    article2.setDescription("");
                    article2.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article2.setUrl("http://blog.csdn.net/lyq8479/article/details/8949088");  

                    Article article3 = new Article();
                    article3.setTitle("第5篇n各种消息的接收与响应");
                    article3.setDescription("");
                    article3.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article3.setUrl("http://blog.csdn.net/lyq8479/article/details/8952173");  

                    Article article4 = new Article();
                    article4.setTitle("第6篇n文本消息的内容长度限制揭秘");
                    article4.setDescription("");
                    article4.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article4.setUrl("http://blog.csdn.net/lyq8479/article/details/8967824");  

                    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("http://0.xiaoqrobot.duapp.com/images/avatar_liufeng.jpg");
                    article1.setUrl("http://blog.csdn.net/lyq8479/article/details/9141467");  

                    Article article2 = new Article();
                    article2.setTitle("第8篇n文本消息中使用网页超链接");
                    article2.setDescription("");
                    article2.setPicUrl("http://avatar.csdn.net/1/4/A/1_lyq8479.jpg");
                    article2.setUrl("http://blog.csdn.net/lyq8479/article/details/9157455");  

                    Article article3 = new Article();
                    article3.setTitle("如果觉得文章对你有所帮助，请通过博客留言或关注微信公众帐号xiaoqrobot来支持柳峰！");
                    article3.setDescription("");
                    // 将图片置为空
                    article3.setPicUrl("");
                    article3.setUrl("http://blog.csdn.net/lyq8479");  

                    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));
    }
}

以上是小编为您精心准备的的内容，在的博客、问答、公众号、人物、课程等栏目也有的相关内容，欢迎继续使用右上角搜索按钮进行搜索csdn
， http
， csdn博客
，消息
，图文消息
， requestmapping
，帐号
， article
，消息为空
，微信图片处理
， java微信
，微信，C#，.net
，图文
发送图文消息
微信公众号图文消息、微信公众图文消息模板、微信公众平台图文消息、公众平台图文消息模板、公众号图文消息，以便于您获取更多的相关知识。

时间： 2024-04-18 10:05:24

微信公众帐号开发教程(13) 图文消息全攻略

微信公众帐号开发教程(13) 图文消息全攻略的相关文章

微信公众帐号开发教程之图文消息全攻略_java

微信公众帐号开发教程(六) 文本消息的内容长度限制揭秘

微信公众帐号开发教程(八) 文本消息中使用网页超链接

微信公众帐号开发教程(七) 文本消息中换行符的使用

微信公众帐号开发教程(五) 各种消息的接收与响应

微信公众帐号开发教程之文本消息长度限制详解

微信公众帐号开发教程(一) 引言

微信公众帐号开发教程(十二) 符号表情的发送（下）

微信公众帐号开发教程(十一) 符号表情的发送（上）