Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

AutoCloseable.close(): automatsko zatvaranje resursa

`close()` oslobađa resurse objekta. Naredba try-with-resources automatski poziva tu metodu, ali sučelje ne zahtijeva da ponovljeni poziv bude bez učinka.

Verzija: Java SE 21

Sintaksa

void close() throws Exception;

// In a class implementing AutoCloseable, when closing needs no checked exception:
@Override
public void close() { /* release the resource */ }

// With an already initialized final or effectively final resource variable:
try (resource) {
    // use the resource
}

AutoCloseable.close je metoda bez argumenata iz sučelja java.lang.AutoCloseable. Ne vraća vrijednost (void): zatvara objekt i oslobađa resurse kojima on upravlja. Deklaracija throws Exception dopušta bacanje provjeravane iznimke ako zatvaranje ne uspije. Nadjačana metoda može deklarirati uži tip iznimke ili ne deklarirati nijednu provjeravanu iznimku. Pri ručnom pozivu preko reference tipa AutoCloseable treba uhvatiti ili deklarirati Exception, čak i ako je konkretna implementacija ne deklarira.

Naredba try-with-resources poziva close() za uspješno inicijalizirane resurse koji nisu null, obrnutim redoslijedom od inicijalizacije. To vrijedi i kad blok završi normalno i kad baci iznimku. Ako blok i close() bace različite instance tipa Throwable, iznimka iz bloka ostaje glavna. Ako je za nju omogućeno potiskivanje, iznimka pri zatvaranju dodaje joj se kao potisnuta iznimka i dostupna je preko getSuppressed(). Ako blok i close() bace istu instancu tipa Throwable, implicitni poziv metode addSuppressed() pokušava dodati iznimku samoj sebi kao potisnutu iznimku. Metoda tada baca IllegalArgumentException, koja se prosljeđuje umjesto izvorne iznimke. Ako blok završi normalno, iznimka pri zatvaranju može se proslijediti dalje.

Idempotentnost ovdje znači da poziv metode close() nakon zatvaranja nema dodatnog učinka. AutoCloseable to preporučuje, ali ne zahtijeva. Nasuprot tomu, java.io.Closeable proširuje AutoCloseable, zahtijeva da poziv nakon zatvaranja nema učinka i deklarira IOException umjesto Exception. U primjeru idempotentnost osigurava MemoryBuffer: prvo zatvaranje uklanja referencu na polje, a sljedeći pozivi odmah završavaju. Uklanjanje reference ne prisiljava sustav da odmah oslobodi memoriju.

Primjeri

public class Main {
    private static final class MemoryBuffer implements AutoCloseable {
        private int[] data = {42};

        int read() {
            if (data == null) {
                throw new IllegalStateException("Buffer is closed");
            }
            return data[0];
        }

        @Override
        public void close() {
            if (data == null) {
                return;
            }
            data = null;
            System.out.println("Buffer closed");
        }
    }

    public static void main(String[] args) {
        MemoryBuffer buffer = new MemoryBuffer();
        try (buffer) {
            System.out.println("Value: " + buffer.read());
        }
        buffer.close();
        System.out.println("Done");
    }
}

Rezultat

Value: 42
Buffer closed
Done

Varijabli `buffer` ne dodjeljuje se nova vrijednost, pa je efektivno konačna i može se upotrijebiti u `try (buffer)`. Automatsko zatvaranje ispisuje `Buffer closed`; kasniji ručni poziv `buffer.close()` ne čini ništa.

Povezane lekcije

  • Java · Lekcija 31 · Srednje · Verzija: 2

Izvori