script-astra/Android/Sdk/sources/android-35/android/adservices/topics/GetTopicsResponse.java

/*
 * Copyright (C) 2022 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 android.adservices.topics;

import android.annotation.FlaggedApi;
import android.annotation.NonNull;

import com.android.adservices.flags.Flags;

import java.util.ArrayList;
import java.util.List;
import java.util.Objects;

/** Represent the result from the getTopics API. */
public final class GetTopicsResponse {
    /** List of Topic objects returned by getTopics API. */
    private final List<Topic> mTopics;

    /** List of EncryptedTopic objects returned by getTopics API. */
    private final List<EncryptedTopic> mEncryptedTopics;

    private GetTopicsResponse(List<Topic> topics, List<EncryptedTopic> encryptedTopics) {
        mTopics = topics;
        mEncryptedTopics = encryptedTopics;
    }

    /** Returns a {@link List} of {@link Topic} objects returned by getTopics API. */
    @NonNull
    public List<Topic> getTopics() {
        return mTopics;
    }

    /** Returns a {@link List} of {@link EncryptedTopic} objects returned by getTopics API. */
    @NonNull
    @FlaggedApi(Flags.FLAG_TOPICS_ENCRYPTION_ENABLED)
    public List<EncryptedTopic> getEncryptedTopics() {
        return mEncryptedTopics;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) {
            return true;
        }
        if (!(o instanceof GetTopicsResponse)) {
            return false;
        }
        GetTopicsResponse that = (GetTopicsResponse) o;
        return mTopics.equals(that.mTopics) && mEncryptedTopics.equals(that.mEncryptedTopics);
    }

    @Override
    public int hashCode() {
        return Objects.hash(mTopics, mEncryptedTopics);
    }

    /**
     * Builder for {@link GetTopicsResponse} objects. This class should be used in test
     * implementation as expected response from Topics API
     */
    public static final class Builder {
        private List<Topic> mTopics = new ArrayList<>();
        private List<EncryptedTopic> mEncryptedTopics = new ArrayList<>();

        /**
         * Creates a {@link Builder} for {@link GetTopicsResponse} objects.
         *
         * @param topics The list of the returned Topics.
         * @deprecated This function is deprecated.
         */
        @Deprecated
        public Builder(@NonNull List<Topic> topics) {
            mTopics = Objects.requireNonNull(topics);
        }

        /**
         * Creates a {@link Builder} for {@link GetTopicsResponse} objects.
         *
         * @param topics The list of the returned Topics.
         * @param encryptedTopics The list of encrypted Topics.
         */
        @FlaggedApi(Flags.FLAG_TOPICS_ENCRYPTION_ENABLED)
        public Builder(@NonNull List<Topic> topics, @NonNull List<EncryptedTopic> encryptedTopics) {
            mTopics = Objects.requireNonNull(topics);
            mEncryptedTopics = Objects.requireNonNull(encryptedTopics);
        }

        /**
         * Builds a {@link GetTopicsResponse} instance.
         *
         * @throws IllegalArgumentException if any of the params are null.
         */
        @NonNull
        public GetTopicsResponse build() {
            if (mTopics == null || mEncryptedTopics == null) {
                throw new IllegalArgumentException("Topics is null");
            }
            return new GetTopicsResponse(mTopics, mEncryptedTopics);
        }
    }
}