تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

الملخّص: مُنشئو العناصر | الطرق | الطرق المُكتسَبة

الموضوع

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() عرض قيمة رمز التجزئة للعنصر
String	toString() تعرض تمثيلاً سلسلة للكائن.

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

من الفئة java.lang.Object 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() تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.

وظائف الإنشاء العامة

الموضوع

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

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

لإنشاء عنصر يمثّل النتيجة من getTopics API

المعلمات
mTaxonomyVersion	long: سلسلة طويلة تمثّل إصدار التصنيف
mModelVersion	long: تمثّل هذه السمة النسخة الطويلة من النموذج.
mTopicId	int: عدد صحيح يمثّل المعرّف الفريد لموضوع معيّن.

الطرق العامة

علامة يساوي

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

public boolean equals (Object object)

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

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

المعلمات
object	‫Object: العنصر المرجعي الذي تتم المقارنة به

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

getModelVersion

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public long getModelVersion ()

احصل على modelVersion.

المرتجعات
long

getTaxonomyVersion

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public long getTaxonomyVersion ()

احصل على التصنيف.

المرتجعات
long

getTopicId

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public int getTopicId ()

الحصول على رقم تعريف الموضوع

المرتجعات
int

hashCode

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

public int hashCode ()

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

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

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

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

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

toString

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

public String toString ()

تعرض تمثيلاً سلسلة للكائن. بشكل عام، تعرض الطريقة toString سلسلة "تمثّل هذا الكائن نصيًا". ويجب أن تكون النتيجة تمثيلاً موجزًا وغنيًا بالمعلومات ويسهل على المستخدم قراءته. يُنصح بأن تلغي جميع الفئات الفرعية هذه الطريقة.

تعرض طريقة toString لفئة Object سلسلة تتألف من اسم الفئة التي يمثّل كائن مثيلًا لها، وحرف علامة الالتقاط "@"، و التمثيل السداسي العشري غير الموقَّت لرمز التجزئة الخاص بكائن. بعبارة أخرى، تُرجع هذه الطريقة سلسلة تساوي قيمة:

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

المرتجعات
String	تمثيل العنصر في سلسلة