微信公共号开发教程java版——请求消息,响应消息及事件消息类的封装(三)_封装微信公众号平台发送消息代码-程序员宅基地

技术标签: 微信公共号  

一:封装请求信息

这里写图片描述

当普通微信用户向公众账号发消息时,微信服务器将POST消息的XML数据包到开发者填写的URL上。
各消息类型的推送XML数据包结构如下:
查看官网详细介绍

文本消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName> 
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[this is a test]]></Content>
 <MsgId>1234567890123456</MsgId>
 </xml>

参数          描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     text
Content     文本消息内容
MsgId       消息id,64位整型


图片消息

 <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>
 </xml>

参数      描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     image
PicUrl      图片链接
MediaId     图片消息媒体id,可以调用多媒体文件下载接口拉取数据。
MsgId       消息id,64位整型


语音消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>

参数      描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     语音为voice
MediaId     语音消息媒体id,可以调用多媒体文件下载接口拉取数据。
Format      语音格式,如amr,speex等
MsgID       消息id,64位整型



请注意,开通语音识别后,用户每次发送语音给公众号时,微信会在推送的语音消息XML数据包中,增加一个Recongnition字段 (注:由于客户端缓存,开发者开启或者关闭语音识别功能,对新关注者立刻生效,对已关注用户需要24小时生效。开发者可以重新关注此帐号进行测试)。开启 语音识别后的语音XML数据包如下:

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<Recognition><![CDATA[腾讯微信团队]]></Recognition>
<MsgId>1234567890123456</MsgId>
</xml>

多出的字段中,Format为语音格式,一般为amr,Recognition为语音识别结果,使用UTF8编码。
视频消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>

参数      描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     视频为video
MediaId     视频消息媒体id,可以调用多媒体文件下载接口拉取数据。
ThumbMediaId    视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。
MsgId       消息id,64位整型


小视频消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[shortvideo]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>

参数      描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     小视频为shortvideo
MediaId     视频消息媒体id,可以调用多媒体文件下载接口拉取数据。
ThumbMediaId    视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。
MsgId       消息id,64位整型


地理位置消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[位置信息]]></Label>
<MsgId>1234567890123456</MsgId>
</xml> 

参数      描述
ToUserName      开发者微信号
FromUserName    发送方帐号(一个OpenID)
CreateTime      消息创建时间 (整型)
MsgType     location
Location_X      地理位置维度
Location_Y      地理位置经度
Scale       地图缩放大小
Label       地理位置信息
MsgId       消息id,64位整型


链接消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公众平台官网链接]]></Title>
<Description><![CDATA[公众平台官网链接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml> 

参数      描述
ToUserName      接收方微信号
FromUserName    发送方微信号,若为普通用户,则是一个OpenID
CreateTime      消息创建时间
MsgType     消息类型,link
Title       消息标题
Description     消息描述
Url         消息链接
MsgId       消息id,64位整型

其中用户可以向微信服务器发送的消息类型大概可以分为:文本消息,图片消息,语音消息,视频消息,小视频消息,地理位置消息,链接消息。

根据观察可以知道这些消息中,都会传回来这些公共的字段如:

ToUserName(开发者微信号);

FromUserName(发送方帐 号,OPEN_ID);

CreateTime(消息的创建时间);

MsgType(消息类型);

MsgId(消息ID);

我们把这些封装成一个基类,然后 不同的部分,分别封装为各自的类,这样提高代码的重用性。

这个请求消息的基类BaseMessage ,主要是封装了一些共同的字段。

请求消息的基类BaseMessage

package com.wyj.wechart.message.req;
/**
 * 请求消息的基类
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:30:00
 */
public class BaseMessage {
    

    // 开发者微信号
    private String ToUserName;

    // 发送方帐号(一个OpenID)
    private String FromUserName;

    // 消息创建时间 (整型)
    private long CreateTime;

    // 消息类型(text/image/location/link)
    private String MsgType;

    // 消息id,64位整型
    private long MsgId;

    public String getToUserName() {
        return ToUserName;
    }

    public void setToUserName(String toUserName) {
        ToUserName = toUserName;
    }

    public String getFromUserName() {
        return FromUserName;
    }

    public void setFromUserName(String fromUserName) {
        FromUserName = fromUserName;
    }

    public long getCreateTime() {
        return CreateTime;
    }

    public void setCreateTime(long createTime) {
        CreateTime = createTime;
    }

    public String getMsgType() {
        return MsgType;
    }

    public void setMsgType(String msgType) {
        MsgType = msgType;
    }

    public long getMsgId() {
        return MsgId;
    }

    public void setMsgId(long msgId) {
        MsgId = msgId;
    }
}

1.文本消息类Content ,主要是文本消息内容:

package com.wyj.wechart.message.req;
/**
 * 请求消息之文本消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:31:49
 */
public class TextMessage extends BaseMessage{
    
    // 消息内容
    private String Content;

    public String getContent() {
        return Content;
    }

    public void setContent(String content) {
        Content = content;
    }
}

2.图片消息:

package com.wyj.wechart.message.req;
/**
 * 请求消息之图片消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:40:47
 */
public class ImageMessage extends BaseMessage {
    

    // 图片链接
    private String PicUrl;

    //图片消息媒体id,可以调用多媒体文件下载接口拉取数据。
    private String MediaId;

    public String getPicUrl() {
        return PicUrl;
    }

    public void setPicUrl(String picUrl) {
        PicUrl = picUrl;
    }

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }

}

3.语音消息:

package com.wyj.wechart.message.req;
/**
 * 请求消息之语音消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:41:45
 */
public class VoiceMessage extends BaseMessage {
    

    // 语音消息媒体id,可以调用多媒体文件下载接口拉取数据。
    private String MediaId;

    //  语音格式,如amr,speex等
    private String Format;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }

    public String getFormat() {
        return Format;
    }

    public void setFormat(String format) {
        Format = format;
    }
}

