添加对客服消息发送（点击跳转到图文消息页面） 图文消息的支持 #67

Author: binarywang

weixin-java-common/src/main/java/me/chanjar/weixin/common/api/WxConsts.java

@@ -23,14 +23,15 @@ public class WxConsts {
   ///////////////////////
   // 主动发送消息(即客服消息)的消息类型
   ///////////////////////
-  public static final String CUSTOM_MSG_TEXT = "text";
-  public static final String CUSTOM_MSG_IMAGE = "image";
-  public static final String CUSTOM_MSG_VOICE = "voice";
-  public static final String CUSTOM_MSG_VIDEO = "video";
-  public static final String CUSTOM_MSG_MUSIC = "music";
-  public static final String CUSTOM_MSG_NEWS = "news";
-  public static final String CUSTOM_MSG_FILE = "file";
-  public static final String CUSTOM_MSG_WXCARD = "wxcard";
+  public static final String CUSTOM_MSG_TEXT = "text";//文本消息
+  public static final String CUSTOM_MSG_IMAGE = "image";//图片消息
+  public static final String CUSTOM_MSG_VOICE = "voice";//语音消息
+  public static final String CUSTOM_MSG_VIDEO = "video";//视频消息
+  public static final String CUSTOM_MSG_MUSIC = "music";//音乐消息
+  public static final String CUSTOM_MSG_NEWS = "news";//图文消息（点击跳转到外链）
+  public static final String CUSTOM_MSG_MPNEWS = "mpnews";//图文消息（点击跳转到图文消息页面）
+  public static final String CUSTOM_MSG_FILE = "file";//发送文件（CP专用）
+  public static final String CUSTOM_MSG_WXCARD = "wxcard";//卡券消息
   public static final String CUSTOM_MSG_TRANSFER_CUSTOMER_SERVICE = "transfer_customer_service";
   public static final String CUSTOM_MSG_SAFE_NO = "0";
   public static final String CUSTOM_MSG_SAFE_YES = "1";
@@ -193,7 +194,7 @@ public class WxConsts {
    * 弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息
    */
   public static final String OAUTH2_SCOPE_USER_INFO = "snsapi_userinfo";
-  
+
   /**
    * 网页应用登录授权作用域 snsapi_login
    */

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/WxMpMaterialNews.java

@@ -1,17 +1,16 @@
 package me.chanjar.weixin.mp.bean;
 
 import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder;
+import org.apache.commons.lang3.builder.ToStringBuilder;
+import org.apache.commons.lang3.builder.ToStringStyle;
 
 import java.io.Serializable;
 import java.util.ArrayList;
 import java.util.List;
 
 public class WxMpMaterialNews implements Serializable {
-
-  /**
-   * 
-   */
   private static final long serialVersionUID = -3283203652013494976L;
+
   private List<WxMpMaterialNewsArticle> articles = new ArrayList<>();
 
   public List<WxMpMaterialNewsArticle> getArticles() {
@@ -81,7 +80,6 @@ public static class WxMpMaterialNewsArticle {
 
     /**
      * 点击图文消息跳转链接
-     * @return
     */
     private String url;
 
@@ -159,14 +157,12 @@ public void setThumbUrl(String thumbUrl) {
 
     @Override
     public String toString() {
-      return "WxMpMassNewsArticle [" + "thumbMediaId=" + this.thumbMediaId + "thumbUrl=" + this.thumbUrl + ", author=" + this.author + ", title=" + this.title +
-          ", contentSourceUrl=" + this.contentSourceUrl + ", content=" + this.content + ", digest=" + this.digest +
-          ", showCoverPic=" + this.showCoverPic +", url=" + this.url + "]";
+      return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
     }
   }
 
   @Override
   public String toString() {
-    return "WxMpMaterialNews [" + "articles=" + this.articles + "]";
+    return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
   }
 }

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/custombuilder/MpNewsBuilder.java

@@ -0,0 +1,33 @@
+package me.chanjar.weixin.mp.bean.custombuilder;
+
+import me.chanjar.weixin.common.api.WxConsts;
+import me.chanjar.weixin.mp.bean.kefu.WxMpKefuMessage;
+
+/**
+ * 图文消息builder
+ * <pre>
+ * 用法:
+ * WxMpKefuMessage m = WxMpKefuMessage.NEWS().mediaId("xxxxx").toUser(...).build();
+ * </pre>
+ * @author Binary Wang
+ *
+ */
+public final class MpNewsBuilder extends BaseBuilder<MpNewsBuilder> {
+  private String mediaId;
+
+  public MpNewsBuilder() {
+    this.msgType = WxConsts.CUSTOM_MSG_MPNEWS;
+  }
+
+  public MpNewsBuilder mediaId(String mediaId) {
+    this.mediaId = mediaId;
+    return this;
+  }
+
+  @Override
+  public WxMpKefuMessage build() {
+    WxMpKefuMessage m = super.build();
+    m.setMpNewsMediaId(this.mediaId);
+    return m;
+  }
+}