public class

WebViewRenderProcessImpl

extends WebViewRenderProcess

 java.lang.Object

androidx.webkit.WebViewRenderProcess

↳androidx.webkit.internal.WebViewRenderProcessImpl

Gradle dependencies

compile group: 'androidx.webkit', name: 'webkit', version: '1.12.0-rc01'

  • groupId: androidx.webkit
  • artifactId: webkit
  • version: 1.12.0-rc01

Artifact androidx.webkit:webkit:1.12.0-rc01 it located at Google repository (https://maven.google.com/)

Androidx artifact mapping:

androidx.webkit:webkit com.android.support:webkit

Overview

Implementation of WebViewRenderProcess. This class uses the framework's or the WebView APK to implement WebViewRenderProcess functionality.

Summary

Constructors
publicWebViewRenderProcessImpl(android.webkit.WebViewRenderProcess frameworkRenderer)

publicWebViewRenderProcessImpl(org.chromium.support_lib_boundary.WebViewRendererBoundaryInterface boundaryInterface)

Methods
public static WebViewRenderProcessImplforFrameworkObject(android.webkit.WebViewRenderProcess frameworkRenderer)

Get a support library WebViewRenderProcess object that is 1:1 with the framework object.

public static WebViewRenderProcessImplforInvocationHandler(java.lang.reflect.InvocationHandler invocationHandler)

Get a support library WebViewRenderProcess object that is 1:1 with the webview object.

public abstract booleanterminate()

Cause this renderer to terminate.

from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public WebViewRenderProcessImpl(org.chromium.support_lib_boundary.WebViewRendererBoundaryInterface boundaryInterface)

public WebViewRenderProcessImpl(android.webkit.WebViewRenderProcess frameworkRenderer)

Methods

public static WebViewRenderProcessImpl forInvocationHandler(java.lang.reflect.InvocationHandler invocationHandler)

Get a support library WebViewRenderProcess object that is 1:1 with the webview object.

public static WebViewRenderProcessImpl forFrameworkObject(android.webkit.WebViewRenderProcess frameworkRenderer)

Get a support library WebViewRenderProcess object that is 1:1 with the framework object.

public abstract boolean terminate()

Cause this renderer to terminate.

Calling this on a not yet started, or an already terminated renderer will have no effect.

Terminating a renderer process may have an effect on multiple instances.

RenderProcess termination must be handled by properly overriding for every WebView that shares this renderer. If termination is not handled by all associated WebViews, then the application process will also be terminated.

This method should only be called if WebViewFeature.isFeatureSupported(String) returns true for WebViewFeature.WEB_VIEW_RENDERER_TERMINATE.

Returns:

true if it was possible to terminate this renderer, false otherwise.

Source

/*
 * Copyright 2018 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package androidx.webkit.internal;

import androidx.annotation.NonNull;
import androidx.webkit.WebViewRenderProcess;

import org.chromium.support_lib_boundary.WebViewRendererBoundaryInterface;
import org.chromium.support_lib_boundary.util.BoundaryInterfaceReflectionUtil;

import java.lang.ref.WeakReference;
import java.lang.reflect.InvocationHandler;
import java.util.WeakHashMap;
import java.util.concurrent.Callable;

/**
 * Implementation of {@link WebViewRenderProcess}.
 * This class uses the framework's {@link android.webkit.WebViewRenderProcess} or the WebView APK to
 * implement {@link WebViewRenderProcess} functionality.
 */
public class WebViewRenderProcessImpl extends WebViewRenderProcess {
    private WebViewRendererBoundaryInterface mBoundaryInterface;
    private WeakReference<android.webkit.WebViewRenderProcess> mFrameworkObject;
    private static final WeakHashMap<android.webkit.WebViewRenderProcess,
            WebViewRenderProcessImpl> sFrameworkMap = new WeakHashMap<>();

    public WebViewRenderProcessImpl(@NonNull WebViewRendererBoundaryInterface boundaryInterface) {
        mBoundaryInterface = boundaryInterface;
    }

    public WebViewRenderProcessImpl(
                @NonNull android.webkit.WebViewRenderProcess frameworkRenderer) {
        mFrameworkObject = new WeakReference<>(frameworkRenderer);
    }

    /**
     * Get a support library WebViewRenderProcess object that is 1:1 with the webview object.
     */
    public static @NonNull WebViewRenderProcessImpl forInvocationHandler(
            @NonNull InvocationHandler invocationHandler) {
        // Make a possibly temporary proxy object in order to call into WebView.
        final WebViewRendererBoundaryInterface boundaryInterface =
                BoundaryInterfaceReflectionUtil.castToSuppLibClass(
                        WebViewRendererBoundaryInterface.class,
                        invocationHandler);

        // Ask WebView to either call us back to create the wrapper object, or
        // to return a previously created wrapper object.
        return (WebViewRenderProcessImpl) boundaryInterface.getOrCreatePeer(
                new Callable<Object>() {
                    @Override
                    public Object call() {
                        return new WebViewRenderProcessImpl(boundaryInterface);
                    }
                });
    }

    /**
     * Get a support library WebViewRenderProcess object that is 1:1 with the framework object.
     */
    public static @NonNull WebViewRenderProcessImpl forFrameworkObject(
            @NonNull android.webkit.WebViewRenderProcess frameworkRenderer) {
        WebViewRenderProcessImpl renderer = sFrameworkMap.get(frameworkRenderer);
        if (renderer != null) {
            return renderer;
        }
        renderer = new WebViewRenderProcessImpl(frameworkRenderer);
        sFrameworkMap.put(frameworkRenderer, renderer);
        return renderer;
    }

    @Override
    public boolean terminate() {
        final ApiFeature.Q feature = WebViewFeatureInternal.WEB_VIEW_RENDERER_TERMINATE;
        if (feature.isSupportedByFramework()) {
            android.webkit.WebViewRenderProcess renderer = mFrameworkObject.get();
            return renderer != null && ApiHelperForQ.terminate(renderer);
        } else if (feature.isSupportedByWebView()) {
            return mBoundaryInterface.terminate();
        } else {
            throw WebViewFeatureInternal.getUnsupportedOperationException();
        }
    }
}