【公众号-个人订阅号开发】接受图片消息&响应图片消息

已于 2024-10-05 13:12:25 修改
阅读量446 收藏 8
点赞数 4
分类专栏： 微信公众号-订阅号 文章标签： java 开发语言 微信公众平台
于 2024-10-05 12:48:30 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u010724965/article/details/142711539
版权

服务器接受图片消息

继上一章节（【公众号-个人订阅号开发】接受文本消息&响应文本消息）实现了公众号后端收发文本消息以后，本章节将实现公众号后台收发文本消息的功能。

老规矩，假设如下场景。

  • 用户A发送一张图片消息给到微信订阅号接入的服务器后台
  • 微信后台自动回复图片消息给到用户A

开发代码

基于上一章的代码（【公众号-个人订阅号开发】接受文本消息&响应文本消息）继续开发。

接收图片消息实体类

官方文本数据说明如下

图片消息xml 样例

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1348831860</CreateTime>
  <MsgType><![CDATA[image]]></MsgType>
  <PicUrl><![CDATA[this is a url]]></PicUrl>
  <MediaId><![CDATA[media_id]]></MediaId>
  <MsgId>1234567890123456</MsgId>
   <MsgDataId>xxxx</MsgDataId>
  <Idx>xxxx</Idx>
</xml>

字段说明 

参数描述
ToUserName开发者微信号
FromUserName发送方账号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType消息类型，图片为image
PicUrl图片链接（由系统生成）
MediaId图片消息媒体id，可以调用获取临时素材接口拉取数据。
MsgId消息id，64位整型
MsgDataId消息的数据ID（消息如果来自文章时才有）
Idx多图文时第几篇文章，从1开始（消息如果来自文章时才有）

ReceiveMessage实体类Java

通过比较发现，相对于文本消息无非就是多了PicUrl和MediaId, 所以把上一章中的实体类（ReceiveTextMessage.java）重命名为ReceiveMessage.java。这样一个实体类就可以接受两种消息。你也可以定义基类比如BaseMessage.java抽取公共部分，这边暂先不抽取。

package top.xyx0123.wx.entity;

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.xml.bind.annotation.XmlAccessType;
import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlRootElement;
import lombok.Data;

/**
 * ReceiveMessage.
 */
@XmlRootElement(name = "xml")
@XmlAccessorType(XmlAccessType.FIELD)
@Data
@Schema(example =
//Text
//        "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
//                "<xml>\n" +
//                " <Content>你好</Content>\n" +
//                " <CreateTime>0</CreateTime>\n" +
//                " <ToUserName>B</ToUserName>\n" +
//                " <FromUserName>A</FromUserName>\n" +
//                " <MsgDataId>msgDataId</MsgDataId>\n" +
//                " <MsgId>msgId</MsgId>\n" +
//                " <MsgType>text</MsgType>\n" +
//                "</xml>",
//Pic
        "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
                "<xml>\n" +
                "  <ToUserName><![CDATA[toUser]]></ToUserName>\n" +
                "  <FromUserName><![CDATA[fromUser]]></FromUserName>\n" +
                "  <CreateTime>1348831860</CreateTime>\n" +
                "  <MsgType><![CDATA[image]]></MsgType>\n" +
                "  <PicUrl><![CDATA[this is a url]]></PicUrl>\n" +
                "  <MediaId><![CDATA[media_id]]></MediaId>\n" +
                "  <MsgId>1234567890123456</MsgId>\n" +
                "  <MsgDataId>xxxx</MsgDataId>\n" +
                "  <Idx>xxxx</Idx>\n" +
                "</xml>")
public class ReceiveMessage {
    private String ToUserName;

    private String FromUserName;

    private long CreateTime;

    private String MsgType;

    private long MsgId;

    private String MsgDataId;

    private String Content;

    /** new fields as below. **/
//  <PicUrl><![CDATA[this is a url]]></PicUrl>
//  <MediaId><![CDATA[media_id]]></MediaId>
    private String PicUrl;
    private String MediaId;
}

响应图片消息实体类

响应xml 样例

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>12345678</CreateTime>
  <MsgType><![CDATA[image]]></MsgType>
  <Image>
    <MediaId><![CDATA[media_id]]></MediaId>
  </Image>
</xml>

