Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

AutoCloseable.close(): explicitné a automatické zatváranie zdrojov

`AutoCloseable.close()` uvoľní zdroj. Metódu môžeš zavolať na objekte alebo ju pri opustení bloku nechať automaticky zavolať konštrukciu `try-with-resources`.

Verzia: Java SE 21

Syntax

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() tú istú inštančnú metódu rozhrania java.lang.AutoCloseable. Neprijíma argumenty a nič nevracia (void). Ak chceš zdroj uvoľniť explicitne, zavolaj metódu na objekte: resource.close().

Použi try-with-resources, ak sa má zdroj zatvoriť pri opustení bloku. Java sa pokúsi zatvoriť úspešne inicializované zdroje, ktoré nie sú null, v opačnom poradí inicializácie. Platí to aj vtedy, keď blok vyhodí výnimku alebo sa nepodarí inicializovať ďalší zdroj. Nezatváraj ručne zdroj, ktorý zatvorí ten istý príkaz: AutoCloseable nezaručuje idempotentnosť. Naopak, java.io.Closeable.close() nemá na už zatvorený zdroj žiadny účinok.

Rozhranie deklaruje throws Exception, ale implementácia môže deklarovať konkrétnejšiu kontrolovanú výnimku alebo žiadnu. Pri explicitnom aj automatickom volaní zachyť alebo deklaruj kontrolované výnimky podľa typu zdroja známeho pri kompilácii. Ak výnimku vyhodí blok aj zatváranie, výnimka z bloku zvyčajne zostane hlavná. Výnimku zo zatvárania možno zaznamenať ako potlačenú a získať cez getSuppressed() len vtedy, ak je v hlavnej výnimke povolené potláčanie. Ak nenastala skoršia výnimka, šíri sa výnimka zo zatvárania.

Prí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ýsledok

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

`Subscription` je ukážková trieda, nie súčasť štandardného API. `manual.close()` odstráni len jeden odber. Automatické zatvorenie odstráni dočasný odber a potom vyhodí simulovanú výnimku `IOException`, ktorú zachytí blok `catch`.

Súvisiace lekcie

  • Java · Lekcia 47 · Pokročilá · Verzia: 2
  • Java · Lekcia 52 · Základná · Verzia: 2

Zdroje