דף זה תורגם על ידי Cloud Translation API.

נוספה ב-רמת 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()` הפונקציה מחזירה ייצוג מחרוזת של האובייקט.

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

מהכיתה


        
          java.lang.Object

`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`	ייצוג במחרוזת של האובייקט.