4.视频消息:

package com.wyj.wechart.message.req;

/**
 * 请求消息之视频消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:43:10
 */
public class VideoMessage extends BaseMessage {
    

    // 视频消息媒体id,可以调用多媒体文件下载接口拉取数据。
    private String MediaId;

    // 视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。
    private String ThumbMediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }

    public String getThumbMediaId() {
        return ThumbMediaId;
    }

    public void setThumbMediaId(String thumbMediaId) {
        ThumbMediaId = thumbMediaId;
    }
}

5.地理位置消息:

package com.wyj.wechart.message.req;

/**
 * 请求消息之地理位置消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:44:56
 */
public class LocationMessage extends BaseMessage {
    

    // 地理位置维度
    private String Location_X;

    // 地理位置经度
    private String Location_Y;

    // 地图缩放大小
    private String Scale;

    // 地理位置信息
    private String Label;

    public String getLocation_X() {
        return Location_X;
    }

    public void setLocation_X(String location_X) {
        Location_X = location_X;
    }

    public String getLocation_Y() {
        return Location_Y;
    }

    public void setLocation_Y(String location_Y) {
        Location_Y = location_Y;
    }

    public String getScale() {
        return Scale;
    }

    public void setScale(String scale) {
        Scale = scale;
    }

    public String getLabel() {
        return Label;
    }

    public void setLabel(String label) {
        Label = label;
    }
}

6.链接消息:

package com.wyj.wechart.message.req;

/**
 * 请求消息之链接消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:45:29
 */
public class LinkMessage extends BaseMessage {
    

    // 消息标题
    private String Title;

    // 消息描述
    private String Description;

    // 消息链接
    private String Url;

    public String getTitle() {
        return Title;
    }

    public void setTitle(String title) {
        Title = title;
    }

    public String getDescription() {
        return Description;
    }

    public void setDescription(String description) {
        Description = description;
    }

    public String getUrl() {
        return Url;
    }

    public void setUrl(String url) {
        Url = url;
    }
}

二:封装事件

这里写图片描述
在微信用户和公众号产生交互的过程中,用户的某些操作会使得微信服务器通过事件推送的形式通知到开发者在开发者中心处设置的服务器地址,从而开发者可以获取到该信息。其中,某些事件推送在发生后,是允许开发者回复用户的,某些则不允许,详细内容如下:
查看官网详细介绍

关注/取消关注事件

用户在关注与取消关注公众号时,微信会把这个事件推送到开发者填写的URL。方便开发者给用户下发欢迎消息或者做帐号的解绑。 

微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次 

关于重试的消息排重,推荐使用FromUserName + CreateTime 排重。 

假如服务器无法保证在五秒内处理并回复,可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。 

推送XML数据包示例: 
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
</xml>

参数说明: 

参数          描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,subscribe(订阅)、unsubscribe(取消订阅)  

扫描带参数二维码事件

用户扫描带场景值二维码时,可能推送以下两种事件: 
1. 如果用户还未关注公众号,则用户可以关注公众号,关注后微信会将带场景值关注事件推送给开发者。 
2. 如果用户已经关注公众号,则微信会将带场景值扫描事件推送给开发者。 

1. 用户未关注时,进行关注后的事件推送 

推送XML数据包示例: 
<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[qrscene_123123]]></EventKey>
<Ticket><![CDATA[TICKET]]></Ticket>
</xml>

参数说明: 

参数          描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,subscribe  
EventKey    事件KEY值,qrscene_为前缀,后面为二维码的参数值  
Ticket      二维码的ticket,可用来换取二维码图片  

2. 用户已关注时的事件推送 

推送XML数据包示例: 
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[SCENE_VALUE]]></EventKey>
<Ticket><![CDATA[TICKET]]></Ticket>
</xml>

参数说明: 

参数          描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,SCAN  
EventKey    事件KEY值,是一个32位无符号整数,即创建二维码时的二维码scene_id  
Ticket      二维码的ticket,可用来换取二维码图片  

上报地理位置事件

用户同意上报地理位置后,每次进入公众号会话时,都会在进入时上报地理位置,或在进入会话后每5秒上报一次地理位置,公众号可以在公众平台网站中修改以上设置。上报地理位置时,微信会将上报地理位置事件推送到开发者填写的URL。 

推送XML数据包示例: 
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[LOCATION]]></Event>
<Latitude>23.137466</Latitude>
<Longitude>113.352425</Longitude>
<Precision>119.385040</Precision>
</xml>


参数说明: 


参数          描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,LOCATION  
Latitude    地理位置纬度  
Longitude   地理位置经度  
Precision   地理位置精度  

自定义菜单事件

用户点击自定义菜单后,微信会把点击事件推送给开发者,请注意,点击菜单弹出子菜单,不会产生上报。 

 点击菜单拉取消息时的事件推送 

推送XML数据包示例: 
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

参数说明: 

参数      描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,CLICK  
EventKey    事件KEY值,与自定义菜单接口中KEY值对应  


 点击菜单跳转链接时的事件推送 

推送XML数据包示例: 
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[VIEW]]></Event>
<EventKey><![CDATA[www.qq.com]]></EventKey>
</xml>

参数说明: 

参数          描述 

ToUserName      开发者微信号  
FromUserName    发送方帐号(一个OpenID)  
CreateTime      消息创建时间 (整型)  
MsgType     消息类型,event  
Event       事件类型,VIEW  
EventKey    事件KEY值,设置的跳转URL

其中用户可以向微信服务器发送的消息类型大概可以分为:文本消息,图片消息,语音消息,视频消息,小视频消息,地理位置消息,链接消息。

根据观察可以知道这些消息中,都会传回来这些公共的字段如:

ToUserName(开发者微信号);

FromUserName(发送方帐 号,OPEN_ID);

CreateTime(消息的创建时间);

MsgType(消息类型);

MsgId(消息ID);

我们把这些封装成一个基类,然后 不同的部分,分别封装为各自的类,这样提高代码的重用性。

事件的基类BaseEvent

package com.wyj.wechart.message.event;

/**
 * 事件基类
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:35:47
 */
public class BaseEvent {
    

    // 开发者微信号
    private String ToUserName;

    // 发送方帐号(一个OpenID)
    private String FromUserName;

    // 消息创建时间 (整型)
    private long CreateTime;

    // 消息类型
    private String MsgType;

    // 事件类型
    private String Event;

    public String getToUserName() {
        return ToUserName;
    }

    public void setToUserName(String toUserName) {
        ToUserName = toUserName;
    }

    public String getFromUserName() {
        return FromUserName;
    }

    public void setFromUserName(String fromUserName) {
        FromUserName = fromUserName;
    }

    public long getCreateTime() {
        return CreateTime;
    }

    public void setCreateTime(long createTime) {
        CreateTime = createTime;
    }

    public String getMsgType() {
        return MsgType;
    }

    public void setMsgType(String msgType) {
        MsgType = msgType;
    }

    public String getEvent() {
        return Event;
    }

    public void setEvent(String event) {
        Event = event;
    }
}

1.关注/取消关注事件

package com.wyj.wechart.message.event;
/**
 * 关注/取消关注事件
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:36:48
 */
public class SubscribeEvent extends BaseEvent{
    

}

2.扫描带参数二维码事件

package com.wyj.wechart.message.event;
/**
 * 扫描带参数二维码事件
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:37:41
 */
public class QRCodeEvent extends BaseEvent{
    

    // 事件KEY值
    private String EventKey;

    // 用于换取二维码图片
    private String Ticket;

    public String getEventKey() {
        return EventKey;
    }

    public void setEventKey(String eventKey) {
        EventKey = eventKey;
    }

    public String getTicket() {
        return Ticket;
    }

    public void setTicket(String ticket) {
        Ticket = ticket;
    }
}

3.上报地理位置事件

package com.wyj.wechart.message.event;
/**
 * 上报地理位置事件
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:38:36
 */
public class LocationEvent extends BaseEvent{
    

    // 地理位置纬度
    private String Latitude;

    // 地理位置经度
    private String Longitude;

    // 地理位置精度
    private String Precision;

    public String getLatitude() {
        return Latitude;
    }

    public void setLatitude(String latitude) {
        Latitude = latitude;
    }

    public String getLongitude() {
        return Longitude;
    }

    public void setLongitude(String longitude) {
        Longitude = longitude;
    }

    public String getPrecision() {
        return Precision;
    }

    public void setPrecision(String precision) {
        Precision = precision;
    }
}

4.自定义菜单事件

package com.wyj.wechart.message.event;

/**
 * 自定义菜单事件
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:39:34
 */
public class MenuEvent extends BaseEvent {
    

    // 事件KEY值,与自定义菜单接口中KEY值对应
    private String EventKey;

    public String getEventKey() {
        return EventKey;
    }

    public void setEventKey(String eventKey) {
        EventKey = eventKey;
    }
}

三:封装响应消息

这里写图片描述
当用户发送消息给公众号时(或某些特定的用户操作引发的事件推送时),会产生一个POST请求,开发者可以在响应包(Get)中返回特定XML结构,来对该消息进行响应(现支持回复文本、图片、图文、语音、视频、音乐)。严格来说,发送被动响应消息其实并不是一种接口,而是对微信服务器发过来消息的一次回复。
各消息类型需要的XML数据包结构如下:
查看官网详细介绍

回复文本消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[你好]]></Content>
</xml>

参数      是否必须        描述
ToUserName      是           接收方帐号(收到的OpenID)
FromUserName    是           开发者微信号
CreateTime      是           消息创建时间 (整型)
MsgType         是           text
Content         是           回复的消息内容(换行:在content中能够换行,微信客户端就支持换行显示)

回复图片消息

<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。


回复语音消息

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

参数      是否必须        说明
ToUserName      是           接收方帐号(收到的OpenID)
FromUserName    是           开发者微信号
CreateTime      是           消息创建时间戳 (整型)
MsgType         是           语音,voice
MediaId         是           通过素材管理接口上传多媒体文件,得到的id


回复视频消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<Video>
<MediaId><![CDATA[media_id]]></MediaId>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
</Video> 
</xml>

参数      是否必须        说明
ToUserName      是           接收方帐号(收到的OpenID)
FromUserName    是           开发者微信号
CreateTime      是           消息创建时间 (整型)
MsgType         是           video
MediaId         是           通过素材管理接口上传多媒体文件,得到的id
Title       否           视频消息的标题
Description     否           视频消息的描述

回复音乐消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
<Music>
<Title><![CDATA[TITLE]]></Title>
<Description><![CDATA[DESCRIPTION]]></Description>
<MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
<HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
<ThumbMediaId><![CDATA[media_id]]></ThumbMediaId>
</Music>
</xml>

参数      是否必须        说明
ToUserName      是           接收方帐号(收到的OpenID)
FromUserName    是           开发者微信号
CreateTime      是           消息创建时间 (整型)
MsgType         是           music
Title       否           音乐标题
Description     否           音乐描述
MusicURL        否           音乐链接
HQMusicUrl      否           高质量音乐链接,WIFI环境优先使用该链接播放音乐
ThumbMediaId    否           缩略图的媒体id,通过素材管理接口上传多媒体文件,得到的id

回复图文消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<ArticleCount>2</ArticleCount>
<Articles>
<item>
<Title><![CDATA[title1]]></Title> 
<Description><![CDATA[description1]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
<item>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
</Articles>
</xml> 

参数      是否必须        说明
ToUserName      是           接收方帐号(收到的OpenID)
FromUserName    是           开发者微信号
CreateTime      是           消息创建时间 (整型)
MsgType         是           news
ArticleCount    是           图文消息个数,限制为10条以内
Articles        是           多条图文消息信息,默认第一个item为大图,注意,如果图文数超过10,则将会无响应
Title       否           图文消息标题
Description     否           图文消息描述
PicUrl      否           图片链接,支持JPG、PNG格式,较好的效果为大图360*200,小图200*200
Url         否           点击图文消息跳转链接

同样,把消息回复中定义的所有消息都有的字段提取出来,封装成一个基类,

这些公有的字段包括:

ToUserName(接收方帐号,用户的OPEN_ID);

FromUserName(开发者的微信号);

CreateTime(消 息的创建时间);

MsgType(消息类型);

FuncFlag(消息的星标标识);

响应消息的基类BaseMessage:

package com.wyj.wechart.message.resp;

/**
 * 消息基类(公众帐号 -> 普通用户)
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:33:50
 */
public class BaseMessage {
    

    // 接收方帐号(收到的OpenID)
    private String ToUserName;

    // 开发者微信号
    private String FromUserName;

    // 消息创建时间 (整型)
    private long CreateTime;

    // 消息类型
    private String MsgType;

    public String getToUserName() {
        return ToUserName;
    }

    public void setToUserName(String toUserName) {
        ToUserName = toUserName;
    }

    public String getFromUserName() {
        return FromUserName;
    }

    public void setFromUserName(String fromUserName) {
        FromUserName = fromUserName;
    }

    public long getCreateTime() {
        return CreateTime;
    }

    public void setCreateTime(long createTime) {
        CreateTime = createTime;
    }

    public String getMsgType() {
        return MsgType;
    }

    public void setMsgType(String msgType) {
        MsgType = msgType;
    }
}

1.回复文本消息:

package com.wyj.wechart.message.resp;

/**
 * 文本消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:34:43
 */
public class TextMessage extends BaseMessage{
    

    // 回复的消息内容
    private String Content;

    public String getContent() {
        return Content;
    }

    public void setContent(String content) {
        Content = content;
    }
}

2.回复图片消息:

package com.wyj.wechart.message.resp;
/**
 *  图片
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:46:36
 */
public class Image {
    
    private String MediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }
}
package com.wyj.wechart.message.resp;
/**
 * 图片消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:51:36
 */
public class ImageMessage extends BaseMessage {
    

    private Image Image;

    public Image getImage() {
        return Image;
    }

    public void setImage(Image image) {
        Image = image;
    }
}

3.回复语音消息:

package com.wyj.wechart.message.resp;

/**
 * 语音model
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:52:02
 */
public class Voice {
    

    // 媒体文件id
    private String MediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }
}
package com.wyj.wechart.message.resp;

/**
 * 语音消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:52:49
 */
public class VoiceMessage extends BaseMessage {
    

    // 语音
    private Voice Voice;

    public Voice getVoice() {
        return Voice;
    }

    public void setVoice(Voice voice) {
        Voice = voice;
    }
}

4.回复视频消息:

package com.wyj.wechart.message.resp;

/**
 * 视频model
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:53:28
 */
public class Video {
    

    // 媒体文件id
    private String MediaId;

    // 缩略图的媒体id
    private String ThumbMediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }

    public String getThumbMediaId() {
        return ThumbMediaId;
    }

    public void setThumbMediaId(String thumbMediaId) {
        ThumbMediaId = thumbMediaId;
    }
}
package com.wyj.wechart.message.resp;

/**
 * 视频消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:54:03
 */
public class VideoMessage extends BaseMessage {
    

    // 视频
    private Video Video;

    public Video getVideo() {
        return Video;
    }

    public void setVideo(Video video) {
        Video = video;
    }
}

5.回复音乐消息:

package com.wyj.wechart.message.resp;

/**
 * 音乐model
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:54:50
 */
public class Music {
    

    // 音乐标题
    private String Title;

    // 音乐描述
    private String Description;

    // 音乐链接
    private String MusicUrl;

    // 高质量音乐链接,WIFI环境优先使用该链接播放音乐
    private String HQMusicUrl;

    // 缩略图的媒体id,通过上传多媒体文件得到的id
    private String ThumbMediaId;

    public String getTitle() {
        return Title;
    }

    public void setTitle(String title) {
        Title = title;
    }

    public String getDescription() {
        return Description;
    }

    public void setDescription(String description) {
        Description = description;
    }

    public String getMusicUrl() {
        return MusicUrl;
    }

    public void setMusicUrl(String musicUrl) {
        MusicUrl = musicUrl;
    }

    public String getHQMusicUrl() {
        return HQMusicUrl;
    }

    public void setHQMusicUrl(String musicUrl) {
        HQMusicUrl = musicUrl;
    }

    public String getThumbMediaId() {
        return ThumbMediaId;
    }

    public void setThumbMediaId(String thumbMediaId) {
        ThumbMediaId = thumbMediaId;
    }
}
package com.wyj.wechart.message.resp;

/**
 * 音乐消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:55:28
 */
public class MusicMessage extends BaseMessage {
    

    // 音乐
    private Music Music;

    public Music getMusic() {
        return Music;
    }

    public void setMusic(Music music) {
        Music = music;
    }
}

6.回复图文消息:

package com.wyj.wechart.message.resp;

/**
 * 图文model
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:55:56
 */
public class Article {
    

    // 图文消息名称
    private String Title;

    // 图文消息描述
    private String Description;

    // 图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80
    private String PicUrl;

    // 点击图文消息跳转链接
    private String Url;

    public String getTitle() {
        return Title;
    }

    public void setTitle(String title) {
        Title = title;
    }

    public String getDescription() {
        return null == Description ? "" : Description;
    }

    public void setDescription(String description) {
        Description = description;
    }

    public String getPicUrl() {
        return null == PicUrl ? "" : PicUrl;
    }

    public void setPicUrl(String picUrl) {
        PicUrl = picUrl;
    }

    public String getUrl() {
        return null == Url ? "" : Url;
    }

    public void setUrl(String url) {
        Url = url;
    }
}
package com.wyj.wechart.message.resp;

import java.util.List;

/**
 * 文本消息
 * 
 * 
 * @author:WangYuanJun
 * @date:2018年1月23日 下午1:56:32
 */
public class NewsMessage extends BaseMessage {
    

    // 图文消息个数,限制为10条以内
    private int ArticleCount;

    // 多条图文消息信息,默认第一个item为大图
    private List<Article> Articles;

    public int getArticleCount() {
        return ArticleCount;
    }

    public void setArticleCount(int articleCount) {
        ArticleCount = articleCount;
    }

    public List<Article> getArticles() {
        return Articles;
    }

    public void setArticles(List<Article> articles) {
        Articles = articles;
    }
}

这里写图片描述

注:github项目地址:微信公共号开发用例

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/wangyuanjun008/article/details/79233181

智能推荐

c# 调用c++ lib静态库_c#调用lib-程序员宅基地

文章浏览阅读2w次,点赞7次,收藏51次。四个步骤1.创建C++ Win32项目动态库dll 2.在Win32项目动态库中添加 外部依赖项 lib头文件和lib库3.导出C接口4.c#调用c++动态库开始你的表演...①创建一个空白的解决方案,在解决方案中添加 Visual C++ , Win32 项目空白解决方案的创建:添加Visual C++ , Win32 项目这......_c#调用lib

deepin/ubuntu安装苹方字体-程序员宅基地

文章浏览阅读4.6k次。苹方字体是苹果系统上的黑体,挺好看的。注重颜值的网站都会使用,例如知乎:font-family: -apple-system, BlinkMacSystemFont, Helvetica Neue, PingFang SC, Microsoft YaHei, Source Han Sans SC, Noto Sans CJK SC, W..._ubuntu pingfang

html表单常见操作汇总_html表单的处理程序有那些-程序员宅基地

文章浏览阅读159次。表单表单概述表单标签表单域按钮控件demo表单标签表单标签基本语法结构<form action="处理数据程序的url地址“ method=”get|post“ name="表单名称”></form><!--action,当提交表单时,向何处发送表单中的数据,地址可以是相对地址也可以是绝对地址--><!--method将表单中的数据传送给服务器处理,get方式直接显示在url地址中,数据可以被缓存,且长度有限制;而post方式数据隐藏传输,_html表单的处理程序有那些

