Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

AutoCloseable.close(): automatyczne zamykanie zasobów

Metoda `close()` zwalnia zasoby obiektu. Konstrukcja `try`-with-resources wywołuje ją automatycznie, ale sam interfejs nie wymaga, by ponowne zamknięcie było bez skutku.

Wersja: Java SE 21

Składnia

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 to bezargumentowa metoda interfejsu java.lang.AutoCloseable. Nie zwraca wartości (void); zamyka obiekt i zwalnia zasoby, którymi on zarządza. Deklaracja throws Exception pozwala zgłosić sprawdzany wyjątek przy zamykaniu. Implementacja może zadeklarować węższy typ wyjątku albo nie deklarować żadnego sprawdzanego wyjątku. Przy ręcznym wywołaniu przez referencję typu AutoCloseable trzeba przechwycić lub zadeklarować Exception, nawet jeśli konkretna implementacja go nie deklaruje.

Konstrukcja try-with-resources automatycznie wywołuje close() dla poprawnie zainicjalizowanych zasobów innych niż null, w odwrotnej kolejności inicjalizacji. Dzieje się tak przy normalnym opuszczeniu bloku i wtedy, gdy blok zgłosi wyjątek. Jeśli blok i close() zgłoszą różne instancje Throwable, wyjątek z bloku pozostaje główny. Jeżeli ma włączone tłumienie wyjątków, wyjątek z zamykania jest do niego dodawany jako tłumiony i można go odczytać przez getSuppressed(). Jeśli blok i close() zgłoszą dokładnie tę samą instancję Throwable, wywołanie addSuppressed() próbuje dodać wyjątek jako tłumiony do niego samego. Zamiast pierwotnego wyjątku przekazywany jest wtedy dalej IllegalArgumentException zgłoszony przez addSuppressed(). Jeśli blok zakończy się normalnie, wyjątek z zamykania może zostać przekazany dalej.

Idempotencja oznacza tu, że po zamknięciu kolejne wywołanie close() nie ma dodatkowego skutku. AutoCloseable to zaleca, ale tego nie wymaga. Natomiast java.io.Closeable rozszerza AutoCloseable, wymaga braku skutku po zamknięciu i deklaruje IOException zamiast Exception. W przykładzie to MemoryBuffer zapewnia idempotencję: pierwsze zamknięcie usuwa referencję do tablicy, a kolejne od razu kończy metodę. Usunięcie referencji nie wymusza natychmiastowego odzyskania pamięci.

Przykłady

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");
    }
}

Wynik

Value: 42
Buffer closed
Done

Zmienna `buffer` nie jest ponownie przypisywana, więc jest efektywnie finalna i można użyć `try (buffer)`. Automatyczne zamknięcie wypisuje `Buffer closed`, a późniejsze ręczne wywołanie `buffer.close()` nic nie robi.

Powiązane lekcje

  • Java · Lekcja 31 · Średniozaawansowany · Wersja: 2

Źródła