נושא

נושא

public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

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

שווה ל-

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

getModelVersion

public long getModelVersion ()

מקבלים את ModelVersion.

getTaxonomyVersion

public long getTaxonomyVersion ()

אחזור של TaxonomyVersion.

getTopicId

public int getTopicId ()

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

hashCode

public int hashCode ()

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

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

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

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

toString

public String toString ()

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

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

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