MessageProxy (weixin-mp 1.5.0 API)

java.lang.Object
- cn.ipokerface.weixin.proxy.AbstractProxy
- - cn.ipokerface.weixin.mp.proxy.MPlatformProxy
  - - cn.ipokerface.weixin.mp.proxy.MessageProxy

```
public class MessageProxy
extends MPlatformProxy
```
Created by PokerFace Create Date 2019-12-28. Email: 214888341@163.com Version 1.0.0
Description:

字段概要
- 从类继承的字段 cn.ipokerface.weixin.mp.proxy.MPlatformProxy
  tokenManager
- 从类继承的字段 cn.ipokerface.weixin.proxy.AbstractProxy
  weixinRequestClient

构造器概要

构造器
构造器和说明

MessageProxy(TokenManager tokenManager)

构造器
构造器和说明
`MessageProxy(TokenManager tokenManager)`

方法概要

All Methods Instance Methods Concrete Methods 已过时的方法
限定符和类型	方法和说明
`ApiResult`	`deleteMessageNews(String msgid)` 删除群发消息
`ApiResult`	`deleteMessageNews(String msgid, int articleIndex)` 删除群发消息请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片
`String`	`getMessageNewStatus(String msgId)` 查询群发发送状态
`String[]`	`massArticleByGroupId(List<MpArticle> articles, int groupId)` 已过时。
`String[]`	`massArticleByTagId(List<MpArticle> articles, int tagId, boolean ignoreReprint)` 标签群发图文消息
`String[]`	`massToAll(MultiMessageTuple tuple)` 群发消息给所有粉丝
`String[]`	`messageArticleByOpenIds(List<MpArticle> articles, boolean ignoreReprint, String... openIds)` openid群发图文消息
`String[]`	`messageByGroupId(MultiMessageTuple tuple, boolean isToAll, int groupId)` 已过时。
`String[]`	`messageByOpenIds(MultiMessageTuple tuple, String... openIds)` openId群发消息
`String[]`	`messageByTagId(MultiMessageTuple tuple, int tagId)` 标签群发消息
`ApiResult`	`previewMessageNews(String toUser, String toWxName, MultiMessageTuple tuple)` 预览群发消息开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版
`String`	`uploadArticle(List<MpArticle> articles)` 上传图文消息,一个图文消息支持1到10条图文具备微信支付权限的公众号，在使用高级群发接口上传、群发图文消息类型时，可使用标签加入外链

从类继承的方法 cn.ipokerface.weixin.mp.proxy.MPlatformProxy
getTokenManager

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - MessageProxy
```
public MessageProxy(TokenManager tokenManager)
```
- 方法详细资料
  - uploadArticle
```
public String uploadArticle(List<MpArticle> articles)
                     throws WeixinException
```
    上传图文消息,一个图文消息支持1到10条图文具备微信支付权限的公众号，在使用高级群发接口上传、群发图文消息类型时，可使用标签加入外链
    
    参数:
    
    articles - 图片消息
    
    返回:
    
    媒体ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    上传图文素材, MpArticle
  - messageByGroupId
```
@Deprecated
public String[] messageByGroupId(MultiMessageTuple tuple,
                                             boolean isToAll,
                                             int groupId)
                                      throws WeixinException
```
    已过时。
    
    分组群发
    在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息, 如消息有时会进行审核、服务器不稳定等,此外,群发任务一般需要较长的时间才能全部发送完毕
    
    参数:
    
    tuple - 消息元件
    
    isToAll - 用于设定是否向全部用户发送，值为true或false，选择true该消息群发给所有用户，选择false可根据group_id发送给指定群组的用户
    
    groupId - 分组ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    TextMessageTuple, ImageMessageTuple, VoiceMessageTuple, MpVideoMessageTuple, MpNewsMessageTuple, CardMessageTuple, MultiMessageTuple, 根据分组群发
  - massArticleByGroupId
```
@Deprecated
public String[] massArticleByGroupId(List<MpArticle> articles,
                                                 int groupId)
                                          throws WeixinException
```
    已过时。
    
    分组ID群发图文消息
    
    参数:
    
    articles - 图文列表
    
    groupId - 分组ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现。
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据分组群发, MpArticle
  - massToAll
