طلب تعديل الإشارات

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) نفسه للتحديث.

الحصول على تحديثUri

public Uri getUpdateUri ()

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

رمز التجزئة

public int hashCode ()

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

العقد العام لشركة "hashCode" هو:

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

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

الركلات المردودة
int تجزئة بيانات الكائن UpdateSignalsRequest.

سلسلة

public String toString ()

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

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

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

الركلات المردودة
String تمثيل UpdateSignalsRequest يمكن لشخص عادي قراءته.