Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

AutoCloseable — zatváranie prostriedkov

java.lang.AutoCloseable definuje zmluvu na zatváranie prostriedkov pomocou close(). Pri použití try-with-resources Java zavolá túto metódu pri opustení bloku, aj v dôsledku výnimky, a viacero prostriedkov zatvára v opačnom poradí.

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

Syntax

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

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

java.lang.AutoCloseable je rozhranie pre objekty, ktoré môžu uchovávať prostriedky vyžadujúce uvoľnenie, napríklad súborové deskriptory. Samotné implements AutoCloseable zatváranie nespustí: objekt musí byť spravovaný pomocou try-with-resources alebo zatvorený explicitne.

AutoCloseable.close má signatúru void close() throws Exception. Implementácia musí byť public a môže deklarovať užšiu výnimku alebo žiadnu. Na rozdiel od java.io.Closeable, ktorého close() deklaruje IOException, AutoCloseable nevyžaduje idempotentnosť: opätovné zatvorenie môže mať vedľajšie účinky. Idempotentnosť sa napriek tomu odporúča.

try-with-resources zatvára úspešne inicializované nenulové prostriedky v opačnom poradí, než boli deklarované, aj pri opustení bloku pomocou return alebo v dôsledku výnimky. Ak blok aj close() vyhodia výnimku, vygenerované volanie addSuppressed sa pokúsi pripojiť výnimku zo zatvárania k hlavnej výnimke. Ak blok aj close() vyhodia tú istú inštanciu typu Throwable, toto volanie vyhodí IllegalArgumentException, aj keď je potláčanie vypnuté. Ak ide o rôzne inštancie a potláčanie je zapnuté, pole vrátené metódou getSuppressed() na hlavnej výnimke obsahuje výnimku zo zatvárania. Ak je potláčanie vypnuté, výnimka zo zatvárania sa nepripojí a getSuppressed() vráti prázdne pole.

Príklad simuluje dva prostriedky bez prístupu k súborom alebo sieti. Najprv vypíše work, potom close second a close first. Implementácia Resource.close() nedeklaruje výnimky, takže main nemusí spracúvať kontrolovanú výnimku pri zatváraní.

Prí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ýsledok

work
close second
close first

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje