अपडेट सिग्नल का अनुरोध

public final class UpdateSignalsRequest
extends Object

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


updateSignals के लिए अनुरोध ऑब्जेक्ट.

updateUri ही एक पैरामीटर है. यह उस यूआरआई को दिखाता है जिस पर सेवा, सिग्नल के अपडेट पाने के लिए संपर्क करेगी.

खास जानकारी

नेस्ट की गई क्लास

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 दिखाना चाहिए जो शून्य न हो.

क्लास Object के लिए equals तरीका, ऑब्जेक्ट पर सबसे ज़्यादा भेदभाव करने वाला संभावित समानता संबंध लागू करता है. इसका मतलब है कि किसी भी गैर-शून्य रेफ़रंस वैल्यू x और y के लिए, यह तरीका सिर्फ़ तब true दिखाता है, जब x और y एक ही ऑब्जेक्ट का रेफ़रंस देते हों (x == y की वैल्यू true होती है).

ध्यान दें कि आम तौर पर, जब भी इस तरीके को बदला जाता है, तो hashCode तरीके को बदलना ज़रूरी होता है. इससे hashCode तरीके के लिए सामान्य अनुबंध को बनाए रखने में मदद मिलती है. इसमें बताया गया है कि बराबर ऑब्जेक्ट में एक जैसे हैश कोड होने चाहिए.

पैरामीटर
o Object: वह रेफ़रंस ऑब्जेक्ट जिसकी तुलना करनी है.

रिटर्न
boolean true, अगर दूसरा ऑब्जेक्ट UpdateSignalsRequest है और उस पर, उसी अपडेट यूआरआई का इस्तेमाल किया गया है.

getUpdateUri

public Uri getUpdateUri ()

रिटर्न
Uri वह Uri जिससे सिग्नल के अपडेट फ़ेच किए जाएंगे. यह मान null नहीं हो सकता.

हैशकोड

public int hashCode ()

यह फ़ंक्शन किसी ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है. हैश टेबल के फ़ायदे के लिए यह तरीका इस्तेमाल किया जा सकता है, जैसा कि HashMap से मिलता है.

hashCode का सामान्य समझौता:

  • जब भी किसी Java ऐप्लिकेशन को चलाने के दौरान, एक ही ऑब्जेक्ट पर एक से ज़्यादा बार कॉल किया जाता है, तो hashCode मेथड को एक ही इंटिजर दिखाना चाहिए. हालांकि, ऐसा तब ही होगा, जब ऑब्जेक्ट पर equals की तुलना में इस्तेमाल की गई जानकारी में बदलाव न किया गया हो. ज़रूरी नहीं है कि इस इंटीजर के हिसाब से, ऐप्लिकेशन को एक बार चलाया जाए और उसी ऐप्लिकेशन को दूसरे ऐप्लिकेशन पर लागू किया जाए.
  • अगर equals(Object) तरीके के हिसाब से दो ऑब्जेक्ट एक जैसे हैं, तो दोनों ऑब्जेक्ट पर hashCode तरीका इस्तेमाल करने पर, एक ही पूर्णांक का नतीजा मिलना चाहिए.
  • अगर equals(java.lang.Object) तरीके के हिसाब से दो ऑब्जेक्ट असमान हैं, तो यह ज़रूरी नहीं है कि दोनों ऑब्जेक्ट पर hashCode तरीके को कॉल करने पर, अलग-अलग पूर्णांक वाले नतीजे मिलें. हालांकि, प्रोग्रामर को इस बात का ध्यान रखना चाहिए कि अलग-अलग ऑब्जेक्ट के लिए अलग-अलग पूर्णांक नतीजे देने से, हैश टेबल की परफ़ॉर्मेंस बेहतर हो सकती है.

Object क्लास के hashCode मेथड से, अलग-अलग ऑब्जेक्ट के लिए अलग-अलग पूर्णांक मिलते हैं. (हो सकता है कि किसी समय, किसी ऑब्जेक्ट के मेमोरी पते के किसी फ़ंक्शन के तौर पर, hashCode को लागू किया गया हो या न किया गया हो.)

रिटर्न
int UpdateSignalsRequest ऑब्जेक्ट के डेटा का हैश.

toString

public String toString ()

ऑब्जेक्ट की स्ट्रिंग वैल्यू दिखाता है. आम तौर पर, toString वाला तरीका एक ऐसी स्ट्रिंग दिखाता है जो इस ऑब्जेक्ट को "टेक्स्ट के तौर पर दिखाती है". नतीजा, कम शब्दों में जानकारी देने वाला होना चाहिए, ताकि कोई भी व्यक्ति उसे आसानी से पढ़ सके. हमारा सुझाव है कि सभी सबक्लास इस तरीके को बदल दें.

क्लास Object के लिए toString मैथड, एक स्ट्रिंग दिखाता है. इसमें उस क्लास का नाम होता है जिसका ऑब्जेक्ट एक इंस्टेंस है, @ साइन वाला वर्ण `@', और ऑब्जेक्ट के हैश कोड का बिना हस्ताक्षर वाला हेक्साडेसिमल वर्शन होता है. दूसरे शब्दों में, यह तरीका इस वैल्यू के बराबर स्ट्रिंग दिखाता है:

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

रिटर्न
String UpdateSignalsRequest को आसानी से पढ़ा जा सकने वाले फ़ॉर्मैट में दिखाया गया है.