Topic

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

添加于 API 级别 34
public boolean equals (Object object)

指示其他某个对象是否“等于”此对象。

equals 方法在非 null 对象引用上实现等价关系。

  • 它是 自反的:对于任何非 null 引用值 xx.equals(x) 应返回 true
  • 它是 对称的:对于任何非 null 引用值 xy,当且仅当 y.equals(x) 返回 true 时,x.equals(y) 才应返回 true
  • 它是 传递的:对于任何非 null 引用值 xyz,如果 x.equals(y) 返回 truey.equals(z) 返回 true,则 x.equals(z) 应返回 true
  • 它是 一致的:对于任何非 null 引用值 xy,在对象上用于 equals 比较的信息未被修改的情况下,多次调用 x.equals(y) 应始终返回 true 或始终返回 false
  • 对于任何非 null 引用值 xx.equals(null) 应返回 false

Object 类的 equals 方法实现了对象上最严格的等价关系;也就是说,对于任何非 null 引用值 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

添加于 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 方法返回一个字符串,该字符串由对象所属的类名、at 符号字符“@”以及对象哈希码的无符号十六进制表示组成。换句话说,此方法返回一个等于以下值的字符串:

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

返回值
String 对象的字符串表示形式。