TrainingExampleInput

public final class TrainingExampleInput
extends Object implements Parcelable

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

بيانات الإدخال لـ IsolatedWorker#onTrainingExample(TrainingExampleInput, Consumer)

ملخّص

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

int CONTENTS_FILE_DESCRIPTOR

بت الوصف المستخدَم مع describeContents(): يشير إلى أنّه يتضمّن التمثيل المسطّح لعنصر Parcelable وصفًا للملف.

int PARCELABLE_WRITE_RETURN_VALUE

الإبلاغ عن استخدام writeToParcel(Parcel, int): العنصر الذي يتم كتابته هو قيمة معروضة، أي نتيجة دالة مثل "Parcelable someFunction()" أو "void someFunction(out Parcelable)" أو "void someFunction(inout Parcelable)".

الحقول

public static final Creator<TrainingExampleInput> CREATOR

الطرق العامة

int describeContents()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا.

boolean equals(Object o)

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

String getCollectionName()

اسم مجموعة البيانات التي ستتم القراءة منها، والذي تحدّده خطة المهام الفيدرالية التي تم ضبطها في خادم الحوسبة الفيدرالية

String getPopulationName()

اسم مهمة الحوسبة الموحّدة

byte[] getResumptionToken()

رمز مميّز يُستخدَم لدعم استئناف التدريب.

String getTaskName()

قد يكون لدى مجموعة واحدة من الأشخاص مهام متعددة.

int hashCode()

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

void writeToParcel(Parcel dest, int flags)

اضغط على هذا الكائن لتحويله إلى قطعة أرض.

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

Object clone()

تُنشئ هذه الدالة نسخة من هذا الكائن وتُرجعها.

boolean equals(Object obj)

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

void finalize()

يتم استدعاء هذا الإجراء من قِبل أداة تجميع البيانات المهملة على العنصر عندما يتبيّن أنّ هناك إشارات إلى هذا العنصر غير المرغوب فيها.

final Class<?> getClass()

عرض فئة وقت التشغيل لهذا Object

int hashCode()

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

final void notify()

توقِظ سلسلة محادثات واحدة في انتظار مراقبة هذا الكائن.

final void notifyAll()

لتنشيط جميع سلاسل المحادثات التي تنتظر شاشة هذا الكائن.

String toString()

تعرض تمثيلاً سلسلة للكائن.

final void wait(long timeoutMillis, int nanos)

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها، أو إلى أن تنتهي مدة زمنية معيّنة.

final void wait(long timeoutMillis)

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها، أو إلى أن تنتهي مدة زمنية معيّنة.

final void wait()

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.

abstract int describeContents()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا.

abstract void writeToParcel(Parcel dest, int flags)

اضغط على هذا الكائن لتحويله إلى قطعة أرض.

الحقول

الطرق العامة

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 بخلاف ذلك.

getCollectionName

public String getCollectionName ()

اسم مجموعة البيانات التي ستتم القراءة منها، والذي تحدّده خطة المهام الفيدرالية التي تم ضبطها في خادم الحوسبة الفيدرالية

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

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

public String getPopulationName ()

اسم مهمة الحوسبة الموحّدة

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

getResumptionToken

public byte[] getResumptionToken ()

الرمز المميّز المستخدَم لدعم استئناف التدريب

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

getTaskName

public String getTaskName ()

قد تتضمّن مجموعة واحدة مهام متعددة. يمكن استخدام اسم المهمة لتحديد الوظيفة بشكل فريد.

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

hashCode

public int hashCode ()

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

العقد العام لشركة "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