UpdateSignalsRequest

public final class UpdateSignalsRequest
extends Object

java.lang.Object
↳ android.adservices.signals.UpdateSignalsRequest

عنصر الطلب لـ updateSignals.

updateUri هي المَعلمة الوحيدة. وهو يمثّل معرّف الموارد المنتظم (URI) الذي ستتواصل معه الخدمة لاسترداد تعديلات الإشارات.

ملخّص

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

class UpdateSignalsRequest.Builder

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

الطرق العامة

boolean equals(Object o)

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

Uri getUpdateUri()
int hashCode()

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

String toString()

لعرض تمثيل سلسلة للعنصر.

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

الطرق العامة

علامة يساوي

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 فقط إذا كان الكائن الآخر هو UpdateSignalsRequest باستخدام معرّف الموارد المنتظم (URI) نفسه للتحديث.

getUpdateUri

public Uri getUpdateUri ()

المرتجعات
Uri Uri الذي سيتم جلب إشاراته لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

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

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

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

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

المرتجعات
int تجزئة بيانات UpdateSignalsRequest

toString

public String toString ()

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

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

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

المرتجعات
String تمثيل يمكن لشخص عادي قراءته لـ UpdateSignalsRequest