Merge pull request square#1760 from halizton/make_cache_init_public

make the DiskLruCache's initialize() public through the Cache interface

okhttp/src/main/java/com/squareup/okhttp/Cache.java

@@ -269,6 +269,23 @@ private void abortQuietly(DiskLruCache.Editor editor) {
     }
   }
 
+  /**
+   * Initialize the cache. This will include reading the journal files from
+   * the storage and building up the necessary in-memory cache information.
+   * <p>
+   * The initialization time may vary depending on the journal file size and
+   * the current actual cache size. The application needs to be aware of calling
+   * this function during the initialization phase and preferrably in a background
+   * worker thread.
+   * <p>
+   * Note that if the application chooses to not call this method to initialize
+   * the cache. By default, the okhttp will perform lazy initialization upon the
+   * first usage of the cache.
+   */
+  public void initialize() throws IOException {
+    cache.initialize();
+  }
+
   /**
    * Closes the cache and deletes all of its stored values. This will delete
    * all files in the cache directory including files that weren't created by

okhttp/src/main/java/com/squareup/okhttp/internal/DiskLruCache.java

@@ -197,8 +197,7 @@ public void run() {
     this.executor = executor;
   }
 
-  // Visible for testing.
-  void initialize() throws IOException {
+  public synchronized void initialize() throws IOException {
     assert Thread.holdsLock(this);
 
     if (initialized) {