UpdateSignalsRequest

public final class UpdateSignalsRequest
extends Object

java.lang.Object
↳ android.adservices.signals.UpdateSignalsRequest

אובייקט הבקשה של updateSignals.

updateUri הוא הפרמטר היחיד. היא מייצגת את כתובת ה-URI שבה השירות ייצור קשר כדי לאחזר את עדכוני האותות.

סיכום

מחלקות מקוננות

class UpdateSignalsRequest.Builder

ה-builder של אובייקטים מסוג UpdateSignalsRequest. 

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

boolean equals(Object o)

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

Uri getUpdateUri()
int hashCode()

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

String toString()

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

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

Object clone()

יצירת עותק של האובייקט הזה והחזרתו.

boolean equals(Object obj)

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

void finalize()

הקריאה מתבצעת על ידי מנהל האשפה לאובייקט כאשר מנהל האשפה קובע שאין יותר הפניות לאובייקט.

final Class<?> getClass()

הפונקציה מחזירה את המחלקה של סביבת זמן הריצה של Object.

int hashCode()

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

final void notify()

מעוררת שרשור יחיד שממתין למעקב אחרי האובייקט הזה.

final void notifyAll()

הפונקציה מעוררת את כל ה-threads שממתינים למעקב אחרי האובייקט הזה.

String toString()

מחזירה ייצוג במחרוזת של האובייקט.

final void wait(long timeoutMillis, int nanos)

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

final void wait(long timeoutMillis)

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

final void wait()

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

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

שווה ל-

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, ה-method הזה מחזירה true רק אם x ו-y מזכירים את אותו אובייקט (x == y יש את הערך true).

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

פרמטרים
o Object: אובייקט העזרה שאליו מבצעים את ההשוואה.
החזרות
boolean true אם ורק אם האובייקט השני הוא UpdateSignalsRequest עם אותו URI של עדכון.

getUpdateUri

public Uri getUpdateUri ()

החזרות
Uri ה-Uri שממנו יישלפו עדכוני האות. הערך לא יכול להיות null.

קוד גיבוב (hashCode)

public int hashCode ()

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

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

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

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

החזרות
int הגיבוב (hash) של נתוני האובייקט UpdateSignalsRequest.

toString

public String toString ()

הפונקציה מחזירה ייצוג מחרוזת של האובייקט. באופן כללי, השיטה toString מחזירה מחרוזת ש"מייצגת באופן טקסטואלי" את האובייקט הזה. התוצאה צריכה להיות ייצוג תמציתי אבל מידעני שקל לאדם לקרוא. מומלץ שכל מחלקות המשנה יבטלו את השיטה הזו.

השיטה toString של הכיתה Object מחזירה מחרוזת שמכילה את שם הכיתה שהאובייקט הוא מופע שלה, את התו @‏ (@) ואת הייצוג הקסדצימלי ללא סימן חותמת של קוד ה-hash של האובייקט. במילים אחרות, השיטה הזו מחזירה מחרוזת שווה לערך של: 

 getClass().getName() + '@' + Integer.toHexString(hashCode())

החזרות
String ייצוג של UpdateSignalsRequest שקריא לבני אדם.