PHP设置谷歌验证器(Google Authenticator)实现操作二步验证_php otp 验证器-程序员宅基地

文章浏览阅读1.2k次。使用说明:开启Google的登陆二步验证(即Google Authenticator服务)后用户登陆时需要输入额外由手机客户端生成的一次性密码。实现Google Authenticator功能需要服务器端和客户端的支持。服务器端负责密钥的生成、验证一次性密码是否正确。客户端记录密钥后生成一次性密码。下载谷歌验证类库文件放到项目合适位置(我这边放在项目Vender下面)https://github.com/PHPGangsta/GoogleAuthenticatorPHP代码示例://引入谷_php otp 验证器

【Python】matplotlib.plot画图横坐标混乱及间隔处理_matplotlib更改横轴间距-程序员宅基地

文章浏览阅读4.3k次,点赞5次,收藏11次。matplotlib.plot画图横坐标混乱及间隔处理_matplotlib更改横轴间距

docker — 容器存储_docker 保存容器-程序员宅基地

文章浏览阅读2.2k次。①Storage driver 处理各镜像层及容器层的处理细节,实现了多层数据的堆叠,为用户 提供了多层数据合并后的统一视图②所有 Storage driver 都使用可堆叠图像层和写时复制(CoW)策略③docker info 命令可查看当系统上的 storage driver主要用于测试目的,不建议用于生成环境。_docker 保存容器

随便推点

网络拓扑结构_网络拓扑csdn-程序员宅基地

文章浏览阅读834次,点赞27次,收藏13次。网络拓扑结构是指计算机网络中各组件(如计算机、服务器、打印机、路由器、交换机等设备)及其连接线路在物理布局或逻辑构型上的排列形式。这种布局不仅描述了设备间的实际物理连接方式,也决定了数据在网络中流动的路径和方式。不同的网络拓扑结构影响着网络的性能、可靠性、可扩展性及管理维护的难易程度。_网络拓扑csdn

JS重写Date函数,兼容IOS系统_date.prototype 将所有 ios-程序员宅基地

文章浏览阅读1.8k次,点赞5次,收藏8次。IOS系统Date的坑要创建一个指定时间的new Date对象时,通常的做法是:new Date("2020-09-21 11:11:00")这行代码在 PC 端和安卓端都是正常的,而在 iOS 端则会提示 Invalid Date 无效日期。在IOS年月日中间的横岗许换成斜杠,也就是new Date("2020/09/21 11:11:00")通常为了兼容IOS的这个坑,需要做一些额外的特殊处理,笔者在开发的时候经常会忘了兼容IOS系统。所以就想试着重写Date函数,一劳永逸,避免每次ne_date.prototype 将所有 ios

如何将EXCEL表导入plsql数据库中-程序员宅基地

文章浏览阅读5.3k次。方法一:用PLSQL Developer工具。 1 在PLSQL Developer的sql window里输入select * from test for update; 2 按F8执行 3 打开锁, 再按一下加号. 鼠标点到第一列的列头,使全列成选中状态,然后粘贴,最后commit提交即可。(前提..._excel导入pl/sql

Git常用命令速查手册-程序员宅基地

文章浏览阅读83次。Git常用命令速查手册1、初始化仓库git init2、将文件添加到仓库git add 文件名 # 将工作区的某个文件添加到暂存区 git add -u # 添加所有被tracked文件中被修改或删除的文件信息到暂存区,不处理untracked的文件git add -A # 添加所有被tracked文件中被修改或删除的文件信息到暂存区,包括untracked的文件...

分享119个ASP.NET源码总有一个是你想要的_千博二手车源码v2023 build 1120-程序员宅基地

文章浏览阅读202次。分享119个ASP.NET源码总有一个是你想要的_千博二手车源码v2023 build 1120

【C++缺省函数】 空类默认产生的6个类成员函数_空类默认产生哪些类成员函数-程序员宅基地

文章浏览阅读1.8k次。版权声明:转载请注明出处 http://blog.csdn.net/irean_lau。目录(?)[+]1、缺省构造函数。2、缺省拷贝构造函数。3、 缺省析构函数。4、缺省赋值运算符。5、缺省取址运算符。6、 缺省取址运算符 const。[cpp] view plain copy_空类默认产生哪些类成员函数

推荐文章

热门文章

相关标签