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.