WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

try-with-resources — automatisches Schließen von Ressourcen

Die try-with-resources-Anweisung ruft für AutoCloseable-Ressourcen automatisch close() auf. Sie legt fest, wie lange die Ressourcen verwendet werden und wie Ausnahmen beim Schließen behandelt werden.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

try (Resource r = expression) {
    // use r
}

In try (Resource r = ...) bezeichnet Resource den deklarierten Typ der Ressource, der ein Untertyp von AutoCloseable sein muss. Der Typ AutoCloseable selbst erfüllt diese Anforderung ebenfalls. Die Zeichenfolge ... steht für einen Initialisierungsausdruck. Beim Verlassen des Blocks, auch durch return oder eine Ausnahme, ruft Java für die Ressource close() auf, sofern sie nicht null ist.

Trenne Ressourcen mit Semikolons. Die Initialisierung erfolgt von links nach rechts, das Schließen in umgekehrter Reihenfolge. Schlägt eine Initialisierung fehl, werden zuvor initialisierte Ressourcen geschlossen. Ein fehlgeschlagenes close() verhindert nicht die übrigen Schließversuche.

Eine im Header deklarierte Variable ist implizit final. Du kannst auch try (r) verwenden, wenn der vorhandenen Variable zuvor ein Wert zugewiesen wurde und sie final oder effektiv final ist, ihr also kein neuer Wert zugewiesen wird.

Wirft der Block eine Ausnahme, wird sie zur primären Ausnahme. Wirft close() ein anderes Ausnahmeobjekt, speichert addSuppressed() es nur dann als unterdrückte Ausnahme, wenn die Unterdrückung für die primäre Ausnahme aktiviert ist. Die gespeicherte Ausnahme ist über getSuppressed() abrufbar. Bei deaktivierter Unterdrückung wird das andere Ausnahmeobjekt nicht gespeichert. Wirft close() dasselbe Ausnahmeobjekt wie der Block, weist addSuppressed() den Versuch, die Ausnahme sich selbst hinzuzufügen, mit einer IllegalArgumentException zurück, auch bei deaktivierter Unterdrückung. Die IllegalArgumentException kann dann anstelle der ursprünglichen Ausnahme weitergegeben werden. Liegt keine frühere Ausnahme vor, wird die erste Ausnahme beim Schließen zur primären Ausnahme. Optionale catch- und finally-Klauseln werden nach den Schließversuchen ausgeführt; catch kann auch Fehler bei der Initialisierung und beim Schließen behandeln.

Beispiele

public class Main {
    static final class Resource implements AutoCloseable {
        private final String name;

        Resource(String name) {
            this.name = name;
        }

        @Override
        public void close() {
            System.out.println("close " + name);
        }
    }

    public static void main(String[] args) {
        try (Resource a = new Resource("A");
             Resource b = new Resource("B")) {
            System.out.println("work");
        }
    }
}

Ergebnis

work
close B
close A

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen