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

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.

Zdroje