CKTIS / Java
try-with-resources — automatické zavírání prostředků
Příkaz try-with-resources automaticky volá close() na prostředcích AutoCloseable. Určuje dobu jejich používání a způsob zpracování výjimek při zavírání.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
try (Resource r = expression) {
// use r
}V zápisu try (Resource r = ...) označuje Resource deklarovaný typ prostředku, který musí být podtypem AutoCloseable. Tuto podmínku splňuje i samotný typ AutoCloseable. Zápis ... představuje inicializační výraz. Při opuštění bloku, ať už příkazem return, nebo v důsledku výjimky, Java zavolá close() na prostředku, pokud není null.
Prostředky oddělujte středníky. Inicializace probíhá zleva doprava, zavírání v opačném pořadí. Pokud inicializace selže, dříve inicializované prostředky se zavřou. Selhání jednoho close() nezabrání ostatním pokusům o zavření.
Proměnná deklarovaná v hlavičce je implicitně final. Můžete také použít try (r), pokud byla existující proměnné předem přiřazena hodnota a proměnná je final nebo efektivně final, tedy se jí znovu nepřiřazuje hodnota.
Pokud blok vyhodí výjimku, stane se z ní hlavní výjimka. Vyhodí-li close() jiný objekt výjimky, addSuppressed() ho zaznamená jako potlačenou výjimku dostupnou prostřednictvím getSuppressed(), ale pouze pokud je u hlavní výjimky potlačování povoleno. Je-li vypnuto, odlišná výjimka při zavírání se nezaznamená. Vyhodí-li close() tentýž objekt výjimky jako blok, addSuppressed() odmítne přidat výjimku k ní samotné a vyhodí IllegalArgumentException, a to i při vypnutém potlačování. Místo původní výjimky se pak může šířit IllegalArgumentException. Pokud žádná dřívější výjimka nenastala, první výjimka při zavírání se stane hlavní výjimkou. Volitelné klauzule catch a finally se provedou po pokusech o zavření; catch může zpracovat také chyby inicializace a 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 a = new Resource("A");
Resource b = new Resource("B")) {
System.out.println("work");
}
}
}Výsledek
work close B close A
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.