主題

public class Topic
extends Object

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


代表來自 getTopics API 的主題結果。

摘要

公用建構函式

Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)

公用方法

boolean equals(Object object)

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

long getModelVersion()

取得 ModelVersion。

long getTaxonomyVersion()

取得 TaxonomyVersion。

int getTopicId()

取得主題 ID。

int hashCode()

傳回該物件的雜湊碼值。

String toString()

傳回該物件的字串表示法。

繼承方法

公用建構函式

主題

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

參數
mTaxonomyVersion long

mModelVersion long

mTopicId int

公用方法

equals

public boolean equals (Object object)

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

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

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

類別 Objectequals 方法可對物件實作最明顯的對等關係;也就是說,針對任何非空參照值 xy,只有在 xy 參照相同的物件時 (x == y 的值為 true),此方法才會傳回 true

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

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

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

getModelVersion

public long getModelVersion ()

取得 ModelVersion。

傳回
long

getTaxonomyVersion

public long getTaxonomyVersion ()

取得 TaxonomyVersion。

傳回
long

getTopicId

public int getTopicId ()

取得主題 ID。

傳回
int

hashCode

public int hashCode ()

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

hashCode 的一般約定如下:

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

只要合理可行,類別 Object 定義的 hashCode 方法會針對不同的物件傳回不同的整數。(這通常透過將物件內部位址轉換為整數的方式進行,但 Java™ 程式設計語言不一定要採用這項實作技巧。)

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

toString

public String toString ()

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

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

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

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