Que retourne exactement le gestionnaire onComplete après la fin de l'opération?

Le gestionnaire onComplete en Android, par exemple dans le contexte de Task de Firebase ou d'autres opérations asynchrones, est appelé après la fin de l'opération et renvoie un objet Task<T>. Cet objet contient des informations sur le résultat de l'opération : si elle a réussi, s'il y a eu une erreur, et si oui, le résultat lui-même.

Exemple d'utilisation :

someTask.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // Récupérer le résultat
        T result = task.getResult();
    } else {
        // Gestion de l'erreur
        Exception e = task.getException();
    }
});

Ainsi, onComplete ne retourne pas directement le résultat, mais fournit un objet Task à partir duquel on peut obtenir le statut et les données de l'opération.