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.