Il tipo Result
Modelli successo e fallimento
Il tipo Result è una lezione Kotlin Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Kotlin Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Kotlin Academy include 4 lezioni in totale.
Successo o fallimento
Molte operazioni possono fallire. Il tipo Result di Kotlin rappresenta un esito che è un successo contenente un valore oppure un fallimento contenente un'eccezione, senza lanciare eccezioni.
Creare un successo
Racchiuda un valore in un risultato positivo con Result.success(value).
fun main() {
val r: Result<Int> = Result.success(42)
println(r.isSuccess)
println(r.getOrNull())
}Creare un fallimento
Rappresenti un errore con Result.failure(exception). Non viene lanciata alcuna eccezione finché non sceglie di estrarre il valore.
fun main() {
val r: Result<Int> = Result.failure(IllegalStateException("bad"))
println(r.isFailure)
println(r.exceptionOrNull()?.message)
}getOrNull e exceptionOrNull
Esamini un risultato in modo sicuro: getOrNull() restituisce il valore o null, mentre exceptionOrNull() restituisce l'errore o null.
fun main() {
val ok = Result.success("hi")
val bad = Result.failure<String>(RuntimeException("oops"))
println(ok.getOrNull())
println(bad.exceptionOrNull()?.message)
}getOrDefault
Fornisca un valore alternativo per i fallimenti con getOrDefault. È più pulito dei controlli su null quando si dispone di un valore predefinito sensato.
fun main() {
val bad: Result<Int> = Result.failure(Exception())
println(bad.getOrDefault(0))
val ok: Result<Int> = Result.success(7)
println(ok.getOrDefault(0))
}getOrElse
getOrElse calcola il valore alternativo a partire dall'eccezione, consentendo di reagire in modo diverso ai vari errori.
fun main() {
val r: Result<Int> = Result.failure(IllegalArgumentException("nope"))
val value = r.getOrElse { e -> if (e is IllegalArgumentException) -1 else -2 }
println(value)
}getOrThrow
Quando desidera ottenere l'eccezione, getOrThrow() restituisce il valore oppure rilancia l'eccezione memorizzata.
fun main() {
val ok = Result.success(10)
println(ok.getOrThrow())
try {
Result.failure<Int>(IllegalStateException("fail")).getOrThrow()
} catch (e: Exception) {
println("caught: " + e.message)
}
}Restituire un Result
Una funzione può restituire Result per rendere esplicito il fallimento nella propria firma, obbligando i chiamanti a gestire entrambi gli esiti.
fun parse(s: String): Result<Int> {
val n = s.toIntOrNull()
return if (n != null) Result.success(n)
else Result.failure(NumberFormatException(s))
}
fun main() {
println(parse("123").getOrNull())
println(parse("x").exceptionOrNull()?.message)
}Result ed eccezioni
Le eccezioni sono invisibili nelle firme e interrompono il flusso di controllo. Result trasforma il fallimento in un valore che si può passare e trasformare come qualsiasi altro: esplicito, componibile e difficile da ignorare.
Quando usare Result
Usi Result per i fallimenti recuperabili e previsti che desidera far gestire ai chiamanti. Continui a lanciare eccezioni per situazioni realmente eccezionali, come le violazioni dei contratti causate da errori del programmatore.
Un valore, non un salto
Il cambiamento fondamentale è questo: un errore diventa un normale valore restituito. Prossimamente imparerà runCatching, che cattura automaticamente le eccezioni lanciate in un Result.
Verifica rapida
Verifichi la Sua comprensione del tipo Result.
Riepilogo
Ha imparato a usare il tipo Result:
- Creazione con
Result.success/Result.failure - Esame con
getOrNull,exceptionOrNull - Recupero con
getOrDefault,getOrElse,getOrThrow - Restituzione per rendere esplicito il fallimento
Prossimo argomento: runCatching.
Domande Frequenti
La lezione «Il tipo Result» è gratuita?
Sì — il testo completo di «Il tipo Result» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Kotlin Academy, passa a CoddyKit PRO. Il corso Kotlin Academy include 4 lezioni in totale.
Cosa imparerò in «Il tipo Result»?
Modelli successo e fallimento Eserciti Kotlin Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Kotlin Academy?
Non è richiesta alcuna esperienza precedente. Kotlin Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.
Quanto tempo richiede la lezione «Il tipo Result»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Kotlin Academy?
Sì. Ogni lezione Kotlin Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.