एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया
खास जानकारी: Ctor | तरीके | इनहेरिट किए गए तरीके

विषय

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()

ऑब्जेक्ट की स्ट्रिंग वैल्यू दिखाता है.

इनहेरिट किए गए तरीके

सार्वजनिक कंस्ट्रक्टर

विषय

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 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 दिखाना चाहिए.

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

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

पैरामीटर
object Object: वह रेफ़रंस ऑब्जेक्ट जिसकी तुलना करनी है.
रिटर्न
boolean true अगर यह ऑब्जेक्ट, obj आर्ग्युमेंट जैसा है, तो false.

getModelVersion

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public long getModelVersion ()

ModelVersion पाएं.

रिटर्न
long

getTaxonomyVersion

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public long getTaxonomyVersion ()

TaxonomyVersion पाएं.

रिटर्न
long

getTopicId

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया 
public int getTopicId ()

विषय आईडी पाएं.

रिटर्न
int

hashCode

एपीआई लेवल 34 में जोड़ा गया 
public int hashCode ()

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

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

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

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

रिटर्न
int इस ऑब्जेक्ट के लिए एक हैश कोड वैल्यू है.

toString

एपीआई लेवल 34 में जोड़ा गया 
public String toString ()

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

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

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

रिटर्न
String ऑब्जेक्ट की स्ट्रिंग.