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.

+   * @return AdblockEngine instance. Can be `null` if not yet retained or already released
    */
   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();
 }