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

CKTIS / Java

AutoCloseable — zapiranje virov

java.lang.AutoCloseable določa pogodbo za zapiranje virov z metodo close(). Pri uporabi try-with-resources Java to metodo pokliče ob izhodu iz bloka, tudi zaradi izjeme, več virov pa zapre v obratnem vrstnem redu.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

public interface AutoCloseable {
    void close() throws Exception;
}

try (Resource resource = new Resource()) {
    // Use resource.
}

java.lang.AutoCloseable je vmesnik za objekte, ki lahko hranijo vire, ki jih je treba sprostiti, na primer datotečne ročice. Zgolj zapis implements AutoCloseable ne sproži zapiranja: objekt mora upravljati try-with-resources ali pa ga je treba zapreti izrecno.

AutoCloseable.close ima podpis void close() throws Exception. Implementacija mora biti public in lahko deklarira ožjo izjemo ali pa nobene. V nasprotju z java.io.Closeable, katerega close() deklarira IOException, AutoCloseable ne zahteva idempotentnosti: ponovno zapiranje ima lahko stranske učinke. Idempotentnost je kljub temu priporočena.

try-with-resources zapre uspešno inicializirane vire, ki niso null, v obratnem vrstnem redu deklaracij, tudi ob izhodu z return ali zaradi izjeme. Če tako blok kot close() vržeta izjemo, samodejno ustvarjeni klic addSuppressed poskuša izjemo pri zapiranju dodati glavni izjemi. Če oba vržeta isti primerek tipa Throwable, ta klic vrže IllegalArgumentException, tudi če je zatiranje izjem onemogočeno. Če sta primerka različna in je zatiranje omogočeno, polje, ki ga vrne getSuppressed() na glavni izjemi, vsebuje izjemo pri zapiranju. Če je zatiranje onemogočeno, se izjema pri zapiranju ne doda in getSuppressed() vrne prazno polje.

Primer simulira dva vira brez dostopa do datotek ali omrežja. Najprej izpiše work, nato close second in close first. Implementacija Resource.close() ne deklarira izjem, zato v main ni treba obravnavati preverjene izjeme pri zapiranju.

Primeri

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 first = new Resource("first");
             Resource second = new Resource("second")) {
            System.out.println("work");
        }
    }
}

Rezultat

work
close second
close first

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri