Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
Résumé : Constructeurs | Méthodes | Méthodes héritées

Topic

public final class Topic
extends Object

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

Représente le résultat du thème grâce à l'API getTopics.

Résumé

Constructeurs publics

Topic(long mTaxonomyVersion, long mModelVersion, int mTopicId)

Crée un objet qui représente le résultat de l'API getTopics.

Méthodes publiques

boolean equals(Object object)

Indique si un autre objet est "égal à" celui-ci.

long getModelVersion()

Permet d'obtenir la version du modèle.

long getTaxonomyVersion()

Permet d'obtenir la version de la taxonomie.

int getTopicId()

Permet d'obtenir l'ID du thème.

int hashCode()

Renvoie une valeur de code de hachage pour l'objet.

String toString()

Renvoie une représentation de l'objet sous forme de chaîne.

Méthodes héritées

Constructeurs publics

Topic

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4 
public Topic (long mTaxonomyVersion, 
                long mModelVersion, 
                int mTopicId)

Crée un objet qui représente le résultat de l'API getTopics.

Paramètres
mTaxonomyVersion long : entier long représentant la version de la taxonomie.
mModelVersion long : entier long représentant la version du modèle.
mTopicId int : entier représentant l'identifiant unique d'un thème.

Méthodes publiques

égal à

Ajouté au niveau d'API 34 
public boolean equals (Object object)

Indique si un autre objet est "égal à" celui-ci.

La méthode equals implémente une relation d'équivalence sur les références d'objets non nulles :

  • Elle est réfléchie : pour toute valeur de référence non nulle x, x.equals(x) doit renvoyer true.
  • Elle est symétrique : pour toutes les valeurs de référence non nulles x et y, x.equals(y) doit renvoyer true si et seulement si y.equals(x) renvoie true.
  • Elle est transitive : pour toutes les valeurs de référence non nulles x, y et z, si x.equals(y) renvoie true et y.equals(z) renvoie true, alors x.equals(z) doit renvoyer true.
  • Elle est cohérente : pour toutes les valeurs de référence non nulles x et y, plusieurs invocations de x.equals(y) renvoient systématiquement true ou false, à condition qu'aucune information utilisée dans les comparaisons equals sur les objets ne soit modifiée.
  • Pour toute valeur de référence non nulle x, x.equals(null) doit renvoyer false.

La méthode equals pour la classe Object (objet) implémente la relation d'équivalence la plus discriminatoire possible sur les objets, c'est-à-dire que pour toute valeur de référence non nulle x et y, cette méthode renvoie true si et seulement si x et y font référence au même objet (x == y a la valeur true).

Notez qu'il est généralement nécessaire de remplacer la méthode hashCode chaque fois que cette méthode est ignorée, afin de conserver le contrat général pour la méthode hashCode, qui stipule que les objets égaux doivent avoir le même code de hachage.

Paramètres
object Object : objet de référence à comparer.
Renvoie
boolean true si cet objet est identique à l'argument obj ; false dans les autres cas.

getModelVersion

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4 
public long getModelVersion ()

Permet d'obtenir la version du modèle.

Renvoie
long

getTaxonomyVersion

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4 
public long getTaxonomyVersion ()

Permet d'obtenir la version de la taxonomie.

Renvoie
long

getTopicId

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4 
public int getTopicId ()

Permet d'obtenir l'ID du thème.

Renvoie
int

hashCode

Ajouté au niveau d'API 34 
public int hashCode ()

Renvoie une valeur de code de hachage pour l'objet. Cette méthode est compatible avec les tables de hachage, telles que celles fournies par HashMap.

Le contrat général de hashCode est le suivant :

  • Chaque fois qu'elle est appelée plusieurs fois sur le même objet lors de l'exécution d'une application Java, la méthode hashCode doit toujours renvoyer le même entier, à condition qu'aucune information utilisée dans les comparaisons equals de l'objet ne soit modifiée. Cet entier n'a pas besoin de rester cohérent d'une exécution de l'application à une autre.
  • Si deux objets sont égaux selon la méthode equals(Object), alors l'appel de la méthode hashCode sur chacun des deux objets doit produire le même résultat entier.
  • Si deux objets ne sont pas égaux selon la méthode equals(java.lang.Object), il n'est pas nécessaire que l'appel de la méthode hashCode sur chacun des deux objets produise des résultats entiers distincts. Toutefois, le programmeur doit savoir que la génération de résultats entiers distincts pour les objets inégaux peut améliorer les performances des tables de hachage.

Dans la mesure du possible, la méthode hashCode définie par la classe Object affiche des entiers distincts pour des objets distincts. Notez que le hachage hashCode peut être implémenté ou non en tant que fonction de l'adresse mémoire d'un objet à un moment donné.

Renvoie
int Une valeur de code de hachage pour cet objet.

toString

Ajouté au niveau d'API 34 
public String toString ()

Renvoie une représentation de l'objet sous forme de chaîne. En général, la méthode toString renvoie une chaîne qui "représente textuellement" cet objet. Le résultat doit être une représentation concise, mais informative, et facile à lire. Il est recommandé que toutes les sous-classes remplacent cette méthode.

La méthode toString pour la classe Object renvoie une chaîne composée du nom de la classe dont l'objet est une instance, du caractère arobase "@", ainsi que de la représentation hexadécimale non signée du code de hachage de l'objet. En d'autres termes, cette méthode renvoie une chaîne égale à la valeur de : 

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

Valeur affichée
String une représentation de l'objet sous forme de chaîne.