Issue 6307 - Introduce external engine created callback

libadblockplus-android/src/org/adblockplus/libadblockplus/android/SingleInstanceEngineProvider.java

 /*
  * This file is part of Adblock Plus <https://adblockplus.org/>,
  * Copyright (C) 2006-present eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
  */
 package org.adblockplus.libadblockplus.android;
 
 import org.adblockplus.libadblockplus.IsAllowedConnectionCallback;
 
 import android.content.Context;
 import android.content.SharedPreferences;
 import android.net.ConnectivityManager;
 import android.util.Log;
 
+import java.util.LinkedList;
+import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
  * Provides single instance of AdblockEngine shared between registered clients
  */
 public class SingleInstanceEngineProvider implements AdblockEngineProvider
 {
   private static final String TAG = Utils.getTag(SingleInstanceEngineProvider.class);
 
+  public interface EngineCreatedListener
+  {
+    void onAdblockEngineCreated(AdblockEngine engine);
+  }
+
+  public interface EngineDisposedListener
+  {
+    void onAdblockEngineDisposed();
+  }
+
   private Context context;
   private String basePath;
   private boolean developmentBuild;
   private String preloadedPreferenceName;
   private Map<String, Integer> urlToResourceIdMap;
   private AdblockEngine engine;
   private CountDownLatch engineCreated;
   private Long v8IsolateProviderPtr;
-  private Runnable engineCreatedCallback;
-  private Runnable engineDisposedCallback;
+  private List<EngineCreatedListener> engineCreatedListeners =
+    new LinkedList<EngineCreatedListener>();
+  private List<EngineDisposedListener> engineDisposedListeners =
+    new LinkedList<EngineDisposedListener>();

[diegocarloslima, 2018/01/26 13:04:28]

Just one minor thing, the lists could be final

 
   /*
     Simple ARC management for AdblockEngine
     Use `retain` and `release`
    */
 
   private AtomicInteger referenceCounter = new AtomicInteger(0);
 
   /**
    * Init with context
@@ skipping 25 matching lines @@
     this.urlToResourceIdMap = urlToResourceIdMap;
     return this;
   }
 
   public SingleInstanceEngineProvider useV8IsolateProvider(long ptr)
   {
     this.v8IsolateProviderPtr = ptr;
     return this;
   }
 
-  public SingleInstanceEngineProvider setEngineCreatedCallback(Runnable callback)
+  public SingleInstanceEngineProvider addEngineCreatedListener(EngineCreatedListener listener)
   {
-    this.engineCreatedCallback = callback;
+    this.engineCreatedListeners.add(listener);
     return this;
   }
 
-  public SingleInstanceEngineProvider setEngineDisposedCallback(Runnable callback)
+  public void removeEngineCreatedListener(EngineCreatedListener listener)
   {
-    this.engineDisposedCallback = callback;
+    this.engineCreatedListeners.remove(listener);
+  }
+
+  public void clearEngineCreatedListeners()
+  {
+    this.engineCreatedListeners.clear();
+  }
+
+  public SingleInstanceEngineProvider addEngineDisposedListener(EngineDisposedListener listener)
+  {
+    this.engineDisposedListeners.add(listener);
     return this;
   }
 
+  public void removeEngineDisposedListener(EngineDisposedListener listener)
+  {
+    this.engineDisposedListeners.remove(listener);
+  }
+
+  public void clearEngineDisposedListeners()
+  {
+    this.engineDisposedListeners.clear();
+  }
+
   private void createAdblock()
   {
     ConnectivityManager connectivityManager =
       (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
     IsAllowedConnectionCallback isAllowedConnectionCallback =
       new IsAllowedConnectionCallbackImpl(connectivityManager);
 
     Log.d(TAG, "Creating adblock engine ...");
 
     AdblockEngine.Builder builder = AdblockEngine
@@ skipping 18 matching lines @@
         context,
         urlToResourceIdMap,
         new AndroidWebRequestResourceWrapper.SharedPrefsStorage(preloadedSubscriptionsPrefs));
     }
 
     engine = builder.build();
 
     Log.d(TAG, "AdblockHelper engine created");
 
     // sometimes we need to init AdblockEngine instance, eg. set user settings
-    if (engineCreatedCallback != null)
+    for (EngineCreatedListener listener : engineCreatedListeners)
     {
-      engineCreatedCallback.run();
+      listener.onAdblockEngineCreated(engine);
     }
   }
 
   @Override
   public synchronized boolean retain(boolean asynchronous)
   {
     boolean firstInstance = false;
 
     if (referenceCounter.getAndIncrement() == 0)
     {
@@ skipping 79 matching lines @@
 
   private void disposeAdblock()
   {
     Log.w(TAG, "Disposing adblock engine");
 
     engine.dispose();
     engine = null;
 
     // sometimes we need to deinit something after AdblockEngine instance disposed
     // eg. release user settings
-    if (engineDisposedCallback != null)
+    for (EngineDisposedListener listener : engineDisposedListeners)
     {
-      engineDisposedCallback.run();
+      listener.onAdblockEngineDisposed();
     }
   }
 
   @Override
   public int getCounter()
   {
     return referenceCounter.get();
   }
 }