CKTIS / Java
Throwable.getMessage(): čítanie podrobnej správy výnimky
Prečítaj správu konkrétnej výnimky, ošetri chýbajúci text a rozlišuj hlavnú výnimku, jej príčiny a potlačené výnimky.
Verzia: Java SE 21
Syntax
public String getMessage()Throwable.getMessage() je inštančná metóda bez parametrov. Volanie e.getMessage() vráti podrobnú správu objektu e ako String alebo vráti null. null nie je prázdny reťazec "". Pred použitím výsledku ako reťazca ho skontroluj. Ak je samotná referencia e rovná null, volanie vyvolá výnimku NullPointerException.
new NullPointerException("name").getMessage() vráti "name". Bez výslovne zadanej správy odlišnej od null môže výsledok závisieť od implementácie alebo byť null. Java SE 21 nezaručuje presné znenie ani to, že sa v správe objaví názov premennej. Zachytená výnimka IllegalArgumentException dedí getMessage() a môže tak vrátiť text odovzdaný konštruktoru.
getCause() vráti objekt predstavujúci príčinu alebo null, ak príčina neexistuje alebo nie je známa. V reťazci bez cyklov postupuj pomocou getCause() až po null a pre každú príčinu zavolaj getMessage(). IllegalArgumentException(String, Throwable) k zadanému textu nepripája správu príčiny. Preťažený konštruktor IllegalArgumentException(Throwable) odvodí správu z cause.toString() alebo použije null, ak je príčina null.
Ak telo príkazu try-with-resources aj metóda close() vyvolajú rôzne výnimky, hlavnou zostáva výnimka z tela. Ak je potláčanie povolené, výnimka zo zatvárania sa objaví v poli vrátenom metódou getSuppressed(), nie v reťazci príčin. Správu každého prvku prečítaj samostatne. Pole je prázdne, ak nebola potlačená žiadna výnimka alebo je potláčanie vypnuté.
getMessage() nevracia výpis zásobníka volaní ani automaticky nepridáva názov triedy. Predvolená implementácia getLocalizedMessage() vracia to isté ako getMessage(), ale podtrieda môže metódu prepísať. Text používaj na diagnostiku, nie ako chybový kód: neriadi ním tok programu a nezobrazuj používateľom neskontrolované interné správy.
Príklady
public class Main {
static final class Resource implements AutoCloseable {
@Override
public void close() {
throw new IllegalStateException("close fail");
}
}
public static void main(String[] args) {
try (Resource resource = new Resource()) {
throw new IllegalArgumentException("primary", new NullPointerException("name"));
} catch (IllegalArgumentException e) {
System.out.println("Caught: " + e.getMessage());
for (Throwable cause = e.getCause(); cause != null; cause = cause.getCause()) {
System.out.println("Cause: " + cause.getMessage());
}
for (Throwable suppressed : e.getSuppressed()) {
System.out.println("Suppressed: " + suppressed.getMessage());
}
}
String message = new IllegalArgumentException().getMessage();
System.out.println("No message: " + (message == null ? "(absent)" : message));
}
}
Výsledok
Caught: primary Cause: name Suppressed: close fail No message: (absent)
Výstup odlišuje správu zachytenej výnimky `IllegalArgumentException` (`primary`), správu jej príčiny (`name`) a správu potlačenej výnimky z `close()` (`close fail`). Na poslednom riadku program nahradí `null` textom `(absent)`.
Súvisiace lekcie
- Java · Lekcia 28 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 29 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 30 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 31 · Stredne pokročilá · Verzia: 2