主題
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()
傳回該物件的字串表示法。 |
繼承方法 | |
---|---|
公用建構函式
Topic
public Topic (long mTaxonomyVersion, long mModelVersion, int mTopicId)
建立物件,代表來自 getTopics API 的結果。
參數 | |
---|---|
mTaxonomyVersion |
long :代表分類版本的 Long。 |
mModelVersion |
long :代表模型版本的 Long。 |
mTopicId |
int :代表主題專屬 ID 的整數。 |
公用方法
equals
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
public long getModelVersion ()
取得 ModelVersion。
傳回 | |
---|---|
long |
getTaxonomyVersion
public long getTaxonomyVersion ()
取得 TaxonomyVersion。
傳回 | |
---|---|
long |
hashCode
public int hashCode ()
傳回該物件的雜湊碼值。此方法支援使用雜湊資料表,例如 HashMap
提供的雜湊資料表。
hashCode
的一般約定如下:
- 在 Java 應用程式執行期間,如果多次叫用同一物件,
hashCode
方法必須持續傳回相同的整數;前提是在該物件上用於equals
比較的資訊均未經修改。在同一個應用程式兩次執行作業之間,此整數無需保持一致。 - 如果根據
equals(Object)
方法,兩個物件是相同的,則針對兩個物件呼叫hashCode
方法時,必須產生相同的整數結果。 - 如果根據
equals(java.lang.Object)
方法,兩個物件不相同,則針對兩個物件呼叫hashCode
方法時,無需產生不同的整數結果。不過,程式設計人員也應瞭解,如果為不相等的物件產生不同的整數結果,可能會改善雜湊資料表的效能。
只要合理可行,類別 Object
定義的 hashCode 方法會針對不同的物件傳回不同的整數 (在某個時間點上,hashCode 不一定會實作為物件記憶體位址的某個函式)。
傳回 | |
---|---|
int |
此物件的雜湊碼值。 |
toString
public String toString ()
傳回該物件的字串表示法。一般來說,toString
方法會傳回「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要,並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。
類別 Object
的 toString
方法會傳回一個字串,當中包含物件為例項的類別名稱、「@
」符號字元,以及物件雜湊程式碼的不帶正負號十六進位表示法。換句話說,此方法會傳回等於下列值的字串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
傳回 | |
---|---|
String |
物件的字串表示法。 |