トピック

public final class Topic
extends Object

java.lang.Object
   ↳ android.adservices.topics.Topic


getTopics API のトピックの結果を表します。

概要

パブリック コンストラクタ

Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)

getTopics API の結果を表すオブジェクトを作成します。

パブリック メソッド

boolean equals(Object object)

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

long getModelVersion()

ModelVersion を取得します。

long getTaxonomyVersion()

TaxonomyVersion を取得します。

int getTopicId()

トピック ID を取得します。

int hashCode()

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

String toString()

オブジェクトの文字列表現を返します。

継承されるメソッド

パブリック コンストラクタ

トピック

API level 34 で追加
Ad Services Extensions 4 にも追加
public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

getTopics API の結果を表すオブジェクトを作成します。

パラメータ
mTaxonomyVersion long: 分類のバージョンを表す長整数。

mModelVersion long: モデルのバージョンを表す長整数。

mTopicId int: トピックの一意の ID を表す整数。

パブリック メソッド

equals

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

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

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 メソッドをオーバーライドする必要があります。

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

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

getModelVersion

API level 34 で追加
Ad Services Extensions 4 にも追加
public long getModelVersion ()

ModelVersion を取得します。

戻り値
long

getTaxonomyVersion

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加されました。
public long getTaxonomyVersion ()

TaxonomyVersion を取得します。

戻り値
long

getTopicId

API level 34 で追加
Ad Services Extensions 4 にも追加
public int getTopicId ()

トピック ID を取得します。

戻り値
int

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 このオブジェクトのハッシュコード値。

toString

API レベル 34 で追加されました。
public String toString ()

オブジェクトの文字列表現を返します。toString メソッドは一般に、オブジェクトを「テキストで表現」した文字列を返します。結果は、簡潔でありながら情報量の多い表現になり、人が簡単に読むことができます。すべてのサブクラスでこのメソッドをオーバーライドすることをおすすめします。

クラス ObjecttoString メソッドは、オブジェクトがインスタンスになっているクラスの名前、アットマーク文字「@」、オブジェクトのハッシュコードの符号なし 16 進表現で構成される文字列を返します。つまり、このメソッドは以下の値のような文字列を返します。

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

戻り値
String オブジェクトの文字列表現。