RequestLogRecord
public
final
class
RequestLogRecord
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.ondevicepersonalization.RequestLogRecord |
يحتوي على البيانات التي ستتم كتابتها في جدول REQUESTS في نهاية مكالمة إلى
IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer)
.
يتم إلحاق RequestLogRecord
واحد بجدول
REQUESTS إذا تم تقديمه كجزء من ExecuteOutput
. يمكن استخدام محتويات جدول REQUESTS من خلال تدريب النماذج الذي يسهّله التعلّم التشاركي،
أو التحليل الإحصائي على جميع الأجهزة الذي يسهّله "إحصاءات Google" التشاركية.
ملخّص
الفئات المُدمجة | |
---|---|
class |
RequestLogRecord.Builder
مطوّر تطبيقات في |
الثوابت المكتسَبة |
---|
الحقول | |
---|---|
public
static
final
Creator<RequestLogRecord> |
CREATOR
|
الطرق العامة | |
---|---|
int
|
describeContents()
يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا. |
boolean
|
equals(Object o)
يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر. |
List<ContentValues>
|
getRows()
قائمة بالصفوف التي يحتوي كلّ منها على |
long
|
getTimeMillis()
وقت الطلب بالمللي ثانية |
int
|
hashCode()
عرض قيمة رمز التجزئة للعنصر |
void
|
writeToParcel(Parcel dest, int flags)
عليك تسوية هذا العنصر في قطعة أرض. |
الطرق المكتسبة | |
---|---|
الحقول
صانع محتوى
public static final Creator<RequestLogRecord> CREATOR
الطرق العامة
describeContents
public int describeContents ()
صِف أنواع العناصر الخاصة المضمّنة في التمثيل المنظّم لهذه المثيل القابل للقطع. على سبيل المثال، إذا كان العنصر سيتضمّن
وصف ملف في ناتج writeToParcel(android.os.Parcel, int)
،
يجب أن تتضمّن القيمة المعروضة من هذه الطريقة البت
CONTENTS_FILE_DESCRIPTOR
.
المرتجعات | |
---|---|
int |
قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم تجميعها
بواسطة مثيل كائن Parcelable هذا.
القيمة هي إما 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
وy.equals(z)
تعرِضtrue
، عندئذٍ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 بخلاف ذلك. |
getRows
public List<ContentValues> getRows ()
قائمة بالصفوف التي يحتوي كلّ منها على ContentValues
المرتجعات | |
---|---|
List<ContentValues> |
لا يمكن أن تكون هذه القيمة null . |
الحصول على TimeMillis
public long getTimeMillis ()
وقت الطلب بالمللي ثانية
المرتجعات | |
---|---|
long |
hashCode
public int hashCode ()
عرض قيمة رمز التجزئة للعنصر يمكن استخدام هذه الطريقة
لصالح جداول التجزئة، مثل تلك التي يوفّرها
HashMap
.
العقد العام لـ hashCode
هو:
- عند استدعاء الأسلوب
hashCode
على العنصر نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن يعرض الأسلوبhashCode
باستمرارً عددًا صحيحًا مماثلاً، شرط عدم تعديل أي معلومات مستخدَمة في مقارناتequals
على العنصر. ولا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ لتطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه. - إذا كان الجسمان متساويين وفقًا للطريقة
equals(Object)
، يجب أن يؤدي استدعاء الطريقةhashCode
على كل من الجسمَين إلى النتيجة الصحيحة نفسها. - ليس مطلوبًا أن يؤدي استدعاء الأسلوب
hashCode
على كل من العنصرين إلى نتائج صحيحة مختلفة إذا كان العنصران غير متساويين وفقًا للأسلوبequals(java.lang.Object)
. ومع ذلك، يجب أن يكون المبرمج على عِلم بأنّ إنتاج نتائج عددية مختلفة للكائنات غير المتساوية قد يحسن أداء جداول التجزئة.
تُعرِض طريقة hashCode المحدَّدة
من خلال الفئة Object
أعدادًا صحيحة مختلفة
للعناصر المختلفة، وذلك قدر الإمكان. (قد يتم تنفيذ hashCode أو لا يتم تنفيذه
كبعض وظائف عنوان ذاكرة العنصر في وقت معيّن
).
المرتجعات | |
---|---|
int |
قيمة رمز التجزئة لهذا العنصر |
writeToParcel
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 |