增加一些注释

binarywang · binarywang · commit 7b1e41121404 · 2019-01-28T10:58:50.000+08:00
diff --git a/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/message/WxMpXmlOutNewsMessage.java b/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/message/WxMpXmlOutNewsMessage.java
@@ -1,24 +1,36 @@
 package me.chanjar.weixin.mp.bean.message;
 
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+
 import com.thoughtworks.xstream.annotations.XStreamAlias;
 import com.thoughtworks.xstream.annotations.XStreamConverter;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 import me.chanjar.weixin.common.api.WxConsts;
 import me.chanjar.weixin.common.util.xml.XStreamCDataConverter;
 
-import java.io.Serializable;
-import java.util.ArrayList;
-import java.util.List;
-
+/**
+ * 被动回复的图文消息xml.
+ * @author chanjarster
+ */
 @XStreamAlias("xml")
 @Data
 @EqualsAndHashCode(callSuper = true)
 public class WxMpXmlOutNewsMessage extends WxMpXmlOutMessage {
   private static final long serialVersionUID = -4604402850905714772L;
 
+  /**
+   * 图文消息信息.
+   * 注意，如果图文数超过限制，则将只发限制内的条数
+   */
   @XStreamAlias("Articles")
   protected final List<Item> articles = new ArrayList<>();
+  /**
+   * 图文消息个数.
+   * 当用户发送文本、图片、视频、图文、地理位置这五种消息时，开发者只能回复1条图文消息；其余场景最多可回复8条图文消息
+   */
   @XStreamAlias("ArticleCount")
   protected int articleCount;
 
@@ -36,23 +48,35 @@ public void addArticle(Item item) {
   public static class Item implements Serializable {
     private static final long serialVersionUID = -4971456355028904754L;
 
+    /**
+     * 图文消息标题.
+     */
     @XStreamAlias("Title")
     @XStreamConverter(value = XStreamCDataConverter.class)
     private String title;
 
+    /**
+     * 图文消息描述.
+     */
     @XStreamAlias("Description")
     @XStreamConverter(value = XStreamCDataConverter.class)
     private String description;
 
+    /**
+     * 图片链接.
+     * 支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
+     */
     @XStreamAlias("PicUrl")
     @XStreamConverter(value = XStreamCDataConverter.class)
     private String picUrl;
 
+    /**
+     * 点击图文消息跳转链接.
+     */
     @XStreamAlias("Url")
     @XStreamConverter(value = XStreamCDataConverter.class)
     private String url;
 
   }
 
-
 }
