WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

AutoCloseable — Ressourcen schließen

java.lang.AutoCloseable definiert mit close() einen Vertrag zum Schließen von Ressourcen. Bei try-with-resources ruft Java diese Methode beim Verlassen des Blocks auf, auch wegen einer Ausnahme, und schließt mehrere Ressourcen in umgekehrter Reihenfolge.

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

Syntax

public interface AutoCloseable {
    void close() throws Exception;
}

try (Resource resource = new Resource()) {
    // Use resource.
}

java.lang.AutoCloseable ist eine Schnittstelle für Objekte, die Ressourcen enthalten können, die freigegeben werden müssen, etwa Dateihandles. Allein implements AutoCloseable löst das Schließen nicht aus: Das Objekt muss mit try-with-resources verwaltet oder ausdrücklich geschlossen werden.

AutoCloseable.close hat die Signatur void close() throws Exception. Eine Implementierung muss public sein und kann eine engere Ausnahme oder gar keine deklarieren. Anders als java.io.Closeable, dessen close() IOException deklariert, verlangt AutoCloseable keine Idempotenz: Ein erneutes Schließen kann Nebenwirkungen haben. Idempotenz wird dennoch empfohlen.

try-with-resources schließt erfolgreich initialisierte, nicht-null Ressourcen in umgekehrter Deklarationsreihenfolge, auch beim Verlassen durch return oder eine Ausnahme. Wenn sowohl der Block als auch close() eine Ausnahme werfen, versucht der generierte Aufruf von addSuppressed, die Ausnahme beim Schließen an die primäre Ausnahme anzuhängen. Werfen beide dieselbe Throwable-Instanz, wirft dieser Aufruf IllegalArgumentException, auch wenn die Unterdrückung deaktiviert ist. Sind die Instanzen verschieden und ist die Unterdrückung aktiviert, enthält das Ergebnis von getSuppressed() auf der primären Ausnahme auch die Ausnahme beim Schließen. Ist die Unterdrückung deaktiviert, wird die Ausnahme beim Schließen nicht angehängt und getSuppressed() gibt ein leeres Array zurück.

Das Beispiel simuliert zwei Ressourcen ohne Zugriff auf Dateien oder Netzwerk. Es gibt zuerst work aus, danach close second und close first. Die Implementierung von Resource.close() deklariert keine Ausnahmen, daher muss main keine geprüfte Schließausnahme 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 first = new Resource("first");
             Resource second = new Resource("second")) {
            System.out.println("work");
        }
    }
}

Ergebnis

work
close second
close first

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