components/payments/content/android/java/src/org/chromium/components/payments/ComponentPaymentRequestImpl.java

// Copyright 2020 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.components.payments;

import androidx.annotation.Nullable;

import org.chromium.mojo.system.MojoException;
import org.chromium.payments.mojom.PaymentDetails;
import org.chromium.payments.mojom.PaymentMethodData;
import org.chromium.payments.mojom.PaymentOptions;
import org.chromium.payments.mojom.PaymentRequest;
import org.chromium.payments.mojom.PaymentRequestClient;
import org.chromium.payments.mojom.PaymentValidationErrors;

/**
 * Android implementation of the PaymentRequest service defined in
 * third_party/blink/public/mojom/payments/payment_request.mojom. This component provides the parts
 * shareable between Clank and WebLayer. The Clank specific logic lives in
 * org.chromium.chrome.browser.payments.PaymentRequestImpl.
 */
public class ComponentPaymentRequestImpl implements PaymentRequest {
    private final ComponentPaymentRequestDelegate mDelegate;
    private PaymentRequestClient mClient;

    /**
     * The delegate of {@link ComponentPaymentRequestImpl}.
     */
    public interface ComponentPaymentRequestDelegate {
        // The implementation of the same methods in {@link PaymentRequest).
        void init(PaymentMethodData[] methodData, PaymentDetails details, PaymentOptions options,
                boolean googlePayBridgeEligible);
        void show(boolean isUserGesture, boolean waitForUpdatedDetails);
        void updateWith(PaymentDetails details);
        void onPaymentDetailsNotUpdated();
        void abort();
        void complete(int result);
        void retry(PaymentValidationErrors errors);
        void hasEnrolledInstrument(boolean perMethodQuota);
        void canMakePayment();
        void close();
        void onConnectionError(MojoException e);

        /**
         * Set a weak reference to the client of this delegate.
         * @param componentPaymentRequestImpl The client of this delegate.
         */
        void setComponentPaymentRequestImpl(
                ComponentPaymentRequestImpl componentPaymentRequestImpl);

        /**
         * @return The JourneyLogger of PaymentRequestImpl.
         */
        JourneyLogger getJourneyLogger();

        /**
         * Delegate to the same method of PaymentRequestImpl.
         */
        void disconnectFromClientWithDebugMessage(String debugMessage);
    }

    /**
     * Build an instance of the PaymentRequest implementation.
     * @param delegate A delegate of the instance.
     */
    public ComponentPaymentRequestImpl(ComponentPaymentRequestDelegate delegate) {
        mDelegate = delegate;
        mDelegate.setComponentPaymentRequestImpl(this);
    }

    @Override
    public void init(PaymentRequestClient client, PaymentMethodData[] methodData,
            PaymentDetails details, PaymentOptions options, boolean googlePayBridgeEligible) {
        if (mClient != null) {
            mDelegate.getJourneyLogger().setAborted(
                    org.chromium.components.payments.AbortReason.INVALID_DATA_FROM_RENDERER);
            mDelegate.disconnectFromClientWithDebugMessage(
                    org.chromium.components.payments.ErrorStrings.ATTEMPTED_INITIALIZATION_TWICE);
            return;
        }

        if (client == null) {
            mDelegate.getJourneyLogger().setAborted(
                    org.chromium.components.payments.AbortReason.INVALID_DATA_FROM_RENDERER);
            mDelegate.disconnectFromClientWithDebugMessage(
                    org.chromium.components.payments.ErrorStrings.INVALID_STATE);
            return;
        }

        mClient = client;

        mDelegate.init(methodData, details, options, googlePayBridgeEligible);
    }

    @Override
    public void show(boolean isUserGesture, boolean waitForUpdatedDetails) {
        mDelegate.show(isUserGesture, waitForUpdatedDetails);
    }

    @Override
    public void updateWith(PaymentDetails details) {
        mDelegate.updateWith(details);
    }

    @Override
    public void onPaymentDetailsNotUpdated() {
        mDelegate.onPaymentDetailsNotUpdated();
    }

    @Override
    public void abort() {
        mDelegate.abort();
    }

    @Override
    public void complete(int result) {
        mDelegate.complete(result);
    }

    @Override
    public void retry(PaymentValidationErrors errors) {
        mDelegate.retry(errors);
    }

    @Override
    public void canMakePayment() {
        mDelegate.canMakePayment();
    }

    @Override
    public void hasEnrolledInstrument(boolean perMethodQuota) {
        mDelegate.hasEnrolledInstrument(perMethodQuota);
    }

    @Override
    public void close() {
        mDelegate.close();
    }

    @Override
    public void onConnectionError(MojoException e) {
        mDelegate.onConnectionError(e);
    }

    /**
     * Get the PaymentRequestClient. To close the client, the caller should call {@link
     * #closeClient()} instead of calling {@link PaymentRequest#close()} directly.
     * @return The client.
     */
    @Nullable
    public PaymentRequestClient getClient() {
        return mClient;
    }

    /**
     * Close the PaymentRequestClient.
     */
    public void closeClient() {
        if (mClient != null) mClient.close();
        mClient = null;
    }
}