Add more comments

Author: Javen

src/cn/jpush/api/push/model/notification/IosNotification.java

@@ -10,6 +10,22 @@
 import com.google.gson.JsonObject;
 import com.google.gson.JsonPrimitive;
 
+/**
+ * APNs 通知类
+ * <p>
+ * 支持 APNs 默认的几个参数：
+ * <li>alert: 继承自父类 PlatformNotification 的 alert 属性；本类设置则覆盖。</li>
+ * <li>badge: 支持 setBadge(int) 方法来设置；支持 incrBadge(int) 方法来增加。</li>
+ * <li>sound: 支持 setSound(string) 方法来设置声音文件。</li>
+ * <li>content-available: 用来支持后台推送。如果该值赋值为 1，表示开启后台推送。</li>
+ * <li>extras: JSON object. 支持更多的自定义字段信息。</li>
+ * </p>
+ * <p>
+ * 需要特别留意的是，JPush SDK 会对以下几个值有特别的默认设置考虑：
+ * <li>badge: 默认为 "+1"。如果需要取消 badge 值，需要显式地调用 disableBadge().</li>
+ * <li>sound: 默认为 ""，即默认的声音提示。如果需要取消 sound 值，即不要声音，需要显式地调用 disableSound(). </li>
+ * </p>
+ */
 public class IosNotification extends PlatformNotification {
     public static final String NOTIFICATION_IOS = "ios";
 

src/cn/jpush/api/push/model/notification/PlatformNotification.java

@@ -1,5 +1,7 @@
 package cn.jpush.api.push.model.notification;
 
+import java.util.Map;
+
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -98,6 +100,7 @@ protected abstract static class Builder<T> {
         public abstract Builder<T> addExtra(String key, String value);
         public abstract Builder<T> addExtra(String key, Number value);
         public abstract Builder<T> addExtra(String key, Boolean value);
+        public abstract Builder<T> addExtras(Map<String, String> extras);
 
         public abstract T build();
     }

test/cn/jpush/api/push/remote/NotificationTest.java

@@ -11,7 +11,30 @@
 import cn.jpush.api.push.model.notification.AndroidNotification;
 import cn.jpush.api.push.model.notification.Notification;
 
+import com.google.gson.JsonObject;
+
 public class NotificationTest extends BaseRemoteTest {
+    
+    @Test
+    public void sendNotification_alert_json() throws Exception {
+        JsonObject json = new JsonObject();
+        json.addProperty("key1", "value1");
+        json.addProperty("key2", true);
+        
+        String alert = json.toString();
+        System.out.println(alert);
+        
+        PushPayload payload = PushPayload.newBuilder()
+                .setAudience(Audience.all())
+                .setPlatform(Platform.all())
+                .setNotification(Notification.newBuilder()
+                        .addPlatformNotification(AndroidNotification.newBuilder()
+                                .setAlert(alert)
+                                .setTitle("title").build()).build())
+                .build();
+        PushResult result = _client.sendPush(payload);
+        assertTrue(result.isResultOK());
+    }
 
     // --------------- Android