/* * 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 mTopics; /** List of EncryptedTopic objects returned by getTopics API. */ private final List mEncryptedTopics; private GetTopicsResponse(List topics, List encryptedTopics) { mTopics = topics; mEncryptedTopics = encryptedTopics; } /** Returns a {@link List} of {@link Topic} objects returned by getTopics API. */ @NonNull public List getTopics() { return mTopics; } /** Returns a {@link List} of {@link EncryptedTopic} objects returned by getTopics API. */ @NonNull @FlaggedApi(Flags.FLAG_TOPICS_ENCRYPTION_ENABLED) public List 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 mTopics = new ArrayList<>(); private List 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 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 topics, @NonNull List 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); } } }