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()

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

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

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

שווה ל-

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 שקריא לבני אדם.