/* * 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.ondevicepersonalization; import android.annotation.NonNull; import android.annotation.Nullable; import android.os.Parcelable; import com.android.ondevicepersonalization.internal.util.AnnotationValidations; import com.android.ondevicepersonalization.internal.util.DataClass; import java.util.List; /** * The result for one of the slots in the request from a calling app. * * @hide */ @DataClass(genBuilder = true, genEqualsHashCode = true) public final class SlotResult implements Parcelable { /** * An identifier for this slot. Will be logged in the queries table and * available for reporting. Must be a key in REMOTE_DATA. */ @NonNull private String mSlotKey = ""; /** * A list of keys in the REMOTE_DATA table that represent bids to be rendered * in this slot. */ @Nullable private List mRenderedBidKeys = null; /** * A list of bids with metrics to be logged in the QUERIES table. */ @Nullable private List mLoggedBids = null; // Code below generated by codegen v1.0.23. // // DO NOT MODIFY! // CHECKSTYLE:OFF Generated code // // To regenerate run: // $ codegen $ANDROID_BUILD_TOP/packages/modules/OnDevicePersonalization/framework/java/android/ondevicepersonalization/SlotResult.java // // To exclude the generated code from IntelliJ auto-formatting enable (one-time): // Settings > Editor > Code Style > Formatter Control //@formatter:off @DataClass.Generated.Member /* package-private */ SlotResult( @NonNull String slotKey, @Nullable List renderedBidKeys, @Nullable List loggedBids) { this.mSlotKey = slotKey; AnnotationValidations.validate( NonNull.class, null, mSlotKey); this.mRenderedBidKeys = renderedBidKeys; this.mLoggedBids = loggedBids; // onConstructed(); // You can define this method to get a callback } /** * An identifier for this slot. Will be logged in the queries table and * available for reporting. Must be a key in REMOTE_DATA. */ @DataClass.Generated.Member public @NonNull String getSlotKey() { return mSlotKey; } /** * A list of keys in the REMOTE_DATA table that represent bids to be rendered * in this slot. */ @DataClass.Generated.Member public @Nullable List getRenderedBidKeys() { return mRenderedBidKeys; } /** * A list of bids with metrics to be logged in the QUERIES table. */ @DataClass.Generated.Member public @Nullable List getLoggedBids() { return mLoggedBids; } @Override @DataClass.Generated.Member public boolean equals(@Nullable Object o) { // You can override field equality logic by defining either of the methods like: // boolean fieldNameEquals(SlotResult other) { ... } // boolean fieldNameEquals(FieldType otherValue) { ... } if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; @SuppressWarnings("unchecked") SlotResult that = (SlotResult) o; //noinspection PointlessBooleanExpression return true && java.util.Objects.equals(mSlotKey, that.mSlotKey) && java.util.Objects.equals(mRenderedBidKeys, that.mRenderedBidKeys) && java.util.Objects.equals(mLoggedBids, that.mLoggedBids); } @Override @DataClass.Generated.Member public int hashCode() { // You can override field hashCode logic by defining methods like: // int fieldNameHashCode() { ... } int _hash = 1; _hash = 31 * _hash + java.util.Objects.hashCode(mSlotKey); _hash = 31 * _hash + java.util.Objects.hashCode(mRenderedBidKeys); _hash = 31 * _hash + java.util.Objects.hashCode(mLoggedBids); return _hash; } @Override @DataClass.Generated.Member public void writeToParcel(@NonNull android.os.Parcel dest, int flags) { // You can override field parcelling by defining methods like: // void parcelFieldName(Parcel dest, int flags) { ... } byte flg = 0; if (mRenderedBidKeys != null) flg |= 0x2; if (mLoggedBids != null) flg |= 0x4; dest.writeByte(flg); dest.writeString(mSlotKey); if (mRenderedBidKeys != null) dest.writeStringList(mRenderedBidKeys); if (mLoggedBids != null) dest.writeParcelableList(mLoggedBids, flags); } @Override @DataClass.Generated.Member public int describeContents() { return 0; } /** @hide */ @SuppressWarnings({"unchecked", "RedundantCast"}) @DataClass.Generated.Member /* package-private */ SlotResult(@NonNull android.os.Parcel in) { // You can override field unparcelling by defining methods like: // static FieldType unparcelFieldName(Parcel in) { ... } byte flg = in.readByte(); String slotKey = in.readString(); List renderedBidKeys = null; if ((flg & 0x2) != 0) { renderedBidKeys = new java.util.ArrayList<>(); in.readStringList(renderedBidKeys); } List loggedBids = null; if ((flg & 0x4) != 0) { loggedBids = new java.util.ArrayList<>(); in.readParcelableList(loggedBids, Bid.class.getClassLoader()); } this.mSlotKey = slotKey; AnnotationValidations.validate( NonNull.class, null, mSlotKey); this.mRenderedBidKeys = renderedBidKeys; this.mLoggedBids = loggedBids; // onConstructed(); // You can define this method to get a callback } @DataClass.Generated.Member public static final @NonNull Parcelable.Creator CREATOR = new Parcelable.Creator() { @Override public SlotResult[] newArray(int size) { return new SlotResult[size]; } @Override public SlotResult createFromParcel(@NonNull android.os.Parcel in) { return new SlotResult(in); } }; /** * A builder for {@link SlotResult} */ @SuppressWarnings("WeakerAccess") @DataClass.Generated.Member public static final class Builder { private @NonNull String mSlotKey; private @Nullable List mRenderedBidKeys; private @Nullable List mLoggedBids; private long mBuilderFieldsSet = 0L; public Builder() { } /** * An identifier for this slot. Will be logged in the queries table and * available for reporting. Must be a key in REMOTE_DATA. */ @DataClass.Generated.Member public @NonNull Builder setSlotKey(@NonNull String value) { checkNotUsed(); mBuilderFieldsSet |= 0x1; mSlotKey = value; return this; } /** * A list of keys in the REMOTE_DATA table that represent bids to be rendered * in this slot. */ @DataClass.Generated.Member public @NonNull Builder setRenderedBidKeys(@NonNull List value) { checkNotUsed(); mBuilderFieldsSet |= 0x2; mRenderedBidKeys = value; return this; } /** @see #setRenderedBidKeys */ @DataClass.Generated.Member public @NonNull Builder addRenderedBidKeys(@NonNull String value) { // You can refine this method's name by providing item's singular name, e.g.: // @DataClass.PluralOf("item")) mItems = ... if (mRenderedBidKeys == null) setRenderedBidKeys(new java.util.ArrayList<>()); mRenderedBidKeys.add(value); return this; } /** * A list of bids with metrics to be logged in the QUERIES table. */ @DataClass.Generated.Member public @NonNull Builder setLoggedBids(@NonNull List value) { checkNotUsed(); mBuilderFieldsSet |= 0x4; mLoggedBids = value; return this; } /** @see #setLoggedBids */ @DataClass.Generated.Member public @NonNull Builder addLoggedBids(@NonNull Bid value) { // You can refine this method's name by providing item's singular name, e.g.: // @DataClass.PluralOf("item")) mItems = ... if (mLoggedBids == null) setLoggedBids(new java.util.ArrayList<>()); mLoggedBids.add(value); return this; } /** Builds the instance. This builder should not be touched after calling this! */ public @NonNull SlotResult build() { checkNotUsed(); mBuilderFieldsSet |= 0x8; // Mark builder used if ((mBuilderFieldsSet & 0x1) == 0) { mSlotKey = ""; } if ((mBuilderFieldsSet & 0x2) == 0) { mRenderedBidKeys = null; } if ((mBuilderFieldsSet & 0x4) == 0) { mLoggedBids = null; } SlotResult o = new SlotResult( mSlotKey, mRenderedBidKeys, mLoggedBids); return o; } private void checkNotUsed() { if ((mBuilderFieldsSet & 0x8) != 0) { throw new IllegalStateException( "This Builder should not be reused. Use a new Builder instance instead"); } } } @DataClass.Generated( time = 1681847760091L, codegenVersion = "1.0.23", sourceFile = "packages/modules/OnDevicePersonalization/framework/java/android/ondevicepersonalization/SlotResult.java", inputSignatures = "private @android.annotation.NonNull java.lang.String mSlotKey\nprivate @android.annotation.Nullable java.util.List mRenderedBidKeys\nprivate @android.annotation.Nullable java.util.List mLoggedBids\nclass SlotResult extends java.lang.Object implements [android.os.Parcelable]\n@com.android.ondevicepersonalization.internal.util.DataClass(genBuilder=true, genEqualsHashCode=true)") @Deprecated private void __metadata() {} //@formatter:on // End of generated code }