Add client support for push_time

Author: natario1

Parse/src/main/java/com/parse/ParsePush.java

@@ -55,6 +55,7 @@ private static void checkArgument(boolean expression, Object errorMessage) {
       private ParseQuery<ParseInstallation> query;
       private Long expirationTime;
       private Long expirationTimeInterval;
+      private Long pushTime;
       private Boolean pushToIOS;
       private Boolean pushToAndroid;
       private JSONObject data;
@@ -96,6 +97,18 @@ public Builder expirationTimeInterval(Long expirationTimeInterval) {
         return this;
       }
 
+      public Builder pushTime(Long pushTime) {
+        if (pushTime != null) {
+          long now = System.currentTimeMillis() / 1000;
+          long twoWeeks = 60*60*24*7*2;
+          checkArgument(pushTime > now, "Scheduled push time can not be in the past");
+          checkArgument(pushTime < now + twoWeeks, "Scheduled push time can not be more than " +
+              "two weeks in the future");
+        }
+        this.pushTime = pushTime;
+        return this;
+      }
+
       public Builder pushToIOS(Boolean pushToIOS) {
         checkArgument(query == null, "Cannot set push targets (i.e. setPushToAndroid or " +
             "setPushToIOS) when pushing to a query");
@@ -151,6 +164,7 @@ public State build() {
     private final ParseQuery.State<ParseInstallation> queryState;
     private final Long expirationTime;
     private final Long expirationTimeInterval;
+    private final Long pushTime;
     private final Boolean pushToIOS;
     private final Boolean pushToAndroid;
     private final JSONObject data;
@@ -161,6 +175,7 @@ private State(Builder builder) {
       this.queryState = builder.query == null ? null : builder.query.getBuilder().build();
       this.expirationTime = builder.expirationTime;
       this.expirationTimeInterval = builder.expirationTimeInterval;
+      this.pushTime = builder.pushTime;
       this.pushToIOS = builder.pushToIOS;
       this.pushToAndroid = builder.pushToAndroid;
       // Since in builder.build() we check data is not null, we do not need to check it again here.
@@ -189,6 +204,10 @@ public Long expirationTimeInterval() {
       return expirationTimeInterval;
     }
 
+    public Long pushTime() {
+      return pushTime;
+    }
+
     public Boolean pushToIOS() {
       return pushToIOS;
     }
@@ -421,6 +440,14 @@ public void clearExpiration() {
     builder.expirationTimeInterval(null);
   }
 
+  /**
+   * Sets a UNIX epoch timestamp at which this notification should be delivered, in seconds (UTC).
+   * Scheduled time can not be in the past and must be at most two weeks in the future.
+   */
+  public void setPushTime(long time) {
+    builder.pushTime(time);
+  }
+
   /**
    * Set whether this push notification will go to iOS devices.
    * <p/>

Parse/src/main/java/com/parse/ParsePushController.java

@@ -43,6 +43,7 @@ public Task<Void> sendInBackground(ParsePush.State state, String sessionToken) {
       }
     }
     return ParseRESTPushCommand.sendPushCommand(state.queryState(), state.channelSet(), deviceType,
-        state.expirationTime(), state.expirationTimeInterval(), state.data(), sessionToken);
+        state.expirationTime(), state.expirationTimeInterval(), state.pushTime(), state.data(),
+        sessionToken);
   }
 }

Parse/src/main/java/com/parse/ParseRESTPushCommand.java

@@ -23,6 +23,7 @@
   /* package */ final static String KEY_DEVICE_TYPE = "deviceType";
   /* package */ final static String KEY_EXPIRATION_TIME = "expiration_time";
   /* package */ final static String KEY_EXPIRATION_INTERVAL = "expiration_interval";
+  /* package */ final static String KEY_PUSH_TIME = "push_time";
   /* package */ final static String KEY_DATA = "data";
 
   public ParseRESTPushCommand(
@@ -35,7 +36,7 @@ public ParseRESTPushCommand(
 
   public static ParseRESTPushCommand sendPushCommand(ParseQuery.State<ParseInstallation> query,
   Set<String> targetChannels, String targetDeviceType, Long expirationTime,
-      Long expirationInterval, JSONObject payload, String sessionToken) {
+      Long expirationInterval, Long pushTime, JSONObject payload, String sessionToken) {
     JSONObject parameters = new JSONObject();
     try {
       if (targetChannels != null) {
@@ -63,9 +64,14 @@ public static ParseRESTPushCommand sendPushCommand(ParseQuery.State<ParseInstall
         parameters.put(KEY_EXPIRATION_INTERVAL, expirationInterval);
       }
 
+      if (pushTime != null) {
+        parameters.put(KEY_PUSH_TIME, pushTime);
+      }
+
       if (payload != null) {
         parameters.put(KEY_DATA, payload);
       }
+
     } catch (JSONException e) {
       throw new RuntimeException(e);
     }