נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4
סיכום: Ctors | Methods | Inherited Methods

נושא

public final class Topic
extends Object

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

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

סיכום

יוצרים ציבוריים

Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)

יצירת אובייקט שמייצג את התוצאה מ-getTopics API.

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

boolean equals(Object object)

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

long getModelVersion()

מקבלים את ModelVersion.

long getTaxonomyVersion()

אחזור של TaxonomyVersion.

int getTopicId()

מוצאים את מזהה הנושא.

int hashCode()

מחזירה ערך גיבוב (hash) של האובייקט.

String toString()

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

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

Object clone()

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

boolean equals(Object obj)

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

void finalize()

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

final Class<?> getClass()

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

int hashCode()

מחזירה ערך גיבוב (hash) של האובייקט.

final void notify()

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

final void notifyAll()

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

String toString()

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

final void wait(long timeoutMillis, int nanos)

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

final void wait(long timeoutMillis)

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

final void wait()

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

יוצרים ציבוריים

נושא

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4 
public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

יצירת אובייקט שמייצג את התוצאה מ-getTopics API.

פרמטרים
mTaxonomyVersion long: ערך long שמייצג את גרסת הטקסונומיה.
mModelVersion long: ערך long שמייצג את גרסת המודל.
mTopicId int: מספר שלם שמייצג את המזהה הייחודי של נושא.

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

שווה ל-

נוספה ב-רמת API 34 
public boolean equals (Object object)

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

השיטה 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) שווים.

פרמטרים
object Object: אובייקט ההפניה שאליו תשוו.
החזרות
boolean true אם האובייקט הזה זהה לארגומנט obj,‏ false אחרת.

getModelVersion

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4 
public long getModelVersion ()

מקבלים את ModelVersion.

החזרות
long

getTaxonomyVersion

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4 
public long getTaxonomyVersion ()

אחזור של TaxonomyVersion.

החזרות
long

getTopicId

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4 
public int getTopicId ()

מקבלים את מזהה הנושא.

החזרות
int

hashCode

נוספה ב-רמת API 34 
public int hashCode ()

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

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

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

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

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

toString

נוספה ב-רמת API 34 
public String toString ()

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

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

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

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