GetTopicsResponse

public final class GetTopicsResponse
extends Object

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

تمثيل النتيجة من getTopics API

ملخّص

الفئات المُدمجة

class GetTopicsResponse.Builder

أداة إنشاء GetTopicsResponse عنصر 

الطرق العامة

boolean equals(Object o)

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

List<Topic> getTopics()

تعرض List من إجمالي Topic عناصر تم عرضها بواسطة getTopics API.

int hashCode()

عرض قيمة رمز التجزئة للعنصر

الطرق المكتسَبة

Object clone()

تُنشئ هذه الدالة نسخة من هذا الكائن وتُرجعها.

boolean equals(Object obj)

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

void finalize()

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

final Class<?> getClass()

تعرض فئة بيئة التشغيل هذه لجهاز Object.

int hashCode()

عرض قيمة رمز التجزئة للعنصر

final void notify()

توقِظ سلسلة محادثات واحدة في انتظار مراقبة هذا الكائن.

final void notifyAll()

لتنشيط جميع سلاسل المحادثات التي تنتظر شاشة هذا الكائن.

String toString()

تعرض تمثيلاً سلسلة للكائن.

final void wait(long timeoutMillis, int nanos)

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها، أو إلى أن تنتهي مدة زمنية معيّنة.

final void wait(long timeoutMillis)

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها، أو إلى أن تنتهي مدة زمنية معيّنة.

final void wait()

تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.

الطرق العامة

علامة يساوي

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، الذي ينص على أنّه يجب أن تتضمّن العناصر المتساوية رموز تجزئة متساوية.

المعلمات
o ‫Object: العنصر المرجعي الذي تتم المقارنة به
المرتجعات
boolean true إذا كان هذا العنصر هو نفسه وسيطة obj ، false بخلاف ذلك.

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

public List<Topic> getTopics ()

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

المرتجعات
List<Topic> لا يمكن أن تكون هذه القيمة null.

hashCode

public int hashCode ()

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

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

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

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

المرتجعات
int قيمة رمز التجزئة لهذا العنصر