Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

AutoCloseable — zatvaranje resursa

java.lang.AutoCloseable definira ugovor za zatvaranje resursa metodom close(). Uz try-with-resources Java poziva tu metodu pri izlasku iz bloka, uključujući izlazak zbog iznimke, a više resursa zatvara obrnutim redoslijedom.

Verzija: 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 sučelje je za objekte koji mogu sadržavati resurse koje treba osloboditi, primjerice datotečne ručice. Sam zapis implements AutoCloseable ne pokreće zatvaranje: objektom mora upravljati try-with-resources ili ga treba izričito zatvoriti.

AutoCloseable.close ima potpis void close() throws Exception. Implementacija mora biti public i može deklarirati užu iznimku ili nijednu. Za razliku od java.io.Closeable, čiji close() deklarira IOException, AutoCloseable ne zahtijeva idempotentnost: ponovno zatvaranje može imati nuspojave. Ipak, idempotentnost se preporučuje.

try-with-resources zatvara uspješno inicijalizirane resurse koji nisu null obrnutim redoslijedom deklariranja, uključujući izlazak pomoću return ili zbog iznimke. Ako i blok i close() bace iznimku, generirani poziv metode addSuppressed pokušava dodati iznimku pri zatvaranju glavnoj iznimci. Ako blok i close() bace istu instancu tipa Throwable, taj poziv baca IllegalArgumentException, čak i ako je potiskivanje iznimki onemogućeno. Ako su instance različite i potiskivanje je omogućeno, polje koje getSuppressed() vrati za glavnu iznimku sadrži iznimku pri zatvaranju. Ako je potiskivanje onemogućeno, iznimka pri zatvaranju ne dodaje se i getSuppressed() vraća prazno polje.

Primjer simulira dva resursa bez pristupa datotekama ili mreži. Najprije ispisuje work, a zatim close second i close first. Implementacija Resource.close() ne deklarira iznimke, pa main ne mora obrađivati provjerenu iznimku zatvaranja.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori