第三篇 ：微信公众平台开发实战Java版之请求消息，响应消息以及事件消息类的封装

最新推荐文章于 2024-03-06 12:07:28 发布
最新推荐文章于 2024-03-06 12:07:28 发布
阅读量1.6k 收藏 1
点赞数
分类专栏： java 微信 文章标签： 微信 java 服务器 class
java 同时被 2 个专栏收录
55 篇文章 0 订阅
订阅专栏
微信
12 篇文章 0 订阅
订阅专栏

微信服务器和第三方服务器之间究竟是通过什么方式进行对话的？

 

下面，我们先看下图：

 

其实我们可以简单的理解：

（1）首先，用户向微信服务器发送消息；

（2）微信服务器接收到用户的消息处理之后，通过开发者配置的URL和Token 来找到第三方服务器，并以XML形式向第三方服务器发送消息。

（3）第三方服务器获取这些消息之后，需要按照微信服务器传过来的XML的语言进行解析，获取到信息之后，根据用户的需求，提供服务，然后封装成XML数据，传回到微信服务器上去。

（4）微信服务器解析这些XML，并把相应的内容还回给用户。

基本就结束了一个基本的请求与相应。

 

 

一、封装请求信息

​

当普通微信用户向公众账号发消息时，微信服务器将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 ，主要是封装了一些共同的字段。

 

 

复制代码 
package com.souvc.weixin.message.req;

/**
* 类名: BaseMessage </br>
* 描述: 请求消息的基类 </br>
* 开发人员： souvc</br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.req;

/**
* 类名: TextMessage </br>
* 描述: 请求消息之文本消息 </br>
* 开发人员： souvc </br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */

public class TextMessage extends BaseMessage {

    // 消息内容
    private String Content;

    public String getContent() {
        return Content;
    }

    public void setContent(String content) {
        Content = content;
    }
}
复制代码

 

 

（2）图片消息：

PicUrl 图片链接
MediaId 图片消息媒体id，可以调用多媒体文件下载接口拉取数据。

 

 

复制代码 
package com.souvc.weixin.message.req;

/**
* 类名: ImageMessage </br>
* 描述: 请求消息之图片消息 </br>
* 开发人员： souvc </br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
public class ImageMessage extends BaseMessage {
    // 图片链接
    private String PicUrl;
    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） 语音消息：

MediaId 语音消息媒体id，可以调用多媒体文件下载接口拉取数据。
Format 语音格式，如amr，speex等

 

 

复制代码 
package com.souvc.weixin.message.req;

/**
* 类名: VoiceMessage </br>
* 描述: 请求消息之语音消息 </br>
* 开发人员： souvc </br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
public class VoiceMessage extends BaseMessage {

    // 媒体ID
    private String MediaId;
    // 语音格式
    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）视频消息：

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

 

复制代码 
package com.souvc.weixin.message.req;
/**
* 类名: VideoMessage </br>
* 描述: 请求消息之视频消息 </br>
* 开发人员： souvc </br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
public class VideoMessage  extends BaseMessage{

    // 媒体ID
    private String MediaId;
    // 语音格式
    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）小视频消息：

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

 

 

（6） 地理位置消息：

Location_X 地理位置维度
Location_Y 地理位置经度
Scale 地图缩放大小
Label 地理位置信息
复制代码 
package com.souvc.weixin.message.req;

/**
* 类名: LocationMessage </br>
* 描述: 请求消息之地理位置消息 </br>
* 开发人员：souvc</br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
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;
    }
}
复制代码

 

 

 

（7） 链接消息：

Title 消息标题
Description 消息描述
Url 消息链接

 

 

复制代码 
package com.souvc.weixin.message.req;

/**
* 类名: LinkMessage </br>
* 描述: 请求消息之链接消息 </br>
* 开发人员： souvc </br>
* 创建时间：  Sep 29, 2015 </br>
* 发布版本：V1.0  </br>
 */
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
复制代码

 

详细可以参照   官网

 

 事件基类封装

 

复制代码 
package com.souvc.weixin.message.event;

