Cosa restituisce esattamente il gestore onComplete dopo il completamento dell'operazione?

Il gestore onComplete in Android, ad esempio nel contesto di Task di Firebase o altre operazioni asincrone, viene chiamato dopo il completamento dell'operazione e restituisce un oggetto Task<T>. Questo oggetto contiene informazioni sul risultato dell'operazione: se è riuscita, se si è verificato un errore e, in caso di successo, il risultato stesso.

Esempio di utilizzo:

someTask.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // Ottieni il risultato
        T result = task.getResult();
    } else {
        // Gestione dell'errore
        Exception e = task.getException();
    }
});

Pertanto, onComplete non restituisce direttamente il risultato, ma fornisce un oggetto Task dal quale è possibile ottenere lo stato e i dati dell'operazione.