Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

AutoCloseable.close(): izrecno in samodejno zapiranje virov

`AutoCloseable.close()` sprosti vir. Metodo lahko pokličeš na objektu ali pa prepustiš samodejni klic ob izhodu iz bloka stavku `try-with-resources`.

Različica: Java SE 21

Sintaksa

void close() throws Exception;

resource.close();

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

V Java SE 21 zapisa AutoCloseable.close in AutoCloseable.close() označujeta isto instančno metodo vmesnika java.lang.AutoCloseable. Metoda ne sprejema argumentov in ne vrača vrednosti (void). Če želiš vir sprostiti izrecno, pokliči metodo na objektu: resource.close().

Uporabi try-with-resources, ko je treba vir zapreti ob izhodu iz bloka. Java poskusi zapreti uspešno inicializirane vire, ki niso null, v obratnem vrstnem redu inicializacije. To velja tudi, če blok sproži izjemo ali inicializacija naslednjega vira ne uspe. Vira, ki ga bo zaprl isti stavek, ne zapiraj ročno: AutoCloseable ne zagotavlja idempotentnosti. Klic java.io.Closeable.close() pa na že zaprtem viru nima učinka.

Vmesnik deklarira throws Exception, izvedba pa lahko deklarira ožjo preverjano izjemo ali nobene. Pri izrecnih in samodejnih klicih preverjane izjeme prestrezi ali deklariraj glede na tip vira, znan ob prevajanju. Če izjemo sprožita tako blok kot zapiranje, izjema iz bloka običajno ostane glavna. Izjemo pri zapiranju je mogoče zabeležiti kot zatrto in jo pridobiti prek getSuppressed() le, če je pri glavni izjemi omogočeno zatiranje. Če pred tem ni bilo izjeme, se izjema pri zapiranju razširi naprej.

Primeri

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());
    }
}

Rezultat

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

`Subscription` je vzorčni razred in ni del standardnega API-ja. `manual.close()` odstrani samo eno naročnino. Samodejno zapiranje odstrani začasno naročnino in nato sproži simulirano izjemo `IOException`, ki jo prestreže blok `catch`.

Povezane lekcije

  • Java · Lekcija 47 · Napredna · Različica: 2
  • Java · Lekcija 52 · Osnovna · Različica: 2

Viri