// Copyright 2021 The Chromium Authors
// 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.password_manager;
import static org.chromium.base.ThreadUtils.assertOnUiThread;
import android.content.Context;
import org.chromium.base.ResettersForTesting;
import org.chromium.chrome.browser.password_manager.CredentialManagerLauncher.CredentialManagerBackendException;
import org.chromium.chrome.browser.password_manager.CredentialManagerLauncher.CredentialManagerError;
/**
* This factory returns an implementation for the launcher. The factory itself is also implemented
* downstream.
*/
public abstract class CredentialManagerLauncherFactory {
private static CredentialManagerLauncherFactory sInstance;
/**
* Returns a launcher factory to be invoked whenever {@link #createLauncher()} is called. If no
* factory was used yet, it is created.
*
* @return The shared {@link CredentialManagerLauncherFactory} instance.
*/
public static CredentialManagerLauncherFactory getInstance() {
assertOnUiThread();
if (sInstance == null) sInstance = new CredentialManagerLauncherFactoryImpl();
return sInstance;
}
/**
* Returns the downstream implementation provided by subclasses.
*
* @return An implementation of the {@link CredentialManagerLauncher} if one exists.
* <p>TODO(crbug.com/40854052): Check if backend could be instantiated and throw error
*/
public CredentialManagerLauncher createLauncher() throws CredentialManagerBackendException {
return null;
}
/**
* Creates and returns new instance of the downstream implementation provided by subclasses.
*
* Downstream should override this method with actual implementation.
*
* @return An implementation of the {@link CredentialManagerLauncher} if one exists.
*/
protected CredentialManagerLauncher doCreateLauncher(Context context)
throws CredentialManagerBackendException {
throw new CredentialManagerBackendException(
"Downstream implementation is not present.",
CredentialManagerError.BACKEND_NOT_AVAILABLE);
}
public static void setFactoryForTesting(
CredentialManagerLauncherFactory credentialManagerLauncherFactory) {
var oldValue = sInstance;
sInstance = credentialManagerLauncherFactory;
ResettersForTesting.register(() -> sInstance = oldValue);
}
}