已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

WebSourceParams

public final class WebSourceParams
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.measurement.WebSourceParams


用于存放来源注册参数的类。

摘要

嵌套类

class WebSourceParams.Builder

WebSourceParams 的构建器。 

继承的常量

字段

public static final Creator<WebSourceParams> CREATOR

Paracelable 的创建者(通过反射)。

公共方法

int describeContents()

描述此 Parcelable 中包含的特殊对象的种类。 实例的编排表示法。

boolean equals(Object o)

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

Uri getRegistrationUri()

注册 URI 的 getter。

int hashCode()

返回对象的哈希代码值。

boolean isDebugKeyAllowed()

允许/禁止调试标志的 getter。

void writeToParcel(Parcel out, int flags)

将此对象展平为 Parcel。

继承的方法

字段

CREATOR

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public static final Creator<WebSourceParams> CREATOR

Paracelable 的创建者(通过反射)。

公共方法

describeContents

API 级别 34 中引入
public int describeContents ()

描述此 Parcelable 实例的编排表示中包含的特殊对象的种类。例如,如果对象将在 writeToParcel(android.os.Parcel, int) 的输出中添加一个文件描述符,那么此方法的返回值就必须包含 CONTENTS_FILE_DESCRIPTOR 位。

返回
int 一个位掩码,表示编组的特殊对象类型集 。 值为 0CONTENTS_FILE_DESCRIPTOR

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) 时,只要没有修改对象的 equals 比较中使用的任何信息,就会一致地返回 truefalse
  • 对于任何非 null 引用值 xx.equals(null) 应返回 false

Object 类的 equals 方法可对对象实现最具辨别性的等价关系;也就是说,对于任何非 null 引用值 xy,当且仅当 xy 引用同一对象时,此方法才会返回 truex == y 时值为 true)。

请注意,一般而言,每次替换此方法时,都需要替换 hashCode 方法,以便维持 hashCode 方法的通用协定,该协定规定相等的对象必须具有相等的哈希代码。

参数
o Object:用来进行比较的参照对象。

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

getRegistrationUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public Uri getRegistrationUri ()

注册 URI 的 getter。

返回
Uri 此值不能为 null

hashCode

API 级别 34 中引入
public int hashCode ()

返回对象的哈希代码值。之所以支持此方法,是为了支持哈希表(例如由 HashMap 提供的表)。

hashCode 的通用协定如下:

  • 每当在 Java 应用执行期间在同一个对象上多次调用该方法时,只要没有修改对象的 equals 比较中使用的任何信息,hashCode 方法都必须始终返回相同的整数。在应用的不同执行之间,此整数无需保持一致。
  • 如果根据 equals(Object) 方法判断两个对象相等,则对这两个对象分别调用 hashCode 方法必须产生相同的整数结果。
  • 而如果根据 equals(java.lang.Object) 方法判断两个对象不相等,将不要求对这两个对象分别调用 hashCode 方法必须产生不同的整数结果。但是,程序员应注意,为不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的前提下,由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。(hashCode 不一定会在某个时间点作为对象内存地址的某个函数实现。)

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

isDebugKeyAllowed

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public boolean isDebugKeyAllowed ()

允许/禁止调试标志的 getter。其值为 true 表示允许解析注册响应中的调试密钥及其在所生成的报告中的新增内容。

返回
boolean

writeToParcel

API 级别 34 中引入
public void writeToParcel (Parcel out, 
                int flags)

将此对象扁平化为 Parcel。

参数
out Parcel:此值不能为 null

flags int:关于如何写入对象的其他标志。可为 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。 值为 0Parcelable.PARCELABLE_WRITE_RETURN_VALUE 和 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES 的组合