سجلّ EventLogRecord

public final class EventLogRecord
extends Object implements Parcelable

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

البيانات المراد تسجيلها في جدول الأحداث يرتبط كل سجلّ في جدول الأحداث بصف واحد من سجلّ الأحداث RequestLogRecord في جدول الطلبات RequestLogRecord#getRows(). الغرض من جدول الأحداث هو إضافة معلومات تكميلية إلى البيانات المسجلة من طلب سابق، مثل تسجيل حدث عندما يكون رابط في WebView المعروض النقر على IsolatedWorker#onEvent(EventInput, java.util.function.Consumer). يمكن أن تكون محتويات جدول الأحداث التي تستهلكها شبكة التعلّم الموحّد التي تسهّل تدريب النموذج، أو الإحصاءات الموحّدة للتحليل الإحصائي عبر الأجهزة.

ملخّص

الصفوف المتداخلة

class EventLogRecord.Builder

أداة إنشاء EventLogRecord

الثوابت المكتسَبة

الحقول

public static final Creator<EventLogRecord> CREATOR

الطرق العامة

int describeContents()

وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم.

boolean equals(Object o)

يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.

ContentValues getData()

البيانات الإضافية التي سيتم تسجيلها

RequestLogRecord getRequestLogRecord()

قيمة RequestLogRecord الحالية التي يجب ربط هذه الحمولة بها

int getRowIndex()

فهرس الصف في قيمة RequestLogRecord الحالية التي يجب أن تكون بها هذه الحمولة المرتبطة بها.

long getTimeMillis()

وقت الحدث بالمللي ثانية.

int getType()

المعرّف المعيّن للخدمة الذي يحدّد هذه الحمولة

int hashCode()

تعرض قيمة رمز التجزئة للكائن.

void writeToParcel(Parcel dest, int flags)

عليك تسوية هذا العنصر في قطعة أرض.

الطرق المكتسبة

الحقول

الطرق العامة

وصف المحتوى

public int describeContents ()

وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم. على سبيل المثال، إذا كان الكائن تضمين واصف ملف في مخرجات writeToParcel(android.os.Parcel, int)، يجب أن تتضمن القيمة المعروضة لهذه الطريقة CONTENTS_FILE_DESCRIPTOR بت.

المرتجعات
int قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم ترتيبها من خلال مثيل الكائن القابل للقطع هذا. القيمة هي 0 أو CONTENTS_FILE_DESCRIPTOR

علامة يساوي

public boolean equals (Object o)

يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.

تنفذ طريقة equals علاقة تكافؤ على مراجع الكائنات غير الفارغة:

  • أنها انعكاسية: لأي قيمة مرجعية غير فارغة x، x.equals(x) يجب أن يعود true
  • أنه متماثل: لأي قيم مرجعية غير فارغة x وy وx.equals(y) يجب أن تعرض القيمة true فقط إذا تُرجع "y.equals(x)" القيمة true.
  • طريقة العرض متعدّدة: لأي قيم مرجعية غير فارغة x وy وz، إذا تقوم x.equals(y) بإرجاع true يتم إرجاع مبلغ true من قِبل y.equals(z)، ثم يجب أن يعرض x.equals(z) true.
  • متسقة: لأي قيم مرجعية غير فارغة x وy، استدعاءات متعددة x.equals(y) يعرض true باستمرار أو عرض false باستمرار، بشرط ألا المعلومات المستخدمة في مقارنات equals على تعديل الكائنات.
  • بالنسبة إلى أي قيمة مرجعية غير فارغة للسمة x، يجب أن تعرض x.equals(null) القيمة false.

يتم تنفيذ الطريقة equals للفئة Object علاقة التكافؤ الممكنة الأكثر تمييزًا بين الكائنات؛ أي، لأي قيم مرجعية غير فارغة x y، تعرض هذه الطريقة القيمة true إذا كانت إذا كان x وy يشيران إلى الكائن نفسه (القيمة x == y هي true).

تجدر الإشارة إلى أنّه من الضروري بوجه عام إلغاء hashCode. متى يتم إلغاء هذه الطريقة، وذلك للحفاظ على عقد عام لطريقة hashCode، والذي ينص على أن الكائنات المتساوية يجب أن تحتوي على رموز تجزئة متساوية.

