CKTIS / Java
Throwable.getMessage(): branje podrobnega sporočila izjeme
Preberi sporočilo določene izjeme, obravnavaj manjkajoče sporočilo ter loči glavno izjemo od njenih vzrokov in potlačenih izjem.
Različica: Java SE 21
Sintaksa
public String getMessage()Throwable.getMessage() je metoda primerka brez parametrov. Klic e.getMessage() vrne podrobno sporočilo objekta e kot String ali pa vrne null. null ni prazen niz "". Rezultat preveri, preden ga uporabiš kot niz. Če je sama referenca e enaka null, klic sproži NullPointerException.
new NullPointerException("name").getMessage() vrne "name". Če sporočilo, različno od null, ni izrecno podano, je rezultat lahko odvisen od implementacije ali pa je null. Java SE 21 ne zagotavlja natančnega besedila niti tega, da bo navedeno ime spremenljivke. Prestrezena izjema IllegalArgumentException podeduje getMessage() in tako lahko vrne besedilo, podano konstruktorju.
getCause() vrne objekt, ki predstavlja vzrok, ali null, če vzroka ni ali ni znan. V verigi brez ciklov sledi vzrokom z getCause(), dokler ne dobiš null, in na vsakem vzroku pokliči getMessage(). IllegalArgumentException(String, Throwable) sporočila vzroka ne pripne podanemu besedilu. Preobremenjena različica IllegalArgumentException(Throwable) sporočilo izpelje iz cause.toString() ali uporabi null, če je vzrok null.
Če telo stavka try-with-resources in metoda close() sprožita različni izjemi, ostane glavna izjema tista iz telesa stavka. Če je potlačevanje omogočeno, je izjema pri zapiranju v tabeli, ki jo vrne getSuppressed(), in ne v verigi vzrokov. Preberi sporočilo vsakega elementa posebej. Tabela je prazna, če ni bila potlačena nobena izjema ali če je potlačevanje onemogočeno.
getMessage() ne vrne sledi sklada in ne doda samodejno imena razreda. Privzeto getLocalizedMessage() vrne isto kot getMessage(), vendar jo podrazred lahko prepiše. Besedilo uporabi za diagnostiko, ne kot kodo napake: nanj ne veži poteka programa in uporabnikom ne prikazuj nepreverjenih internih sporočil.
Primeri
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));
}
}
Rezultat
Caught: primary Cause: name Suppressed: close fail No message: (absent)
Izpis loči sporočilo prestrežene izjeme `IllegalArgumentException` (`primary`), sporočilo njenega vzroka (`name`) in sporočilo potlačene izjeme iz `close()` (`close fail`). V zadnji vrstici program namesto `null` izpiše `(absent)`.
Povezane lekcije
- Java · Lekcija 28 · Srednja · Različica: 2
- Java · Lekcija 29 · Srednja · Različica: 2
- Java · Lekcija 30 · Srednja · Različica: 2
- Java · Lekcija 31 · Srednja · Različica: 2