```
public String[] massToAll(MultiMessageTuple tuple)
                   throws WeixinException
```
    群发消息给所有粉丝
    
    参数:
    
    tuple - 消息元件
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据标签群发
  - messageByTagId
```
public String[] messageByTagId(MultiMessageTuple tuple,
                               int tagId)
                        throws WeixinException
```
    标签群发消息
    
    参数:
    
    tuple - 消息元件
    
    tagId - 标签ID
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    Tag, message(MultiMessageTuple, JSONObject), 根据标签群发
  - massArticleByTagId
```
public String[] massArticleByTagId(List<MpArticle> articles,
                                   int tagId,
                                   boolean ignoreReprint)
                            throws WeixinException
```
    标签群发图文消息
    
    参数:
    
    articles - 图文列表
    
    tagId - 标签ID
    
    ignoreReprint - 图文消息被判定为转载时，是否继续群发
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现。
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据标签群发, MpArticle
  - messageByOpenIds
```
public String[] messageByOpenIds(MultiMessageTuple tuple,
                                 String... openIds)
                          throws WeixinException
```
    openId群发消息
    
    参数:
    
    tuple - 消息元件
    
    openIds - openId列表
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据openid群发, message(MultiMessageTuple, JSONObject)
  - messageArticleByOpenIds
```
public String[] messageArticleByOpenIds(List<MpArticle> articles,
                                        boolean ignoreReprint,
                                        String... openIds)
                                 throws WeixinException
```
    openid群发图文消息
    
    参数:
    
    articles - 图文列表
    
    ignoreReprint - 图文消息被判定为转载时，是否继续群发
    
    openIds - openId列表
    
    返回:
    
    第一个元素为消息发送任务的ID,第二个元素为消息的数据ID，该字段只有在群发图文消息时，才会出现,可以用于在图文分析数据接口中.
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    根据openid群发, MpArticle
  - deleteMessageNews
```
public ApiResult deleteMessageNews(String msgid)
                            throws WeixinException
```
    删除群发消息
    
    参数:
    
    msgid - 发送出去的消息ID
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除群发, deleteMessageNews(String, int)
  - deleteMessageNews
```
public ApiResult deleteMessageNews(String msgid,
                                   int articleIndex)
                            throws WeixinException
```
    删除群发消息
    请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片
    
    参数:
    
    msgid - 发送出去的消息ID
    
    articleIndex - 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    删除群发
  - previewMessageNews
```
public ApiResult previewMessageNews(String toUser,
                                    String toWxName,
                                    MultiMessageTuple tuple)
                             throws WeixinException
```
    预览群发消息开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版
    
    参数:
    
    toUser - 接收用户的openID
    
    toWxName - 接收用户的微信号 towxname和touser同时赋值时，以towxname优先
    
    tuple - 消息元件
    
    返回:
    
    处理结果
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    MultiMessageTuple, 预览群发消息
  - getMessageNewStatus
```
public String getMessageNewStatus(String msgId)
                           throws WeixinException
```
    查询群发发送状态
    
    参数:
    
    msgId - 消息ID
    
    返回:
    
    消息发送状态,如sendsuccess:发送成功、sendfail:发送失败
    
    抛出:
    
    WeixinException
    
    另请参阅:
    
    查询群发状态

类 MessageProxy

字段概要

从类继承的字段 cn.ipokerface.weixin.mp.proxy.MPlatformProxy

从类继承的字段 cn.ipokerface.weixin.proxy.AbstractProxy

构造器概要

方法概要

从类继承的方法 cn.ipokerface.weixin.mp.proxy.MPlatformProxy

从类继承的方法 java.lang.Object

构造器详细资料

MessageProxy

方法详细资料

uploadArticle

messageByGroupId

massArticleByGroupId

massToAll

messageByTagId

massArticleByTagId

messageByOpenIds

messageArticleByOpenIds

deleteMessageNews

deleteMessageNews

previewMessageNews

getMessageNewStatus