GetTopicsResponse

public final class GetTopicsResponse
extends Object

java.lang.Object
   ↳ android.adservices.topics.GetTopicsResponse


מייצג את התוצאה מ-getTopics API.

סיכום

כיתות בתצוגת עץ

class GetTopicsResponse.Builder

Builder ל-GetTopicsResponse אובייקטים. 

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

boolean equals(Object o)

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

List<Topic> getTopics()

הפונקציה מחזירה List של אובייקטים מסוג Topic שמוחזרים על ידי ה-API של getTopics.

int hashCode()

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

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

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

שווה ל-

נוספה ב-רמת API 34
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).

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

פרמטרים
o Object: אובייקט העזרה שאליו מבצעים את ההשוואה.

החזרות
boolean true אם האובייקט הזה זהה לארגומנט obj, אחרת false.

getTopics

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4
public List<Topic> getTopics ()

הפונקציה מחזירה List של אובייקטים מסוג Topic שמוחזרים על ידי ה-API של getTopics.

החזרות
List<Topic> הערך לא יכול להיות null.

hashCode

נוסף ברמת API 34
public int hashCode ()

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

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

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

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

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