已添加至 API 级别 34
也包含在 Ad Services Extensions 4

AdSelectionOutcome

public class AdSelectionOutcome
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionOutcome


此类表示 OutcomeReceiver 中的一个字段,它是 AdSelectionManagerAdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) 的输入。此字段在成功调用 AdSelectionManager#selectAds 时填充。

AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver) 可能会返回空结果。使用 AdSelectionOutcome#hasOutcome() 检查实例是否具有有效结果。当 hasOutcome() 返回 false 时,#getAdSelectionId()AdSelectionOutcome#getRenderUri() 返回的结果无效,不应使用。

摘要

嵌套类

class AdSelectionOutcome.Builder

AdSelectionOutcome 对象的构建器。 

字段

public static final AdSelectionOutcome NO_OUTCOME

表示结果为空的 AdSelectionOutcome。

公共方法

boolean equals(Object o)

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

long getAdSelectionId()

返回标识 AdSelection 的 adSelectionId。

Uri getRenderUri()

返回 AdSelection 返回的 renderUri。

boolean hasOutcome()

返回结果是包含内容还是为空。

int hashCode()

返回对象的哈希码值。

继承方法

字段

NO_OUTCOME

public static final AdSelectionOutcome NO_OUTCOME

表示结果为空的 AdSelectionOutcome。

公共方法

equals

已添加至 API 级别 34
public boolean equals (Object o)

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

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,多次调用 x.equals(y) 应始终返回 true 或始终返回 false,前提是用于对象 equals 比较的信息未被修改。
  • 对于任何非 null 引用值 xx.equals(null) 应返回 false

Objectequals 方法实现了对象上最严格的等价关系;也就是说,对于任何非 null 引用值 xy,当且仅当 xy 引用同一对象(x == y 的值为 true)时,此方法才返回 true

请注意,通常在重写此方法时必须重写 hashCode 方法,以便维护 hashCode 方法的通用约定,该约定声明相等的对象必须具有相等的哈希码。

参数
o Object:用于比较的引用对象。

返回值
boolean 如果此对象与 obj 参数相同,则为 true;否则为 false

getAdSelectionId

已添加至 API 级别 34
也包含在 Ad Services Extensions 4
public long getAdSelectionId ()

返回标识 AdSelection 的 adSelectionId。

返回值
long 此值不能为 null

getRenderUri

已添加至 API 级别 34
也包含在 Ad Services Extensions 4
public Uri getRenderUri ()

返回 AdSelection 返回的 renderUri。

返回值
Uri 此值不能为 null

hasOutcome

public boolean hasOutcome ()

返回结果是包含内容还是为空。不应使用空结果的 render uris

返回值
boolean

hashCode

已添加至 API 级别 34
public int hashCode ()

返回对象的哈希码值。此方法用于哈希表(例如 HashMap)的好处。

hashCode 的通用约定是

  • 在 Java 应用的一次执行过程中,无论何时在同一对象上多次调用 hashCode 方法,它都必须始终返回相同的整数,前提是用于对象 equals 比较的信息未被修改。这个整数不必在同一应用的不同执行之间保持一致。
  • 如果根据 equals(java.lang.Object) 方法,两个对象相等,则对这两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
  • 根据 equals(java.lang.Object) 方法不相等的两个对象,要求对这两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。但是,程序员应该注意,对不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下,类 Object 定义的 hashCode 方法确实为不同的对象返回不同的整数。(hashCode 可能实现为对象在某个时间点的内存地址的某个函数,也可能不实现。)

返回值
int 此对象的哈希码值。