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

CKTIS / Java

AutoCloseable.close(): explicitní a automatické zavírání zdrojů

`AutoCloseable.close()` uvolní zdroj. Metodu můžeš zavolat přímo na objektu nebo ji při opuštění bloku nechat zavolat konstrukci `try-with-resources`.

Verze: Java SE 21

Syntaxe

void close() throws Exception;

resource.close();

try (AutoCloseable resource = acquireResource()) {
    // Use the resource here.
} catch (Exception e) {
    // Handle the exception.
}

V Java SE 21 označují zápisy AutoCloseable.close a AutoCloseable.close() stejnou instanční metodu rozhraní java.lang.AutoCloseable. Nepřijímá žádné argumenty a nic nevrací (void). Chceš-li zdroj uvolnit explicitně, zavolej metodu na objektu: resource.close().

Použij try-with-resources, pokud se má zdroj zavřít při opuštění bloku. Java se pokusí zavřít úspěšně inicializované zdroje, které nejsou null, v opačném pořadí, než byly inicializovány. Platí to i tehdy, když blok vyhodí výjimku nebo se nepodaří inicializovat některý další zdroj. Nezavírej ručně zdroj, který má zavřít stejný příkaz: AutoCloseable nezaručuje idempotenci. Naproti tomu java.io.Closeable.close() nemá na již zavřený zdroj žádný účinek.

Rozhraní deklaruje throws Exception, ale implementace může deklarovat konkrétnější kontrolovanou výjimku nebo žádnou. Při explicitním i automatickém volání kontrolované výjimky zachyť nebo deklaruj podle typu zdroje známého při překladu. Pokud výjimku vyhodí blok i zavírání, výjimka z bloku obvykle zůstává hlavní. Výjimku ze zavírání lze zaznamenat jako potlačenou a získat přes getSuppressed() jen tehdy, je-li u hlavní výjimky povoleno potlačování. Pokud žádná dřívější výjimka neexistuje, šíří se výjimka ze zavírání.

Příklady

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class Main {
    private static final class Subscription implements AutoCloseable {
        private final List<Subscription> active;
        private final boolean failOnClose;

        Subscription(List<Subscription> active, boolean failOnClose) {
            this.active = active;
            this.failOnClose = failOnClose;
            active.add(this);
        }

        @Override
        public void close() throws IOException {
            if (active.remove(this) && failOnClose) {
                throw new IOException("simulated close failure");
            }
        }
    }

    public static void main(String[] args) {
        List<Subscription> active = new ArrayList<>();

        try (Subscription temporary = new Subscription(active, true)) {
            Subscription manual = new Subscription(active, false);
            System.out.println("Active before manual close: " + active.size());
            manual.close();
            System.out.println("Active after manual close: " + active.size());
        } catch (IOException e) {
            System.out.println("Caught: " + e.getMessage());
        }

        System.out.println("Active after try: " + active.size());
    }
}

Výsledek

Active before manual close: 2
Active after manual close: 1
Caught: simulated close failure
Active after try: 0

`Subscription` je ukázková třída, ne součást standardního API. `manual.close()` odstraní jediný odběr. Automatické zavření odstraní dočasný odběr a potom vyhodí simulovanou výjimku `IOException`, kterou zachytí blok `catch`.

Související lekce

  • Java · Lekce 47 · Pokročilá · Verze: 2
  • Java · Lekce 52 · Základní · Verze: 2

Zdroje