נתוני משתמשים

public final class UserData
extends Object implements Parcelable

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

נתוני משתמשים שסופקו על ידי הפלטפורמה ל-IsolatedService.

סיכום

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

שדות

public static final Creator<UserData> CREATOR

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

int describeContents()

צריך לתאר את סוגי האובייקטים המיוחדים שכלולים בייצוג המתואם של המכונה הזו של Parcelable.

boolean equals(Object o)

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

Map<String, AppInfo> getAppInfos()

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

long getAvailableStorageBytes()

נפח האחסון הפנוי במכשיר ביביט.

int getBatteryPercentage()

אחוז הטעינה של הסוללה.

String getCarrier()

שם ספק השירות (SPN) שהוחזר על ידי TelephonyManager#getSimOperatorName()

int getOrientation()

הכיוון שאליו פונה המכשיר.

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

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

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

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

getAppInfos

public Map<String, AppInfo> getAppInfos ()

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

החזרות
Map<String, AppInfo> הערך הזה לא יכול להיות null.

getAvailableStorageBytes

public long getAvailableStorageBytes ()

השטח הזמין במכשיר בבייטים.

החזרות
long הערך חייב להיות 0 או יותר

אחוזי סוללה

public int getBatteryPercentage ()

אחוז הטעינה של הסוללה.

החזרות
int הערך הוא בין 0 ל-100, כולל

getCarrier

public String getCarrier ()

שם ספק השירות (SPN) שהוחזר על ידי TelephonyManager#getSimOperatorName()

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

getOrientation

public int getOrientation ()

הכיוון שאליו פונה המכשיר. הערך יכול להיות אחד מהקבועים ORIENTATION_UNDEFINED,‏ ORIENTATION_PORTRAIT או ORIENTATION_LANDSCAPE שמוגדרים ב-Configuration.

החזרות
int הערך הוא Configuration.ORIENTATION_UNDEFINED,‏ Configuration.ORIENTATION_PORTRAIT,‏ Configuration.ORIENTATION_LANDSCAPE או Configuration.ORIENTATION_SQUARE

קוד גיבוב (hashCode)

public int hashCode ()

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

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

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

עד כמה שהדבר מעשי באופן סביר, שיטת 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