Argomento

public final class Topic
extends Object

java.lang.Object
   ↳ android.adservices.topics.Topic


Rappresenta il risultato dell'argomento dell'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 un altro oggetto è "uguale" a questo.

long getModelVersion()

Recupera la versione del modello.

long getTaxonomyVersion()

Recupera TaxonomyVersion.

int getTopicId()

Recupera l'ID argomento.

int hashCode()

Restituisce un valore del 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 valore lungo che rappresenta la versione della tassonomia.

mModelVersion long: un valore long che rappresenta la versione del modello.

mTopicId int: un numero intero che rappresenta l'ID univoco di un argomento.

Metodi pubblici

uguale

Aggiunta nel livello API 34
public boolean equals (Object object)

Indica se un altro oggetto è "uguale" a questo.

Il metodo equals implementa una relazione di equivalenza sui riferimenti a oggetti non null:

  • È riflessiva: per qualsiasi valore di riferimento non nullo x, x.equals(x) deve restituire true.
  • È simmetrica: per qualsiasi valore di riferimento non nullo x e y, x.equals(y) deve restituire true se e solo se y.equals(x) restituisce true.
  • È transitivo: per qualsiasi valore di riferimento non nullo x, y e z, se x.equals(y) restituisce true e y.equals(z) restituisce true, allora x.equals(z) deve restituire true.
  • È coerente: per qualsiasi valore di riferimento non nullo x e y, più invocazioni di x.equals(y) restituiscono in modo coerente true o restituiscono in modo coerente false, a condizione che nessuna informazione utilizzata nei confronti di equals sugli oggetti sia modificata.
  • Per qualsiasi valore di riferimento non null x, x.equals(null) deve restituire false.

Il metodo equals per la classe Object implementa la relazione di equivalenza più discriminante possibile sugli oggetti. In altre parole, 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 viene sostituito, in modo da mantenere il contratto generale per il metodo hashCode, che afferma che gli oggetti uguali devono avere codici hash uguali.

Parametri
object Object: l'oggetto di riferimento con cui eseguire il confronto.

Ritorni
boolean true se questo oggetto è uguale all'argomento obj; altrimenti false.

getModelVersion

public long getModelVersion ()

Recupera la versione del modello.

Ritorni
long

getTaxonomyVersion

public long getTaxonomyVersion ()

Recupera TaxonomyVersion.

Ritorni
long

getTopicId

public int getTopicId ()

Recupera l'ID argomento.

Ritorni
int

hashCode

Aggiunta nel livello API 34
public int hashCode ()

Restituisce un valore del 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 invocato 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 nessuna informazione utilizzata nei confronti equals sull'oggetto venga modificata. Questo numero intero non deve rimanere coerente da un'esecuzione di un'applicazione a un'altra esecuzione della stessa applicazione.
  • Se due oggetti sono uguali in base al metodo equals(Object), l'uso del metodo hashCode 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) , l'uso del metodo hashCode su ciascuno dei due oggetti debba produrre risultati interi distinti. Tuttavia, il programmatore deve essere consapevole che la produzione di risultati interi distinti per oggetti non uguali può migliorare le prestazioni delle tabelle hash.

Per quanto ragionevolmente possibile, il metodo hashCode definito dalla classe Object restituisce 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

Aggiunta nel livello API 34
public String toString ()

Restituisce una rappresentazione di stringa dell'oggetto. In generale, il metodo toString restituisce una stringa che "rappresenta testualmente" questo oggetto. Il risultato dovrebbe essere una rappresentazione concisa ma informativa di facile lettura per l'utente. È consigliabile che tutte le sottoclassi eseguano l'override di questo metodo.

Il metodo toString per la classe Object restituisce una stringa costituita dal nome della classe di cui l'oggetto è un'istanza, dal carattere at "@" e dalla rappresentazione esadecimale non firmata 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.