Issue 6265 - Create shared AdblockEngine instance in AdblockWebView in background

libadblockplus-android/src/org/adblockplus/libadblockplus/android/AdblockEngineProvider.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;
+
+public interface AdblockEngineProvider
+{
+  /**
+   * Register AdblockEngine client
+   * @param asynchronous If `true` engines will be created in background thread without locking of
+   *                     current thread. Use waitForReady() before getEngine() later.
+   *                     If `false` locks current thread.
+   * @return if a new instance is allocated

[sergei, 2018/01/19 13:56:41]

Is it actually required to know that a new instance is allocated?

[anton, 2018/01/22 06:17:37]

Yes, in AdblockChromium we need to know it to send new raw instance address.

+   */
+  boolean retain(boolean asynchronous);
+
+  /**
+   * Wait until everything is ready (used for `retain(true)`)
+   * Warning: locks current thread
+   */
+  void waitForReady();
+
+  /**
+   * Return AdblockEngine instance
+   * @return AdblockEngine instance. Can be `null` is not yet retained or already released

[sergei, 2018/01/19 13:56:41]

Typo in "Can be `null` is not yet retained"

[anton, 2018/01/22 06:17:37]

Acknowledged.

+   */
+  AdblockEngine getEngine();
+
+  /**
+   * Unregister AdblockEngine client
+   * @return `true` if the last instance is destroyed
+   */
+  boolean release();
+
+  /**
+   * Get registered clients count
+   * @return registered clients count
+   */
+  int getCounter();
+}