GetTopicsResponse

علامة يساوي

public boolean equals (Object o)

يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر.

تنفِّذ طريقة equals علاقة تكافؤ على مراجع الكائنات غير الصفرية:

• وهي عاكسة: لأي قيمة مرجعية غير خالية x، يجب أن تعرض x.equals(x) true.
• قيمة السمة متماثلة: بالنسبة إلى أي قيم مرجعية غير فارغة مثل x وy، يجب أن تعرض السمة x.equals(y) القيمة true إذا كانت السمة y.equals(x) تعرض true فقط.
• وهي تدرّجية: بالنسبة إلى أي قيم مرجعية غير صفرية x وy وz، إذا كانت x.equals(y) تعرِض true و y.equals(z) تعرِض true، عندئذٍ x.equals(z) يجب أن تعرِض true.
• تكون متسقة: بالنسبة إلى أي قيم مرجعية غير صفرية x وy، تؤدي عمليات الاستدعاء المتعدّدة لمحاولة x.equals(y) إلى عرض true بشكلٍ متسق أو عرض false بشكلٍ متسق، شرط عدم تعديل المعلومات المستخدَمة في مقارنات equals على العناصر.
• بالنسبة إلى أي قيمة مرجعية غير خالية في السمة x، يجب أن تعرض السمة x.equals(null) القيمة false.

تُنفِّذ طريقة equals لفئة Object علاقة التكافؤ الأكثر تمييزًا على العناصر، أي أنّه بالنسبة إلى أي قيم مرجعية غير فارغة x و y، تعرض هذه الطريقة القيمة true إذا كانت x وy تشير إلى العنصر نفسه (x == y لها القيمة true).

يُرجى العِلم أنّه من الضروري بشكل عام إلغاء طريقة hashCode عند إلغاء هذه الطريقة، وذلك للحفاظ على العقد العام لطريقة hashCode، الذي ينص على أنّه يجب أن تتضمّن العناصر المتساوية رموز تجزئة متساوية.

الحصول على مواضيع

public List<Topic> getTopics ()

تعرِض هذه الدالة List من Topic عنصر يعرضها واجهة برمجة التطبيقات getTopics.

hashCode

public int hashCode ()

عرض قيمة رمز التجزئة للعنصر يمكن استخدام هذه الطريقة لصالح جداول التجزئة، مثل تلك التي يوفّرها HashMap.

العقد العام لـ hashCode هو:

• عند استدعاء الأسلوب hashCode على العنصر نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن يعرض الأسلوب hashCode باستمرارً عددًا صحيحًا مماثلاً، شرط عدم تعديل أي معلومات مستخدَمة في مقارنات equals على العنصر. ولا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ لتطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه.
• إذا كان الجسمان متساويين وفقًا للطريقة equals(Object) ، يجب أن يؤدي استدعاء الطريقة hashCode على كل من الجسمَين إلى النتيجة الصحيحة نفسها.
• ليس مطلوبًا أن يؤدي استدعاء الأسلوب hashCode على كل من العنصرين إلى نتائج صحيحة مختلفة إذا كان العنصران غير متساويين وفقًا للأسلوب equals(java.lang.Object). ومع ذلك، يجب أن يكون المبرمج على عِلم بأنّ إنتاج نتائج عددية مختلفة للكائنات غير المتساوية قد يحسن أداء جداول التجزئة.

تُعرِض طريقة hashCode المحدَّدة من خلال الفئة Object أعدادًا صحيحة مختلفة للعناصر المختلفة، وذلك قدر الإمكان. (قد يتم تنفيذ hashCode أو لا يتم تنفيذه كبعض وظائف عنوان ذاكرة العنصر في وقت معيّن ).