Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła