chrome/android/java/src/org/chromium/chrome/browser/WebContentsFactory.java

// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

package org.chromium.chrome.browser;

import org.chromium.chrome.browser.profiles.Profile;
import org.chromium.content_public.browser.WebContents;

import javax.inject.Inject;

import dagger.Reusable;

/**
 * This factory creates WebContents objects and the associated native counterpart.
 * TODO(dtrainor): Move this to the content/ layer if BrowserContext is ever supported in Java.
 */
@Reusable
public class WebContentsFactory {
    @Inject
    public WebContentsFactory() {}
    /**
     * A factory method to build a {@link WebContents} object.
     * @param incognito       Whether or not the {@link WebContents} should be built with an
     *                        off-the-record profile or not.
     * @param initiallyHidden Whether or not the {@link WebContents} should be initially hidden.
     * @return                A newly created {@link WebContents} object.
     */
    // TODO(pshmakov): remove static for unit-testability.
    public static WebContents createWebContents(boolean incognito, boolean initiallyHidden) {
        return nativeCreateWebContents(
                Profile.getLastUsedProfile(), incognito, initiallyHidden, false);
    }

    /**
     * A factory method to build a {@link WebContents} object.
     *
     * Also creates and initializes the renderer.
     *
     * @param incognito       Whether or not the {@link WebContents} should be built with an
     *                        off-the-record profile or not.
     * @param initiallyHidden Whether or not the {@link WebContents} should be initially hidden.
     * @return                A newly created {@link WebContents} object.
     */
    public WebContents createWebContentsWithWarmRenderer(
            boolean incognito, boolean initiallyHidden) {
        return nativeCreateWebContents(
                Profile.getLastUsedProfile(), incognito, initiallyHidden, true);
    }

    private static native WebContents nativeCreateWebContents(Profile profile, boolean incognito,
            boolean initiallyHidden, boolean initializeRenderer);
}