CKTIS / Java
AutoCloseable.close(): Ressourcen automatisch schließen
`close()` gibt die Ressourcen eines Objekts frei. Eine try-with-resources-Anweisung ruft die Methode automatisch auf; das Interface verlangt aber nicht, dass ein erneuter Aufruf wirkungslos bleibt.
Version: Java SE 21
Syntax
void close() throws Exception;
// In a class implementing AutoCloseable, when closing needs no checked exception:
@Override
public void close() { /* release the resource */ }
// With an already initialized final or effectively final resource variable:
try (resource) {
// use the resource
}AutoCloseable.close ist die parameterlose Methode des Interfaces java.lang.AutoCloseable. Sie liefert keinen Rückgabewert (void), sondern schließt das Objekt und gibt die von ihm verwalteten Ressourcen frei. Die Deklaration throws Exception erlaubt bei einem Fehler beim Schließen eine geprüfte Ausnahme. Eine überschreibende Methode darf einen spezifischeren Ausnahmetyp oder gar keine geprüfte Ausnahme deklarieren. Bei einem manuellen Aufruf über eine Referenz vom Typ AutoCloseable muss Exception abgefangen oder deklariert werden, auch wenn die konkrete Implementierung sie nicht deklariert.
Eine try-with-resources-Anweisung ruft close() für erfolgreich initialisierte Ressourcen ungleich null in umgekehrter Initialisierungsreihenfolge auf. Das geschieht sowohl beim normalen Verlassen des Blocks als auch bei einer Ausnahme im Block. Werfen der Block und close() unterschiedliche Throwable-Instanzen, bleibt die Ausnahme aus dem Block die primäre. Ist für sie die Unterdrückung aktiviert, wird die Ausnahme vom Schließen als unterdrückte Ausnahme hinzugefügt und ist über getSuppressed() abrufbar. Werfen der Block und close() exakt dieselbe Throwable-Instanz, versucht der implizite Aufruf von addSuppressed(), die Ausnahme sich selbst als unterdrückte Ausnahme hinzuzufügen. Dabei wirft addSuppressed() eine IllegalArgumentException, die anstelle der ursprünglichen Ausnahme weitergegeben wird. Endet der Block normal, kann eine Ausnahme beim Schließen weitergegeben werden.
Idempotenz bedeutet hier, dass ein weiterer Aufruf von close() nach dem Schließen keine zusätzliche Wirkung hat. AutoCloseable empfiehlt das, schreibt es aber nicht vor. java.io.Closeable erweitert dagegen AutoCloseable, verlangt Wirkungslosigkeit nach dem Schließen und deklariert IOException statt Exception. Im Beispiel sorgt MemoryBuffer für Idempotenz: Der erste Aufruf entfernt die Referenz auf das Array, weitere Aufrufe kehren sofort zurück. Das Entfernen der Referenz erzwingt keine sofortige Speicherbereinigung.
Beispiele
public class Main {
private static final class MemoryBuffer implements AutoCloseable {
private int[] data = {42};
int read() {
if (data == null) {
throw new IllegalStateException("Buffer is closed");
}
return data[0];
}
@Override
public void close() {
if (data == null) {
return;
}
data = null;
System.out.println("Buffer closed");
}
}
public static void main(String[] args) {
MemoryBuffer buffer = new MemoryBuffer();
try (buffer) {
System.out.println("Value: " + buffer.read());
}
buffer.close();
System.out.println("Done");
}
}Ergebnis
Value: 42 Buffer closed Done
`buffer` wird nie neu zugewiesen, ist also effektiv final und kann in `try (buffer)` verwendet werden. Beim automatischen Schließen erscheint `Buffer closed`; der spätere manuelle Aufruf von `buffer.close()` hat keine Wirkung.
Zugehörige Lektionen
- Java · Lektion 31 · Mittlere Stufe · Version: 2