Add better, more flexible APIs for SDK initialization.

This PR hopes to unify some of these initialization settings int o a single 'configuration' class that can be easily used to intialize parse in a much cleaner way, especially as we add even more initialization options.

Author: richardjrossiii

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

@@ -23,6 +23,7 @@
 import java.io.RandomAccessFile;
 import java.io.UnsupportedEncodingException;
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
@@ -35,6 +36,69 @@
  * library.
  */
 public class Parse {
+  public static final class Configuration {
+    public static final class Builder {
+      private Context context;
+      private String applicationId;
+      private String clientKey;
+      private boolean localDataStoreEnabled;
+      private List<ParseNetworkInterceptor> interceptors;
+
+      public Builder(Context context) {
+        this.context = context;
+      }
+
+      public Builder applicationId(String applicationId) {
+        this.applicationId = applicationId;
+        return this;
+      }
+
+      public Builder clientKey(String clientKey) {
+        this.clientKey = clientKey;
+        return this;
+      }
+
+      public Builder addNetworkInterceptor(ParseNetworkInterceptor interceptor) {
+        if (interceptors == null) {
+          interceptors = new ArrayList<>();
+        }
+        interceptors.add(interceptor);
+        return this;
+      }
+
+      public Builder enableLocalDataStore() {
+        localDataStoreEnabled = true;
+        return this;
+      }
+
+      private Builder setNetworkInterceptors(Collection<ParseNetworkInterceptor> interceptors) {
+        if (interceptors != null) {
+          interceptors.clear();
+          interceptors.addAll(interceptors);
+        }
+        return this;
+      }
+
+      public Configuration build() {
+        return new Configuration(this);
+      }
+    }
+
+    private final Context context;
+    private final String applicationId;
+    private final String clientKey;
+    private final boolean localDataStoreEnabled;
+    private final List<ParseNetworkInterceptor> interceptors;
+
+    private Configuration(Builder builder) {
+      this.context = builder.context;
+      this.applicationId = builder.applicationId;
+      this.clientKey = builder.clientKey;
+      this.localDataStoreEnabled = builder.localDataStoreEnabled;
+      this.interceptors = builder.interceptors;
+    }
+  }
+
   private static final String PARSE_APPLICATION_ID = "com.parse.APPLICATION_ID";
   private static final String PARSE_CLIENT_KEY = "com.parse.CLIENT_KEY";
 
@@ -46,6 +110,8 @@ public class Parse {
   private static boolean isLocalDatastoreEnabled;
   private static OfflineStore offlineStore;
 
+  private static Configuration configuration;
+
   /**
    * Enable pinning in your application. This must be called before your application can use
    * pinning. You must invoke {@code enableLocalDatastore(Context)} before
@@ -158,7 +224,12 @@ public static void initialize(Context context) {
     } else {
       throw new RuntimeException("Can't get Application Metadata");
     }
-    initialize(context, applicationId, clientKey);
+    initialize(new Configuration.Builder(context)
+      .applicationId(applicationId)
+      .clientKey(clientKey)
+      .setNetworkInterceptors(interceptors)
+      .build()
+    );
   }
 
   /**
@@ -188,8 +259,19 @@ public static void initialize(Context context) {
    *          The client key provided in the Parse dashboard.
    */
   public static void initialize(Context context, String applicationId, String clientKey) {
-    ParsePlugins.Android.initialize(context, applicationId, clientKey);
-    Context applicationContext = context.getApplicationContext();
+    initialize(new Configuration.Builder(context)
+        .applicationId(applicationId)
+        .clientKey(clientKey)
+        .setNetworkInterceptors(interceptors)
+        .build()
+    );
+  }
+
+  public static void initialize(Configuration configuration) {
+    Parse.configuration = configuration;
+
+    ParsePlugins.Android.initialize(configuration.context, configuration.applicationId, configuration.clientKey);
+    Context applicationContext = configuration.context.getApplicationContext();
 
     ParseHttpClient.setKeepAlive(true);
     ParseHttpClient.setMaxConnections(20);
@@ -201,9 +283,9 @@ public static void initialize(Context context, String applicationId, String clie
     ParseObject.registerParseSubclasses();
 
     if (isLocalDatastoreEnabled()) {
-      offlineStore = new OfflineStore(context);
+      offlineStore = new OfflineStore(configuration.context);
     } else {
-      ParseKeyValueCache.initialize(context);
+      ParseKeyValueCache.initialize(configuration.context);
     }
 
     // Make sure the data on disk for Parse is for the current
@@ -585,6 +667,7 @@ private Parse() {
   // Initialize all necessary http clients and add interceptors to these http clients
   private static void initializeParseHttpClientsWithParseNetworkInterceptors() {
     // This means developers have not called addInterceptor method so we should do nothing.
+    List<ParseNetworkInterceptor> interceptors = configuration.interceptors;
     if (interceptors == null) {
       return;
     }
@@ -605,9 +688,6 @@ private static void initializeParseHttpClientsWithParseNetworkInterceptors() {
         parseHttpClient.addExternalInterceptor(interceptor);
       }
     }
-
-    // Remove interceptors reference since we do not need it anymore
-    interceptors = null;
   }