Add new feature: big push duration - push slowly

Author: Javen

src/main/java/cn/jpush/api/push/model/Options.java

@@ -12,19 +12,23 @@ public class Options implements PushModel {
     private static final String OVERRIDE_MSG_ID = "override_msg_id";
     private static final String TIME_TO_LIVE = "time_to_live";
     private static final String APNS_PRODUCTION = "apns_production";
+    private static final String BIG_PUSH_DURATION = "big_push_duration";
 
     private static final long NONE_TIME_TO_LIVE = -1;
 
     private final int sendno;
     private final long overrideMsgId;
     private long timeToLive;
     private boolean apnsProduction;
+    private int bigPushDuration;	// minutes
 
-    private Options(int sendno, long overrideMsgId, long timeToLive, boolean apnsProduction) {
+    private Options(int sendno, long overrideMsgId, long timeToLive, boolean apnsProduction, 
+    		int bigPushDuration) {
         this.sendno = sendno;
         this.overrideMsgId = overrideMsgId;
         this.timeToLive = timeToLive;
         this.apnsProduction = apnsProduction;
+        this.bigPushDuration = bigPushDuration;
     }
 
     public static Builder newBuilder() {
@@ -47,6 +51,10 @@ public void setTimeToLive(long timeToLive) {
         this.timeToLive = timeToLive;
     }
 
+    public void setBigPushDuration(int bigPushDuration) {
+    	this.bigPushDuration = bigPushDuration;
+    }
+    
     public int getSendno() {
         return this.sendno;
     }
@@ -66,6 +74,10 @@ public JsonElement toJSON() {
 
         json.add(APNS_PRODUCTION, new JsonPrimitive(apnsProduction));
 
+        if (bigPushDuration > 0) {
+        	json.add(BIG_PUSH_DURATION,  new JsonPrimitive(bigPushDuration));
+        }
+        
         return json;
     }
 
@@ -74,6 +86,7 @@ public static class Builder {
         private long overrideMsgId = 0;
         private long timeToLive = NONE_TIME_TO_LIVE;
         private boolean apnsProduction = false;
+        private int bigPushDuration = 0;
 
         public Builder setSendno(int sendno) {
             this.sendno = sendno;
@@ -95,15 +108,21 @@ public Builder setApnsProduction(boolean apnsProduction) {
             return this;
         }
 
+        public Builder setBigPushDuration(int bigPushDuration) {
+        	this.bigPushDuration = bigPushDuration;
+        	return this;
+        }
+        
         public Options build() {
             Preconditions.checkArgument(sendno >= 0, "sendno should be greater than 0.");
             Preconditions.checkArgument(overrideMsgId >= 0, "override_msg_id should be greater than 0.");
             Preconditions.checkArgument(timeToLive >= NONE_TIME_TO_LIVE, "time_to_live should be greater than 0.");
+            Preconditions.checkArgument(bigPushDuration >= 0, "bigPushDuration should be greater than 0.");
             if (sendno <= 0) {
                 sendno = ServiceHelper.generateSendno();
             }
 
-            return new Options(sendno, overrideMsgId, timeToLive, apnsProduction);
+            return new Options(sendno, overrideMsgId, timeToLive, apnsProduction, bigPushDuration);
         }
     }
 

src/test/java/cn/jpush/api/push/model/OptionsTest.java

@@ -113,6 +113,19 @@ public void testApnsProduction_True() {
         assertThat(options.toJSON(), is((JsonElement) json));
     }
 
-
+    @Test
+    public void testBigPushDuration() {
+        int sendno = ServiceHelper.generateSendno();
+        Options options = Options.newBuilder()
+        		.setSendno(sendno)
+                .setBigPushDuration(10)
+                .build();
+        
+        JsonObject json = new JsonObject();
+        json.add("big_push_duration", new JsonPrimitive(11));
+        json.add("sendno", new JsonPrimitive(sendno));
+        
+        assertThat(options.toJSON(), is((JsonElement) json));
+    }
 }