本頁面由 Cloud Translation API 翻譯而成。

已新增至 API 級別 34
Ad Services Extensions 4 也已納入

主題

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()` 傳回該物件的字串表示法。

繼承方法

來自


        
          java.lang.Object

類別

`Object`	`clone()` 建立並傳回此物件的副本。
`boolean`	`equals(Object obj)` 指出是否有其他物件「等於」這個物件。
`void`	`finalize()` 當垃圾收集判定物件沒有其他參照，垃圾收集器會呼叫該物件。
`final Class<?>`	`getClass()` 傳回此 `Object` 的執行階段類別。
`int`	`hashCode()` 傳回該物件的雜湊碼值。
`final void`	`notify()` 啟動一個在等待此物件監控器的執行緒。
`final void`	`notifyAll()` 喚醒所有等待此物件監控器的執行緒。
`String`	`toString()` 傳回該物件的字串表示法。
`final void`	`wait(long timeoutMillis, int nanos)` 讓目前的執行緒等待，直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」。
`final void`	`wait(long timeoutMillis)` 讓目前的執行緒等待，直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」。
`final void`	`wait()` 讓目前的執行緒等待，直到遭到喚醒為止。喚醒方式通常是收到「通知」或遭到「中斷」。

公用建構函式

主題

已新增至 API 級別 34
Ad Services Extensions 4 也已納入

public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

建立物件，代表來自 getTopics API 的結果。

參數
`mTaxonomyVersion`	`long`：代表分類版本的 Long。
`mModelVersion`	`long`：代表模型版本的 Long。
`mTopicId`	`int`：代表主題專屬 ID 的整數。

公用方法

等於

已在 API 級別 34 中新增。

public boolean equals (Object object)

指出是否有其他物件「等於」這個物件。

equals 方法針對非空值物件參照實作對等關係：

如果是自反關係：針對任何的非空參照值 x，x.equals(x) 應傳回 true。
如果是對稱關係：針對任何非空參照值 x 和 y，x.equals(y) 應傳回 true，前提是 y.equals(x) 必須傳回 true。
而是轉換：針對任何非空值參照值 x、y 和 z，如果 x.equals(y) 傳回 true 且 y.equals(z) 傳回 true，則 x.equals(z) 應傳回 true。
如果是一致的關係：針對任何非空參照值 x 和 y，多次叫用 x.equals(y) 會持續傳回 true 或 false，但前提是，在該物件的 equals 比較中所使用的資訊均未經過修改。
針對任何非空參照值 x，x.equals(null) 應傳回 false。

Object 類別的 equals 方法實作了最大可能的物件相等關係；也就是說，對於任何非空值參照值 x 和 y，這個方法只有在 x 和 y 參照同一個物件 (x == y 具有 true 值) 時，才會傳回 true。

請注意，通常情況下，只要覆寫這個方法，就必須覆寫 hashCode 方法，以便維持 hashCode 方法的通用協定，亦即相等的物件必須有相等的雜湊碼。

參數
`object`	`Object`：要用來比較的參照物件。

傳回
`boolean`	如果此物件與 obj 引數相同，會傳回 `true`，否則傳回 `false`。

getModelVersion

已新增至 API 級別 34
Ad Services Extensions 4 也已納入

public long getModelVersion ()

取得 ModelVersion。

傳回
`long`

getTaxonomyVersion

已新增至 API 級別 34
Ad Services Extensions 4 也已納入

public long getTaxonomyVersion ()

取得 TaxonomyVersion。

傳回
`long`

getTopicId

已新增至 API 級別 34
Ad Services Extensions 4 也已納入

public int getTopicId ()

取得主題 ID。

傳回
`int`

hashCode

已在 API 級別 34 中新增。

public int hashCode ()

傳回該物件的雜湊碼值。此方法支援使用雜湊資料表，例如 HashMap 提供的雜湊資料表。

hashCode 的一般約定如下：

在 Java 應用程式執行期間，如果多次叫用同一物件，hashCode 方法必須持續傳回相同的整數；前提是在該物件上用於 equals 比較的資訊均未經修改。在同一個應用程式兩次執行作業之間，此整數無需保持一致。
如果根據 equals(Object) 方法，兩個物件是相同的，則針對兩個物件呼叫 hashCode 方法時，必須產生相同的整數結果。
如果根據 equals(java.lang.Object) 方法，兩個物件不相同，則針對兩個物件呼叫 hashCode 方法時，無需產生不同的整數結果。不過，程式設計人員也應瞭解，如果為不相等的物件產生不同的整數結果，可能會改善雜湊資料表的效能。

只要合理可行，由 Object 類別定義的 hashCode 方法就會為不相同的物件傳回不同的整數 (在某個時間點上，hashCode 不一定會實作為物件記憶體位址的特定函式)。

傳回
`int`	此物件的雜湊碼值。

toString

已在 API 級別 34 中新增。

public String toString ()

傳回該物件的字串表示法。一般來說，toString 方法會「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要，並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。

類別 Object 的 toString 方法會傳回一個字串，當中包含由物件為執行個體的類別名稱、標誌字元「@」，以及物件雜湊程式碼的未簽署十六進位表示法。換句話說，此方法會傳回等於下列值的字串：

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

傳回
`String`	物件的字串表示法。