CKTIS / Java
AutoCloseable — zamykanie zasobów
java.lang.AutoCloseable określa kontrakt zamykania zasobu przez close(). W try-with-resources Java wywołuje tę metodę przy opuszczaniu bloku, również wskutek wyjątku, a wiele zasobów zamyka w odwrotnej kolejności.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable to interfejs dla obiektów, które mogą przechowywać zasoby wymagające zwolnienia, np. uchwyty plików. Samo implements AutoCloseable nie uruchamia zamykania: obiekt musi być zarządzany przez try-with-resources albo zamknięty jawnie.
AutoCloseable.close ma sygnaturę void close() throws Exception. Implementacja musi być public i może deklarować węższy wyjątek albo nie deklarować żadnego. W odróżnieniu od java.io.Closeable, którego close() deklaruje IOException, AutoCloseable nie wymaga idempotencji: ponowne zamknięcie może mieć skutki uboczne. Idempotencja jest jednak zalecana.
try-with-resources zamyka poprawnie zainicjalizowane zasoby różne od null w odwrotnej kolejności deklaracji, także przy wyjściu przez return lub wyjątek. Jeśli blok i close() zgłoszą wyjątki, wygenerowane wywołanie addSuppressed próbuje dołączyć wyjątek zamykania do wyjątku głównego. Jeśli blok i close() zgłoszą tę samą instancję Throwable, wywołanie to zgłosi IllegalArgumentException, nawet gdy tłumienie wyjątków jest wyłączone. Jeśli instancje są różne i tłumienie jest włączone, wyjątek zamykania można odczytać przez getSuppressed() na wyjątku głównym. Jeśli tłumienie jest wyłączone, wyjątek zamykania nie zostaje dołączony, a getSuppressed() zwraca pustą tablicę.
Przykład symuluje dwa zasoby bez dostępu do plików ani sieci. Najpierw wypisuje work, następnie close second i close first. Implementacja Resource.close() nie deklaruje wyjątków, więc main nie potrzebuje obsługi sprawdzanego wyjątku zamykania.
Przykłady
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");
}
}
}Wynik
work close second close first
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.