CKTIS / Java
AutoCloseable.close(): jawne i automatyczne zamykanie zasobów
`AutoCloseable.close()` zwalnia zasób. Możesz wywołać tę metodę na obiekcie, a `try-with-resources` wywołuje ją automatycznie przy wyjściu z bloku.
Wersja: Java SE 21
Składnia
void close() throws Exception;
resource.close();
try (AutoCloseable resource = acquireResource()) {
// Use the resource here.
} catch (Exception e) {
// Handle the exception.
}W Java SE 21 zapisy AutoCloseable.close i AutoCloseable.close() oznaczają tę samą metodę instancyjną interfejsu java.lang.AutoCloseable. Metoda nie przyjmuje argumentów i nic nie zwraca (void). Aby jawnie zwolnić zasób, wywołaj ją na obiekcie: resource.close().
Użyj try-with-resources, gdy zasób ma być zamknięty wraz z opuszczeniem bloku. Java próbuje zamknąć poprawnie zainicjalizowane zasoby inne niż null w odwrotnej kolejności inicjalizacji, także gdy blok zgłosi wyjątek lub inicjalizacja kolejnego zasobu się nie powiedzie. Nie zamykaj ręcznie zasobu, który ma zamknąć ten sam blok: AutoCloseable nie gwarantuje idempotencji. Natomiast wywołanie java.io.Closeable.close() na już zamkniętym zasobie nie ma skutku.
Interfejs deklaruje throws Exception, ale implementacja może zadeklarować węższy typ wyjątku sprawdzanego lub nie deklarować żadnego. Przy wywołaniu jawnym i automatycznym obsłuż wyjątki sprawdzane w catch lub zadeklaruj je w throws zgodnie z typem zasobu znanym w czasie kompilacji. Gdy zawiodą zarówno blok, jak i zamykanie, wyjątek z bloku zwykle pozostaje główny. Wyjątek z zamykania może zostać zapisany jako stłumiony i odczytany przez getSuppressed() tylko wtedy, gdy tłumienie jest włączone w wyjątku głównym. Jeśli nie było wcześniejszego wyjątku, propagowany jest wyjątek z zamykania.
Przykłady
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());
}
}Wynik
Active before manual close: 2 Active after manual close: 1 Caught: simulated close failure Active after try: 0
`Subscription` to klasa przykładowa, nie część standardowego API. `manual.close()` usuwa tylko jedną subskrypcję. Automatyczne zamknięcie usuwa tymczasową subskrypcję, a następnie zgłasza symulowany `IOException`, który przechwytuje `catch`.
Powiązane lekcje
- Java · Lekcja 47 · Zaawansowany · Wersja: 2
- Java · Lekcja 52 · Podstawowy · Wersja: 2