AdSelectionOutcome

public class AdSelectionOutcome
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionOutcome


Cette classe représente un champ de OutcomeReceiver, qui est une entrée de AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) dans AdSelectionManager. Ce champ est renseigné dans la le cas d'un appel AdSelectionManager#selectAds réussi.

Un résultat vide peut être renvoyé par AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver). Utilisez AdSelectionOutcome#hasOutcome() pour vérifier si une instance a un résultat valide. Lorsque hasOutcome() renvoie false, les résultats de #getAdSelectionId() et AdSelectionOutcome#getRenderUri() ne sont pas valides et ne doivent pas être utilisé.

Résumé

Classes imbriquées

class AdSelectionOutcome.Builder

Compilateur pour les objets AdSelectionOutcome

Champs

public static final AdSelectionOutcome NO_OUTCOME

Représente un élément AdSelectionOutcome avec des résultats vides.

Méthodes publiques

boolean equals(Object o)

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

long getAdSelectionId()

Renvoie l'élément adSelectionId qui identifie l'élément AdSelection.

Uri getRenderUri()

Renvoie l'élément RenderUri renvoyé par l'élément AdSelection.

boolean hasOutcome()

Indique si le résultat contient des résultats ou s'il est vide.

int hashCode()

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

Méthodes héritées

Champs

AUCUN_RÉSULTAT

public static final AdSelectionOutcome NO_OUTCOME

Représente un élément AdSelectionOutcome avec des résultats vides.

Méthodes publiques

égal à

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

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
o Object : objet de référence à comparer.

Renvoie
boolean true si cet objet est identique à l'argument obj ; false dans les autres cas.

getAdSelectionId

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public long getAdSelectionId ()

Renvoie l'élément adSelectionId qui identifie l'élément AdSelection.

Renvoie
long Cette valeur ne peut pas être null.

getRenderUri

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public Uri getRenderUri ()

Renvoie l'élément RenderUri renvoyé par l'élément AdSelection.

Renvoie
Uri Cette valeur ne peut pas être null.

hasResults

public boolean hasOutcome ()

Indique si le résultat contient des résultats ou s'il est vide. Résultats vides render uris ne doivent pas être utilisées.

Renvoie
boolean

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.