Argomento
public
final
class
Topic
extends Object
java.lang.Object | |
↳ | android.adservices.topics.Topic |
Rappresenta il risultato dell'argomento dall'API getTopics.
Riepilogo
Costruttori pubblici | |
---|---|
Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)
Crea un oggetto che rappresenta il risultato dell'API getTopics. |
Metodi pubblici | |
---|---|
boolean
|
equals(Object object)
Indica se qualche altro oggetto è "uguale a" questo. |
long
|
getModelVersion()
Recupera il valore ModelVersion. |
long
|
getTaxonomyVersion()
Ottieni il parametro TaxonomyVersion. |
int
|
getTopicId()
Recupera l'ID argomento. |
int
|
hashCode()
Restituisce un valore di codice hash per l'oggetto. |
String
|
toString()
Restituisce una rappresentazione stringa dell'oggetto. |
Metodi ereditati | |
---|---|
Costruttori pubblici
Argomento
public Topic (long mTaxonomyVersion, long mModelVersion, int mTopicId)
Crea un oggetto che rappresenta il risultato dell'API getTopics.
Parametri | |
---|---|
mTaxonomyVersion |
long : un long che rappresenta la versione della tassonomia. |
mModelVersion |
long : valore long che rappresenta la versione del modello. |
mTopicId |
int : un numero intero che rappresenta l'ID univoco di un argomento. |
Metodi pubblici
uguale a
public boolean equals (Object object)
Indica se qualche altro oggetto è "uguale a" questo.
Il metodo equals
implementa una relazione di equivalenza sui riferimenti a oggetti non null:
- È riflesso: per qualsiasi valore di riferimento non null
x
,x.equals(x)
deve restituiretrue
. - È simmetrico: per qualsiasi valore di riferimento non nullo
x
ey
,x.equals(y)
deve restituiretrue
se e solo sey.equals(x)
restituiscetrue
. - È transitivo: per qualsiasi valore di riferimento non nullo
x
,y
ez
, sex.equals(y)
restituiscetrue
ey.equals(z)
restituiscetrue
,x.equals(z)
deve restituiretrue
. - È coerente: per tutti i valori di riferimento non null
x
ey
, più chiamate dix.equals(y)
restituiscono costantementetrue
o restituiscono costantementefalse
, a condizione che nessuna informazione utilizzata nei confronti diequals
sugli oggetti venga modificata. - Per qualsiasi valore di riferimento non null
x
,x.equals(null)
deve restituirefalse
.
Il metodo equals
per la classe Object
implementa la relazione di equivalenza più discriminante possibile sugli oggetti; ovvero, per qualsiasi valore di riferimento non nullo x
e y
, questo metodo restituisce true
se e solo se x
e y
fanno riferimento allo stesso oggetto (x == y
ha il valore true
).
Tieni presente che, in genere, è necessario sostituire il metodo hashCode
ogni volta che questo metodo viene sostituito, in modo da mantenere il contratto generale per il metodo hashCode
, in cui si afferma che oggetti uguali devono avere codici hash uguali.
Parametri | |
---|---|
object |
Object : l'oggetto di riferimento con cui effettuare il confronto. |
Ritorni | |
---|---|
boolean |
true se questo oggetto è uguale all'argomento obj; in caso contrario false . |
getModelVersion
public long getModelVersion ()
Recupera il valore ModelVersion.
Ritorni | |
---|---|
long |
getTaxonomyVersion
public long getTaxonomyVersion ()
Ottieni il parametro TaxonomyVersion.
Ritorni | |
---|---|
long |
getTopicId
public int getTopicId ()
Recupera l'ID argomento.
Ritorni | |
---|---|
int |
Codice hash
public int hashCode ()
Restituisce un valore di codice hash per l'oggetto. Questo metodo è supportato a vantaggio delle tabelle hash come quelle fornite da HashMap
.
Il contratto generale di hashCode
è:
- Ogni volta che viene richiamato sullo stesso oggetto più di una volta durante l'esecuzione di un'applicazione Java, il metodo
hashCode
deve restituire in modo coerente lo stesso numero intero, a condizione che non venga modificata alcuna informazione utilizzata nei confronti diequals
sull'oggetto. Questo numero intero non deve rimanere coerente da un'esecuzione a un'altra della stessa applicazione. - Se due oggetti sono uguali in base al metodo
equals(Object)
, la chiamata del metodohashCode
su ciascuno dei due oggetti deve produrre lo stesso risultato intero. - Non è necessario che se due oggetti non sono uguali in base al metodo
equals(java.lang.Object)
, la chiamata del metodohashCode
su ciascuno dei due oggetti deve produrre risultati interi distinti. Tuttavia, il programmatore deve sapere che produrre risultati interi distinti per oggetti disuguali può migliorare le prestazioni delle tabelle hash.
Per quanto ragionevolmente pratico, il metodo hashCode definito dalla classe Object
restituisce numeri interi distinti per oggetti distinti. (l'hashCode può o meno essere implementato come funzione dell'indirizzo di memoria di un oggetto in un determinato momento).
Ritorni | |
---|---|
int |
un valore di codice hash per l'oggetto. |
ToString
public String toString ()
Restituisce una rappresentazione stringa dell'oggetto. In generale, il metodo toString
restituisce una stringa che "rappresenta testualmente" l'oggetto. Il risultato dovrebbe essere una rappresentazione concisa, ma informativa, facile da leggere.
È consigliabile che tutte le sottoclassi sostituiscano questo metodo.
Il metodo toString
per la classe Object
restituisce una stringa composta dal nome della classe di cui l'oggetto è un'istanza, dal carattere del simbolo @ "@
" e dalla rappresentazione esadecimale senza segno del codice hash dell'oggetto. In altre parole, questo metodo restituisce una stringa uguale al valore di:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Ritorni | |
---|---|
String |
una rappresentazione stringa dell'oggetto. |