المعلمات
o Object: قد تكون هذه القيمة null.
المرتجعات
boolean true إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ false بخلاف ذلك.

الحصول على البيانات

public ContentValues getData ()

البيانات الإضافية التي سيتم تسجيلها يمكن أن تكون القيمة فارغة إذا لم تكن هناك حاجة لكتابة بيانات إضافية كجزء من هذه البيانات. الحدث، ويجب تسجيل موضع ورود الحدث فقط.

المرتجعات
ContentValues

getRequestLogRecord

public RequestLogRecord getRequestLogRecord ()

قيمة RequestLogRecord الحالية التي يجب ربط هذه الحمولة بها

المرتجعات
RequestLogRecord قد تكون هذه القيمة null.

مؤشر getRowIndex

public int getRowIndex ()

فهرس الصف في قيمة RequestLogRecord الحالية التي يجب أن تكون بها هذه الحمولة المرتبطة بها.

المرتجعات
int القيمة 0 أو أكبر

الحصول على TimeMillis

public long getTimeMillis ()

وقت الحدث بالمللي ثانية.

المرتجعات
long

الحصول على نوع

public int getType ()

المعرّف المعيّن للخدمة الذي يحدّد هذه الحمولة يحتوي كل صف في ويمكن ربط RequestLogRecord بحدث واحد كحدّ أقصى من نوع محدّد. لا تسمح المنصة بالأحداث إذا كان هناك حدث آخر من النوع نفسه لأحد الصفوف. في RequestLogRecord. يجب أن تكون القيم أكبر من 0 و<128. ويسمح ذلك بإدارة ما يصل إلى 127 حدثًا لكل صف في RequestLogRecord.

المرتجعات
int تتراوح القيمة بين 1 و127 (ضمنًا)

رمز التجزئة

public int hashCode ()

تعرض قيمة رمز التجزئة للكائن. هذه الطريقة لصالح جداول التجزئة مثل تلك التي توفرها HashMap

العقد العام لشركة "hashCode" هو:

  • عندما يتم استدعاءها على الكائن نفسه أكثر من مرة أثناء هو تنفيذ تطبيق Java، الطريقة hashCode يجب أن تعرض باستمرار العدد الصحيح نفسه، بدون تقديم أي معلومات يتم تعديل استخدامها في مقارنات equals على الكائن. لا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ واحدة التطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه.
  • إذا كان هناك كائنان متساويان وفقًا لـ equals(Object) ثم استدعاء طريقة hashCode في كل من يجب أن يُنتج الكائنان نفس نتيجة العدد الصحيح.
  • ليس من الضروري أن يكون هناك كائنان غير متساويين بِحَسَبْ equals(java.lang.Object) ثم استدعاء طريقة hashCode في كل يجب أن ينتج عن كائنين نتائج أعداد صحيحة مميزة. ومع ذلك، يجب أن يكون المبرمج على علم بأنّ إنتاج نتائج أعداد صحيحة مميّزة للكائنات غير المتساوية إلى تحسين أداء جداول التجزئة.

بقدر ما يكون عمليًا بشكل معقول، تم تحديد طريقة التجزئة حسب الفئة Object يتم إرجاع أعداد صحيحة مميزة الكائنات المميزة. (قد يتم تنفيذ رمز التجزئة أو لا كدالة معينة لعنوان ذاكرة الكائن عند نقطةٍ ما في الوقت المناسب).

المرتجعات
int قيمة رمز التجزئة لهذا الكائن.

كتابة ToParcel

public void writeToParcel (Parcel dest, 
                int flags)

عليك تسوية هذا العنصر في قطعة أرض.

المعلمات
dest Parcel: لا يمكن أن تكون هذه القيمة null.
flags int: علامات إضافية حول الطريقة التي يجب كتابة العنصر بها قد تكون القيمة 0 أو Parcelable.PARCELABLE_WRITE_RETURN_VALUE. القيمة هي 0 أو مجموعة من Parcelable.PARCELABLE_WRITE_RETURN_VALUE وandroid.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES