TrainingExampleInput

public final class TrainingExampleInput
extends Object implements Parcelable

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

נתוני הקלט של IsolatedWorker#onTrainingExample(TrainingExampleInput, Consumer)

סיכום

קבועים שעברו בירושה

שדות

public static final Creator<TrainingExampleInput> CREATOR

שיטות ציבוריות

int describeContents()

תיאור הסוגים של אובייקטים מיוחדים שמכילים את הייצוג המארגן של מופע ה-Parcelable הזה.

boolean equals(Object o)

מציין אם אובייקט אחר הוא 'שווה' לאובייקט הזה.

String getCollectionName()

השם של אוסף הנתונים שרוצים לקרוא ממנו, שצוין בתוכנית המשימות המשותפת שהוגדרה בשרת המחשוב המשותף.

String getPopulationName()

השם של המשימה המאוחדת לעיבוד נתונים.

byte[] getResumptionToken()

טוקן שמשמש לתמיכה בהמשך האימון.

String getTaskName()

לאוכלוסייה אחת יכולות להיות כמה משימות.

int hashCode()

הפונקציה מחזירה ערך של קוד גיבוב לאובייקט.

void writeToParcel(Parcel dest, int flags)

משטחים את האובייקט הזה ל-Parcel.

שיטות שעברו בירושה

שדות

שיטות ציבוריות

describeContents

public int describeContents ()

צריך לתאר את סוגי האובייקטים המיוחדים שכלולים בייצוג המתואם של המכונה הזו של Parcelable. לדוגמה, אם האובייקט יכלול מתאר קובץ בפלט של writeToParcel(android.os.Parcel, int), ערך ההחזרה של השיטה הזו חייב לכלול את הביט CONTENTS_FILE_DESCRIPTOR.

החזרות
int מסכת ביט שמציינת את קבוצת סוגי האובייקטים המיוחדים שמארגנים על ידי מופע האובייקט הניתן למעבר. הערך הוא 0 או CONTENTS_FILE_DESCRIPTOR

שווה ל-

public boolean equals (Object o)

מציין אם אובייקט אחר הוא 'שווה' לאובייקט הזה.

השיטה equals מחילה יחס שקילות על הפניות אובייקטים שאינם null:

  • היא רפלקסיבית: לכל ערך הפניה שאינו null‏ x, הפונקציה x.equals(x) אמורה להחזיר true.
  • היא סימטרית: לכל ערכי ההפניה x ו-y שאינם null, הפונקציה 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 על האובייקטים.
  • עבור כל ערך הפניה שהוא לא null x, x.equals(null) צריך להחזיר false.

השיטה equals של הכיתה Object מיישמת את יחס השוויון המבדיל ביותר האפשרי על אובייקטים. כלומר, לכל ערכי ההפניה x ו-y שאינם null, השיטה הזו מחזירה את הערך true אם ורק אם x ו-y מפנים לאותו אובייקט (ל-x == y יש את הערך true).

חשוב לזכור שבדרך כלל צריך לשנות את השיטה hashCode בכל פעם שמשתנים את השיטה הזו, כדי לשמור על החוזה הכללי של השיטה hashCode, שלפיו לאובייקטים שווים חייבים להיות קודי גיבוב שווים.

פרמטרים
o Object: הערך הזה יכול להיות null.
החזרות
boolean true אם האובייקט הזה זהה לארגומנט obj,‏ false אחרת.

getCollectionName

public String getCollectionName ()

השם של אוסף הנתונים שרוצים לקרוא ממנו, שצוין בתוכנית המשימות המשותפת שהוגדרה בשרת המחשוב המשותף.

החזרות
String הערך לא יכול להיות null.

getPopulationName

public String getPopulationName ()

השם של המשימה המאוחדת לעיבוד נתונים.

החזרות
String הערך לא יכול להיות null.

getResumptionToken

public byte[] getResumptionToken ()

טוקן שמשמש לתמיכה בהמשך האימון.

החזרות
byte[] הערך הזה יכול להיות null.

getTaskName

public String getTaskName ()

באוכלוסייה אחת יכולות להיות מספר משימות. אפשר להשתמש בשם המשימה כדי לזהות את המשימה באופן ייחודי.

החזרות
String הערך הזה לא יכול להיות null.

קוד גיבוב (hashCode)

public int hashCode ()

הפונקציה מחזירה ערך של קוד גיבוב לאובייקט. השיטה הזו נתמכת לטובת טבלאות הגיבוב, כמו אלה שמסופקות על ידי HashMap.

החוזה הכללי של hashCode הוא:

  • כשמפעילים אותה על אותו אובייקט יותר מפעם אחת במהלך הרצה של אפליקציית Java, ה-method hashCode חייבת להחזיר את אותו מספר שלם באופן עקבי, בתנאי שלא נעשה שינוי במידע שנעשה בו שימוש בהשוואות של equals על האובייקט. המספר המלא הזה לא חייב להישאר עקבי בין הפעלה אחת של אפליקציה להפעלה אחרת של אותה אפליקציה.
  • אם שני אובייקטים שווים לפי השיטה equals(Object), אז קריאה ל-method hashCode בכל אחד משני האובייקטים חייבת להניב את אותה תוצאה של מספר שלם.
  • לא נדרש שקריאה לשיטה hashCode על כל אחד משני האובייקטים תיצור תוצאות שלמים נפרדים, אם שני אובייקטים שונים לפי השיטה equals(java.lang.Object). עם זאת, למתכנת צריך להיות ברור שיצירת תוצאות שלמים נפרדות לאובייקטים שאינם שווים עשויה לשפר את הביצועים של טבלאות גיבוב.

ככל האפשר, שיטת hashCode שמוגדרת על ידי הכיתה Object מחזירה מספרים שלמים נפרדים לעצמים נפרדים. (יכול להיות שה-hashCode יוטמע כפונקציה כלשהי של כתובת הזיכרון של אובייקט בשלב כלשהו, ויכול להיות שלא).

החזרות
int ערך של קוד גיבוב לאובייקט הזה.

WriteToParcel

public void writeToParcel (Parcel dest, 
                int flags)

יש לשטח את האובייקט ל-Parcel

פרמטרים
dest Parcel: הערך לא יכול להיות null.
flags int: דגלים נוספים לגבי האופן שבו צריך לכתוב את האובייקט. הערך יכול להיות 0 או Parcelable.PARCELABLE_WRITE_RETURN_VALUE. הערך הוא 0 או שילוב של Parcelable.PARCELABLE_WRITE_RETURN_VALUE ו-android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES