Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

AutoCloseable — zavírání prostředků

java.lang.AutoCloseable definuje smlouvu pro zavírání prostředků pomocí close(). Při použití try-with-resources Java tuto metodu zavolá při opuštění bloku, i kvůli výjimce, a více prostředků zavírá v opačném pořadí.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public interface AutoCloseable {
    void close() throws Exception;
}

try (Resource resource = new Resource()) {
    // Use resource.
}

java.lang.AutoCloseable je rozhraní pro objekty, které mohou uchovávat prostředky vyžadující uvolnění, například popisovače souborů. Samotné implements AutoCloseable zavírání nespustí: objekt musí být spravován pomocí try-with-resources nebo zavřen explicitně.

AutoCloseable.close má signaturu void close() throws Exception. Implementace musí být public a může deklarovat užší výjimku nebo žádnou. Na rozdíl od java.io.Closeable, jehož close() deklaruje IOException, AutoCloseable nevyžaduje idempotenci: opakované zavření může mít vedlejší účinky. Idempotence se přesto doporučuje.

try-with-resources zavírá úspěšně inicializované nenulové prostředky v opačném pořadí, než byly deklarovány, a to i při opuštění bloku pomocí return nebo kvůli výjimce. Pokud blok i close() vyhodí výjimku, vygenerované volání addSuppressed se pokusí připojit výjimku ze zavírání k hlavní výjimce. Pokud blok i close() vyhodí tutéž instanci typu Throwable, toto volání vyhodí IllegalArgumentException, i když je potlačování vypnuté. Pokud se instance liší a potlačování je zapnuté, pole vrácené metodou getSuppressed() na hlavní výjimce obsahuje výjimku ze zavírání. Pokud je potlačování vypnuté, výjimka ze zavírání se nepřipojí a getSuppressed() vrátí prázdné pole.

Příklad simuluje dva prostředky bez přístupu k souborům nebo síti. Nejprve vypíše work, poté close second a close first. Implementace Resource.close() nedeklaruje výjimky, takže main nemusí zpracovávat kontrolovanou výjimku při zavírání.

Příklady

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

Výsledek

work
close second
close first

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje