EventLogRecord

public final class EventLogRecord
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.ondevicepersonalization.EventLogRecord


要記錄在「EVENTS」資料表中的資料。 EVENTS 資料表中的每筆記錄都與要求資料表 RequestLogRecord#getRows() 中現有 RequestLogRecord 的一列相關聯。「EVENTS」表格的用途是在先前要求中記錄的資料新增補充資訊,例如在點選轉譯的 WebView 中的連結時記錄事件IsolatedWorker#onEvent(EventInput, java.util.function.Consumer)。「EVENTS」資料表的內容可依據聯合學習輔助模型訓練,或是 Federated Analytics 進行跨裝置統計分析。

摘要

巢狀類別

class EventLogRecord.Builder

EventLogRecord 的建構工具

繼承常數

欄位

public static final Creator<EventLogRecord> CREATOR

公用方法

int describeContents()

描述此 Parcelable 例項封送處理表示法中包含的特殊物件種類。

boolean equals(Object o)

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

ContentValues getData()

要記錄的其他資料。

RequestLogRecord getRequestLogRecord()

此酬載應相關聯的現有 RequestLogRecord

int getRowIndex()

此酬載應與此酬載相關聯的現有 RequestLogRecord 資料列索引。

long getTimeMillis()

事件時間,以毫秒為單位。

int getType()

服務指派的 ID,用來識別這個酬載。

int hashCode()

傳回該物件的雜湊碼值。

void writeToParcel(Parcel dest, int flags)

壓平合併此物件並加入至 Parcel。

繼承方法

欄位

公用方法

describeContents

public int describeContents ()

描述此 Parcelable 執行個體管理表示法中包含的特別物件種類。舉例來說,如果物件在 writeToParcel(android.os.Parcel, int) 的輸出內容中會包含檔案描述元,此方法的傳回值就必須包含 CONTENTS_FILE_DESCRIPTOR 位元。

傳回
int 位元遮罩,表示由此 Parcelable 物件執行個體管理的特殊物件類型組合。值為 0CONTENTS_FILE_DESCRIPTOR

等於

public boolean equals (Object o)

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

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

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

Object 類別的 equals 方法實作了最大可能的物件相等關係;也就是說,對於任何非空值參照值 xy,這個方法只有在 xy 參照同一個物件 (x == y 具有 true 值) 時,才會傳回 true

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

參數
o Object:這個值可以是 null

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

getData

public ContentValues getData ()

要記錄的其他資料。如果事件中不需要寫入其他資料,且只需要記錄事件發生次數,則可以是空值。

傳回
ContentValues

取得要求記錄

public RequestLogRecord getRequestLogRecord ()

此酬載應相關聯的現有 RequestLogRecord

傳回
RequestLogRecord 這個值可以是 null

getRowIndex

public int getRowIndex ()

此酬載應與此酬載相關聯的現有 RequestLogRecord 資料列索引。

傳回
int 值等於或大於 0

getTimeMillis

public long getTimeMillis ()

事件時間,以毫秒為單位。

傳回
long

getType

public int getType ()

服務指派的 ID,用來識別這個酬載。RequestLogRecord 中的每個資料列最多可以與一個指定類型的事件建立關聯。如果 RequestLogRecord 中的資料列已有相同類型的事件,平台會捨棄事件。必須介於 1 至 128 之間。這樣最多可為 RequestLogRecord 中的每個資料列寫入 127 個事件。

傳回
int 值介於 1 到 127 (含 1 和 127) 之間

hashCode

public int hashCode ()

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

hashCode 的一般約定如下:

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

只要合理可行,由 Object 類別定義的 hashCode 方法就會為不相同的物件傳回不同的整數 (在某個時間點上,hashCode 不一定會實作為物件記憶體位址的特定函式)。

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

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

壓平合併此物件並加入至 Parcel。

參數
dest Parcel:此值不能為 null

flags int:應如何編寫物件的相關其他標記。可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。值可以是 0Parcelable.PARCELABLE_WRITE_RETURN_VALUE 的組合,以及 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES