広告選択の結果

public class AdSelectionOutcome
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionOutcome


このクラスは、AdSelectionManagerAdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) への入力である OutcomeReceiver のフィールドを表します。このフィールドは、AdSelectionManager#selectAds 呼び出しが成功した場合に入力されます。

AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver) から空の結果が返されることがあります。AdSelectionOutcome#hasOutcome() を使用して、インスタンスに有効な結果があるかどうかを確認します。hasOutcome()false を返す場合、#getAdSelectionId()AdSelectionOutcome#getRenderUri() の結果は無効であり、使用しないでください。

まとめ

ネストされたクラス

class AdSelectionOutcome.Builder

AdSelectionOutcome オブジェクトのビルダー。 

フィールド

public static final AdSelectionOutcome NO_OUTCOME

空の結果の AdSelectionOutcome を表します。

パブリック メソッド

boolean equals(Object o)

他のオブジェクトがこのオブジェクトと「等しい」かどうかを示します。

long getAdSelectionId()

AdSelection を識別する adSelectionId を返します。

Uri getRenderUri()

AdSelection が返す renderUri を返します。

boolean hasOutcome()

結果に結果が含まれているか、空かを返します。

int hashCode()

オブジェクトのハッシュコード値を返します。

継承されるメソッド

フィールド

結果なし

public static final AdSelectionOutcome NO_OUTCOME

空の結果の AdSelectionOutcome を表します。

パブリック メソッド

次と等しい

API レベル 34 で追加されました
public boolean equals (Object o)

他のオブジェクトがこのオブジェクトと「等しい」かどうかを示します。

equals メソッドは、null 以外のオブジェクト参照に等価関係を実装します。

  • 再帰性: null 以外の参照値 x について、x.equals(x)true を返します。
  • 対称性: null 以外の参照値 xy について、y.equals(x)true を返す場合にのみ、x.equals(y)true を返します。
  • 推移性: null 以外の参照値 xyz について、x.equals(y)true を返し、かつ y.equals(z)true を返す場合、x.equals(z)true を返します。
  • 一貫性: null 以外の参照値 xy について、オブジェクトの equals 比較に使用する情報が変更されない限り、何度 x.equals(y) を呼び出しても返される値は一貫して true か、一貫して false です。
  • null 以外の参照値 x について、x.equals(null)false を返します。

Object クラスの equals メソッドは、オブジェクトの等価関係を可能な限り識別しやすく実装します。つまり、null 以外の参照値 xy について、xy が同じオブジェクトを参照している場合にのみ、true を返します(x == y の値は true)。

なお、等しいオブジェクトは等しいハッシュコードを持たなければならないという hashCode メソッドの一般的なコントラクトを維持するよう、通常はこのメソッドがオーバーライドされるたびに hashCode メソッドをオーバーライドする必要があります。

パラメータ
o Object: 比較対象の参照オブジェクト。

戻り値
boolean このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false

getAdSelectionId

public long getAdSelectionId ()

AdSelection を識別する adSelectionId を返します。

戻り値
long この値が null になることはありません。

getRenderUri

public Uri getRenderUri ()

AdSelection が返す renderUri を返します。

戻り値
Uri この値が null になることはありません。

hasOutcome

public boolean hasOutcome ()

結果に結果が含まれているか、空かを返します。空の結果である render uris は使用しないでください。

戻り値
boolean

hashCode

API レベル 34 で追加されました
public int hashCode ()

オブジェクトのハッシュコード値を返します。このメソッドは、HashMap で実現するようなハッシュ テーブルの利点を活かすためにサポートされています。

hashCode の一般的なコントラクトは次のとおりです。

  • Java アプリの実行中に同じオブジェクトに対して複数回呼び出された場合、オブジェクトの equals 比較に使用される情報が変更されない限り、hashCode メソッドは一貫して同じ整数を返さなければなりません。この整数は、アプリのある実行から同じアプリの別の実行まで一貫している必要はありません。
  • equals(Object) メソッドから 2 つのオブジェクトが等しい場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、同じ整数の結果が生成されなければなりません。
  • equals(java.lang.Object) メソッドから 2 つのオブジェクトが等しくない場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、異なる整数の結果が生成されなければならない、ということはありません。ただし、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ テーブルのパフォーマンスが向上する可能性があることに留意すべきです。

現実的である限り、クラス Object で定義された hashCode メソッドは、異なるオブジェクトに対して異なる整数を返します(hashCode は、ある時点からオブジェクトのメモリアドレスの関数として実装されるかもしれません)。

戻り値
int このオブジェクトのハッシュコード値。