字段说明 

参数是否必须说明
ToUserName是接收方账号（收到的OpenID）
FromUserName是开发者微信号
CreateTime是消息创建时间 （整型）
MsgType是消息类型，图片为image
MediaId是通过素材管理中的接口上传多媒体文件，得到的id。

ResponseMessage实体类Java 

同样的我们把上一章提到的ResponseTextMessage实体类改成ResponseMessage并添加MediaId字段。这里要注意下，MediaId需要被Image标签包裹，并是一个数组类型。

package top.xyx0123.wx.entity;

import jakarta.xml.bind.annotation.XmlAccessType;
import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlElementWrapper;
import jakarta.xml.bind.annotation.XmlRootElement;
import lombok.Data;

/**
 * ResponseMessage.
 */
@XmlRootElement(name = "xml")
@XmlAccessorType(XmlAccessType.FIELD)
@Data
public class ResponseMessage {
    private String ToUserName;

    private String FromUserName;

    private long CreateTime;

    private String MsgType;

    private String Content;

    @XmlElementWrapper(name = "Image")
    private String[] MediaId;
}

Controller 接收逻辑修改

逻辑如下

  • 解析MsgType字段，text类型回复文本消息“好的，正在为你转接中”
  • 解析MgsType字段，image类型回复图片消息，我这边是把用户发送进来的图片又回复给用户。
 @RequestMapping(value = "/wechat/validate", method = RequestMethod.POST,
            produces = {"application/xml; charset=UTF-8",},
            consumes = {"text/xml; charset=UTF-8"})
    public ResponseMessage receiveMessage(@RequestBody ReceiveMessage receiveMessage) {
        log.info("Receive message: {}", receiveMessage);
        ResponseMessage responseMessage = new ResponseMessage();
        if ("text".equals(receiveMessage.getMsgType())) {
            responseMessage.setToUserName(receiveMessage.getFromUserName());
            responseMessage.setFromUserName(receiveMessage.getToUserName());
            responseMessage.setCreateTime(new Date().getTime());
            responseMessage.setMsgType(receiveMessage.getMsgType());
            responseMessage.setContent("好的，正在为你转接中");
               
        } else if ("image".equals(receiveMessage.getMsgType())) {
            responseMessage.setToUserName(receiveMessage.getFromUserName());
            responseMessage.setFromUserName(receiveMessage.getToUserName());
            responseMessage.setCreateTime(new Date().getTime());
            responseMessage.setMsgType(receiveMessage.getMsgType());
            responseMessage.setMediaId(new String[]{receiveMessage.getMediaId()});
        }
        return responseMessage;
    }

测试

本地sawgger测试文本消息

回归测试下之前的文本消息是否正常

  • 输入构建文本消息体
<?xml version="1.0" encoding="UTF-8"?>
<xml>
<Content>你好</Content>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1348831860</CreateTime>
  <MsgType>text</MsgType>
  <MsgId>1234567890123456</MsgId>
  <MsgDataId>xxxx</MsgDataId>
  <Idx>xxxx</Idx>
</xml>

  • 测试结果

本地sawgger测试图片消息

  • 输入构建图片消息体
<?xml version="1.0" encoding="UTF-8"?>
<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1348831860</CreateTime>
  <MsgType><![CDATA[image]]></MsgType>
  <PicUrl><![CDATA[this is a url]]></PicUrl>
  <MediaId><![CDATA[media_id]]></MediaId>
  <MsgId>1234567890123456</MsgId>
  <MsgDataId>xxxx</MsgDataId>
  <Idx>xxxx</Idx>
</xml>
  • 测试结果

公众号测试

部署代码，在“软件老许”公众号上测试下功能。

  • 搜索“软件老许” 公众号
  • 发送文本消息“你好”
  • 发送图片信息

结果如下

写在最后

至此，微信公众号的接收图片消息以及回复图片消息的功能已经开发测试完成。大家可以关注我的公众号（软件老许）去验证实现的功能，后面开发的功能也都会集成到这个公众号上面。

目前实现的功能

  • 公众号-订阅号服务器接入
  • 接收/回复文本消息
  • 接收回复图片消息

更多功能敬请期待

谢谢大家！ 十一假期快乐！

Cat_Xu
关注
专栏目录
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值