WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

AutoCloseable.close(): Ressourcen explizit und automatisch schließen

`AutoCloseable.close()` gibt eine Ressource frei. Du kannst die Methode selbst aufrufen oder sie beim Verlassen des Blocks durch `try-with-resources` aufrufen lassen.

Version: Java SE 21

Syntax

void close() throws Exception;

resource.close();

try (AutoCloseable resource = acquireResource()) {
    // Use the resource here.
} catch (Exception e) {
    // Handle the exception.
}

In Java SE 21 bezeichnen AutoCloseable.close und AutoCloseable.close() dieselbe Instanzmethode von java.lang.AutoCloseable. Sie nimmt keine Argumente entgegen und liefert keinen Rückgabewert (void). Um eine Ressource explizit freizugeben, rufst du die Methode am Objekt auf: resource.close().

Verwende try-with-resources, wenn eine Ressource beim Verlassen eines Blocks geschlossen werden soll. Java versucht, erfolgreich initialisierte Ressourcen, die nicht null sind, in umgekehrter Initialisierungsreihenfolge zu schließen. Das gilt auch, wenn der Block eine Ausnahme auslöst oder die Initialisierung einer späteren Ressource fehlschlägt. Schließe keine Ressource manuell, die dieselbe Anweisung noch schließt: AutoCloseable garantiert keine Idempotenz. Dagegen hat java.io.Closeable.close() bei einer bereits geschlossenen Ressource keine Wirkung.

Die Schnittstelle deklariert throws Exception. Eine Implementierung kann eine spezifischere geprüfte Ausnahme oder gar keine deklarieren. Sowohl beim expliziten als auch beim automatischen Aufruf musst du geprüfte Ausnahmen je nach statischem Typ der Ressource abfangen oder deklarieren. Lösen sowohl der Block als auch das Schließen eine Ausnahme aus, bleibt normalerweise die Ausnahme aus dem Block die primäre. Die Ausnahme beim Schließen kann nur dann als unterdrückt gespeichert und über getSuppressed() abgerufen werden, wenn die Unterdrückung bei der primären Ausnahme aktiviert ist. Liegt keine frühere Ausnahme vor, wird die Ausnahme beim Schließen weitergegeben.

Beispiele

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class Main {
    private static final class Subscription implements AutoCloseable {
        private final List<Subscription> active;
        private final boolean failOnClose;

        Subscription(List<Subscription> active, boolean failOnClose) {
            this.active = active;
            this.failOnClose = failOnClose;
            active.add(this);
        }

        @Override
        public void close() throws IOException {
            if (active.remove(this) && failOnClose) {
                throw new IOException("simulated close failure");
            }
        }
    }

    public static void main(String[] args) {
        List<Subscription> active = new ArrayList<>();

        try (Subscription temporary = new Subscription(active, true)) {
            Subscription manual = new Subscription(active, false);
            System.out.println("Active before manual close: " + active.size());
            manual.close();
            System.out.println("Active after manual close: " + active.size());
        } catch (IOException e) {
            System.out.println("Caught: " + e.getMessage());
        }

        System.out.println("Active after try: " + active.size());
    }
}

Ergebnis

Active before manual close: 2
Active after manual close: 1
Caught: simulated close failure
Active after try: 0

`Subscription` ist eine Beispielklasse und gehört nicht zur Standard-API. `manual.close()` entfernt nur ein Abonnement. Beim automatischen Schließen wird das temporäre Abonnement entfernt und anschließend eine simulierte `IOException` ausgelöst, die der `catch`-Block abfängt.

Zugehörige Lektionen

  • Java · Lektion 47 · Fortgeschritten · Version: 2
  • Java · Lektion 52 · Grundlagen · Version: 2

Quellen