java.lang.IllegalArgumentException: Failed requirement.
O verificare require(...) din cod a primit false: o funcție a fost apelată cu un argument invalid (o sumă negativă, o listă goală). Repară apelul ca să trimită date valide sau tratează cazul înainte de apel. Pune un mesaj în require ca eroarea să spună ce e greșit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
require(conditie) este felul în care o funcție își verifică argumentele. Dacă condiția e falsă, aruncă java.lang.IllegalArgumentException: Failed requirement.. Mesajul generic apare când require n-are mesaj propriu; cu require(suma > 0) { "Suma trebuie să fie pozitivă" } primești textul tău în locul lui.
Ruda lui, check(conditie), verifică starea obiectului (nu argumentele) și aruncă java.lang.IllegalStateException: Check failed.. requireNotNull(x) aruncă IllegalArgumentException: Required value was null., iar error("mesaj") aruncă direct IllegalStateException cu mesajul dat.
Excepția nu e o greșeală a lui require, ci un semnal: cineva a apelat funcția cu date pe care ea nu le acceptă. Stiva arată două linii utile: funcția cu require și locul de unde a fost apelată. Repari de obicei apelul, nu verificarea.
De ce apare: cauzele frecvente
1Apel cu o valoare invalidă
fun retrage(sold: Int, suma: Int): Int {
require(suma > 0)
return sold - suma
}
fun main() {
println(retrage(100, -20))
}fun retrage(sold: Int, suma: Int): Int {
require(suma > 0) { "Suma trebuie sa fie pozitiva: $suma" }
return sold - suma
}
fun main() {
println(retrage(100, 20))
}Apelul trimite acum o sumă validă, iar mesajul din require ar explica problema dacă s-ar repeta.
2check pe o stare greșită
class Comanda {
var platita = false
fun livreaza() {
check(platita)
println("Livrata")
}
}
fun main() {
Comanda().livreaza()
}class Comanda {
var platita = false
fun livreaza() {
check(platita) { "Comanda nu e platita" }
println("Livrata")
}
}
fun main() {
val c = Comanda()
c.platita = true
c.livreaza()
}check aruncă IllegalStateException: Check failed. dacă obiectul nu e în starea potrivită. Ordinea corectă a pașilor o rezolvă.
Repară eroarea, direct în pagină
Programul de mai jos aplică o reducere procentuală, dar se oprește cu IllegalArgumentException: Failed requirement., pentru că reducerea este scrisă ca fracție (0.15) în loc de procent. Repară apelul ca reducerea să fie 15%, iar programul să afișeze Pret final: 85.0.
fun aplicaReducere(pret: Double, procent: Double): Double {
require(procent >= 1 && procent <= 100)
return pret - pret * procent / 100
}
fun main() {
println("Pret final: ${aplicaReducere(100.0, 0.15)}")
}Pret final: 85.0
Indiciu
Funcția cere un procent între 1 și 100; trimite 15, nu 0.15.
Reparația
fun aplicaReducere(pret: Double, procent: Double): Double {
require(procent >= 1 && procent <= 100) { "Procent invalid: $procent" }
return pret - pret * procent / 100
}
fun main() {
println("Pret final: ${aplicaReducere(100.0, 15.0)}")
}De ce merge
require protejează funcția de valori fără sens: aici, procentul trebuie să fie între 1 și 100. Apelul trimitea 0.15, adică o fracție, iar verificarea a oprit programul. Cu 15.0 reducerea e corectă: 100 - 15 = 85.0. Am adăugat și un mesaj în require, ca o greșeală viitoare să arate Procent invalid: 0.15 în loc de Failed requirement..
Alte forme ale mesajului
java.lang.IllegalStateException: Check failed.java.lang.IllegalArgumentException: Required value was null.Exception in thread "main" java.lang.IllegalArgumentException: Failed requirement.
Cum o eviți pe viitor
Scrie întotdeauna un mesaj în require și check, cu valoarea problematică: require(varsta >= 0) { "Varsta invalida: $varsta" }. Validează datele externe (input, fișiere) la intrare, înainte să ajungă la funcțiile care le verifică. Folosește require pentru argumente, check pentru starea obiectului și error() pentru cazuri care n-ar trebui să apară niciodată.
Întrebări frecvente
Ce diferență e între require și check?
require verifică argumentele primite și aruncă IllegalArgumentException. check verifică starea obiectului sau a programului și aruncă IllegalStateException. Ambele primesc un mesaj opțional în acolade.
E mai bine să prind excepția cu try/catch?
Doar acolo unde poți face ceva util (de exemplu să afișezi un mesaj utilizatorului). De obicei e mai bine să verifici datele înainte de apel, ca excepția să nu apară deloc.
Erori înrudite
java.lang.ArithmeticException: / by zero Ai împărțit un număr întreg (Int sau Long) la 0, cu / sau %. Împărțirea întreagă la zero nu are rezultat, deci programul se oprește. Verifică împărțitorul înainte (if (n == 0) ...) sau tratează cazul cu o valoare implicită. java.lang.NumberFormatException: For input string: "abc" Ai apelat toInt() (sau toDouble(), toLong()) pe un text care nu e un număr valid: "abc", "12.5" pentru Int, "" sau " 7" cu spații. Folosește toIntOrNull() și tratează null, sau curăță textul înainte (trim()). kotlin.NotImplementedError: An operation is not implemented. Programul a ajuns la un TODO() din cod: o funcție sau o ramură lăsată neterminată. TODO() aruncă intenționat NotImplementedError. Scrie implementarea reală în locul lui TODO(); IntelliJ și Android Studio pun des TODO în codul generat automat. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
