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

Aggiunto al livello API 34
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 restituire true.
  • È simmetrico: 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, x.equals(z) deve restituire true.
  • È coerente: per tutti i valori di riferimento non null x e y, più chiamate di x.equals(y) restituiscono costantemente true o restituiscono costantemente false, a condizione che nessuna informazione utilizzata nei confronti di equals sugli oggetti venga 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; 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

Aggiunto al livello API 34
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 di equals 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 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), la chiamata del metodo hashCode 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

Aggiunto al livello API 34
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.