/**
* 类名: BaseEvent </br>
* 描述: 事件基类</br>
* 开发人员： souvc</br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.event;

/**
* 类名: SubscribeEvent </br>
* 描述: 关注/取消关注事件 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class SubscribeEvent extends BaseEvent {

}
复制代码

 

 

（2）扫描带参数二维码事件

 

复制代码 
package com.souvc.weixin.message.event;

/**
* 类名: QRCodeEvent </br>
* 描述: 扫描带参数二维码事件 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.event;

/**
* 类名: LocationEvent </br>
* 描述: 上报地理位置事件 </br>
* 开发人员： liuhf </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.event;

/**
* 类名: MenuEvent </br>
* 描述: 自定义菜单事件 </br>
* 开发人员： liuhf </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.resp;

/**
* 类名: BaseMessage </br>
* 描述: 消息基类（公众帐号 -> 普通用户） </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.resp;

/**
* 类名: TextMessage </br>
* 描述: 文本消息 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class TextMessage extends BaseMessage {
    // 回复的消息内容
    private String Content;

    public String getContent() {
        return Content;
    }

    public void setContent(String content) {
        Content = content;
    }
}
复制代码

 

 

 

（2）回复图片消息

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: Image </br>
* 描述: 图片 </br>
* 开发人员：souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class Image {
    
    private String MediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }
}
复制代码

 

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: ImageMessage </br>
* 描述: 图片消息</br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class ImageMessage extends BaseMessage {
    
    private Image Image;

    public Image getImage() {
        return Image;
    }

    public void setImage(Image image) {
        Image = image;
    }
}
复制代码

 

 

 

（3）回复语音消息

 

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: Voice </br>
* 描述: 语音model </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class Voice {
    // 媒体文件id
    private String MediaId;

    public String getMediaId() {
        return MediaId;
    }

    public void setMediaId(String mediaId) {
        MediaId = mediaId;
    }
}
复制代码

 

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: VoiceMessage </br>
* 描述: 语音消息</br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class VoiceMessage extends BaseMessage {
    // 语音
    private Voice Voice;

    public Voice getVoice() {
        return Voice;
    }

    public void setVoice(Voice voice) {
        Voice = voice;
    }
}
复制代码

 

 

 

（4）回复视频消息

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: Video </br>
* 描述: 视频model </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.resp;

/**
* 类名: VideoMessage </br>
* 描述: 视频消息 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class VideoMessage extends BaseMessage {
    // 视频
    private Video Video;

    public Video getVideo() {
        return Video;
    }

    public void setVideo(Video video) {
        Video = video;
    }
}
复制代码

 

 

 

（5）回复音乐消息

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: Music </br>
* 描述: 音乐model </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.resp;

/**
* 类名: MusicMessage </br>
* 描述: 音乐消息 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
public class MusicMessage extends BaseMessage {
    // 音乐
    private Music Music;

    public Music getMusic() {
        return Music;
    }

    public void setMusic(Music music) {
        Music = music;
    }
}
复制代码

 

 

（6） 回复图文消息

 

复制代码 
package com.souvc.weixin.message.resp;

/**
* 类名: Article </br>
* 描述: 图文model </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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.souvc.weixin.message.resp;

import java.util.List;

/**
* 类名: NewsMessage </br>
* 描述: 文本消息 </br>
* 开发人员： souvc </br>
* 创建时间：  2015-9-30 </br>
* 发布版本：V1.0  </br>
 */
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;
    }
}
复制代码

 

 

封装结束。

 

 

为了方便，提供一下这些类的源码：


 送上自己的公众号



---------------------------------------------------------------------------------------------------------------------------------------- 
如果您认为本教程质量不错，读后觉得收获很大，预期工资能蹭蹭蹭的往上涨，那么不妨小额赞助我一下，让我有动力继续写出高质量的教程。 
---------------------------------------------------------------------------------------------------------------------------------------- 


画心_sky
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Java微信公众平台开发（3） 接收消息的分类及实体的创建
08-30
主要为大家详细介绍了Java微信公众平台开发第三步，接收消息的分类及实体的创建，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
第三篇 ：微信公众平台开发实战Java版之请求消息，响应消息以及事件消息类的封装...
weixin_34227447的博客
09-30 200
  微信服务器和第三方服务器之间究竟是通过什么方式进行对话的？   下面，我们先看下图：   其实我们可以简单的理解： （1）首先，用户向微信服务器发送消息； （2）微信服务器接收到用户的消息处理之后，通过开发者配置的URL和Token 来找到第三方服务器，并以XML形式向第三方服务器发送消息。 （3）第三方服务器获取这些消息之后，需要按照微信服务器传过来的XML的语言进行解析...
微信第三方平台研究总结
weixin_43837305的博客
10-15 995
微信第三方平台研究总结
JAVA 微信公众号授权给开放平台（第三方平台）开发流程及第三方平台代公众号实现业务
最新发布
qq_41688060的博客
03-06 1012
微信公众号授权给第三方平 及 第三方平台代公众号实现业务
第四篇 ：微信公众平台开发实战Java版之完成消息接受与相应以及消息的处理
日落东山的基地
07-08 598
温馨提示：      这篇文章是依赖前几篇的文章的。      第一篇：微信公众平台开发实战之了解微信公众平台基础知识以及资料准备      第二篇 ：微信公众平台开发实战之开启开发者模式，接入微信公众平台开发      第三篇 ：微信公众平台开发实战之请求消息，响应消息以及事件消息类的封装
Java对接微信公众号事件监听回调
dongyan3595的博客
10-12 702
【代码】Java对接微信公众号事件监听回调。
微信公众平台 客服接口发消息的实现代码(Java接口开发)
10-17
主要介绍了微信公众平台 客服接口发消息的实现代码(Java接口开发)，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
Java微信公众平台开发（4） 回复消息的分类及实体的创建
08-30
主要为大家详细介绍了Java微信公众平台开发第四步，回复消息的分类及实体的创建，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
Java微信公众平台开发（2） 微信服务器post消息体的接收
08-30
主要为大家详细介绍了Java微信公众平台开发第二步，微信服务器post消息体的接收，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
微信公众平台开发实战Java版之微信获取用户基本信息
09-02
主要介绍了微信公众平台开发实战Java版之微信获取用户基本信息 的相关资料,需要的朋友可以参考下
微信开发学习总结（四）——自定义菜单（4）——自定义菜单事件推送
10-06
微信开发学习总结（四）——自定义菜单（4）——自定义菜单事件推送 博客地址：https://blog.csdn.net/qq_29914837/article/details/82948742
用nginx实现微信公众号相关的反向代理。
weixin_30362083的博客
07-10 1927
将原网站（微信业务）直接通过前端代理服务器（A）反向代理到后端机器(B)上会报一个 xxxx not in whitelist hint 的错误。 因为原来白名单IP为 A服务器IP,由于业务上需要修改公众号太多，于是想不修改公众号的情况下是否也可以实现。 最后经人点拨后实现了，感谢@Wendal~兽 “要么改源码，修改api url，变成a服务器的域名 要么改dns，设置为a机器的i...
Nginx 反向代理实现微信开发完美线上测试环境
weixin_34248487的博客
11-29 3348
成文时间： 2018-11-29 11:18:10 环境说明 Ubuntu 16.04 LTS Nginx version: nginx/1.10.3 (Ubuntu) PHP 7.1.18 Laravel 5.5 需求说明 微信开发类项目，需要要调试微信接口，本地开发上可以采用微信开发者工具和微信测试公众号模拟运行环境和接口。但有部分微信商户号的接口例如微信支付，目前需要用沙盒模拟...
使用Nginx和Xshell，微信本地开发不再难
小海子的博客
11-06 355
背景 最近在了解微信订阅号方面的内容，项目没开始就遇到了一个尴尬的问题。内网穿透工作怎么选。目前市面上有各种各样的内容穿透工具，比如：ngrok，natapp，花生壳、网穿云等，既有免费的也有付费的。已经足以满足微信方面的业务开发。自己也去逐个了解了一下，也发现了一些很讨厌的问题。例如： 套取个人信息；先要你的手机号，再要你的微信号，我也想不通，要我手机号干什么[吐了] 免费工具提供的域名不固定，每次断网会出现新的域名，每次都要更新微信平台的配置，太麻烦了 在之前的工作中，由于本地是无法直连服务器的，要
使用NGINX代理通过外网连接内网服务器的mysql和redis等
weixin_44734972的博客
09-14 2673
通过nginx代理访问局域网的mysql和redis欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 欢迎使用Markdown编辑器 你好！ 这是你第一次使用 Markdown编辑器 所展示的欢
项目上线，部署到服务器（腾讯服务器），http协议及https协议（微信小程序必须https协议才可发布）、Nginx配置
专研前端，探索后端
04-24 5462
项目上线，部署到服务器（腾讯服务器），http协议及https协议（微信小程序必须https协议才可发布）、Nginx配置
nginx 反向代理微信服务器
donlesshem的博客
03-28 1627
参考地址：https://www.v2ex.com/t/499238 配置如下 location ^~ /mp/ { proxy_set_header Hostmp.weixin.qq.com; rewrite /mp/(.+)$ /$1 break; proxy_passhttps://mp.weixin.qq.com; }
nginx 最简单配置微信公众号服务器方法
ljymoonlight的专栏
08-01 1349
微信开发
在微信公众平台上创建模版并获取模版 ID。 调用模版消息接口，发送模版消息。 代码如下：
02-06
要调用模板消息接口，发送模板消息，你需要使用微信公众平台的模板消息接口。这个接口需要你提供一些参数，包括： - `access_token`：你的公众号调用接口凭证。 - `touser`：接收模板消息的用户的 OpenID。 - `...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值