CKTIS / Java
try-with-resources — automatyczne zamykanie zasobów
Instrukcja try-with-resources automatycznie wywołuje close() dla zasobów AutoCloseable. Wyznacza zakres ich użycia i określa sposób obsługi wyjątków przy zamykaniu.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
try (Resource r = expression) {
// use r
}W zapisie try (Resource r = ...) nazwa Resource oznacza zadeklarowany typ zasobu, który musi być podtypem AutoCloseable. Warunek ten spełnia również sam typ AutoCloseable. Zapis ... zastępuje wyrażenie inicjalizujące. Przy opuszczaniu bloku, także przez return lub wyjątek, Java wywołuje close() dla zasobu różnego od null.
Zasoby oddziela się średnikami. Inicjalizacja przebiega od lewej do prawej, a zamykanie w odwrotnej kolejności. Gdy inicjalizacja zawiedzie, wcześniej zainicjalizowane zasoby zostają zamknięte. Błąd jednego close() nie pomija pozostałych prób zamknięcia.
Zmienna zadeklarowana w nagłówku jest niejawnie final. Można też użyć try (r), jeśli istniejąca zmienna jest wcześniej przypisana i jest final lub efektywnie final, czyli nie jest ponownie przypisywana.
Jeśli blok rzuci wyjątek, staje się on wyjątkiem głównym. Jeśli close() rzuci inny obiekt wyjątku, addSuppressed() zapisze go jako wyjątek tłumiony, dostępny przez getSuppressed(), tylko wtedy, gdy w wyjątku głównym włączono tłumienie. Jeśli tłumienie jest wyłączone, inny wyjątek nie zostanie zapisany. Jeśli close() rzuci ten sam obiekt co blok, addSuppressed() odrzuci próbę dodania wyjątku do niego samego, rzucając IllegalArgumentException, nawet gdy tłumienie jest wyłączone. Wówczas zamiast pierwotnego wyjątku może zostać przekazany IllegalArgumentException. Bez wcześniejszego wyjątku pierwszy wyjątek przy zamykaniu staje się wyjątkiem głównym. Opcjonalne catch i finally wykonują się po próbach zamknięcia; catch może obsłużyć również błędy inicjalizacji i 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 a = new Resource("A");
Resource b = new Resource("B")) {
System.out.println("work");
}
}
}Wynik
work close B close A
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.