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

CKTIS / Java

AutoCloseable.close(): samodejno zapiranje virov

`close()` sprosti vire objekta. Stavek try-with-resources metodo pokliče samodejno, vendar vmesnik ne zahteva, da je ponovni klic brez učinka.

Različica: 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 brez argumentov vmesnika java.lang.AutoCloseable. Ne vrne vrednosti (void): zapre objekt in sprosti vire, ki jih objekt upravlja. Deklaracija throws Exception dovoljuje sprožitev preverjane izjeme, če zapiranje spodleti. Prepisana metoda lahko deklarira ožji tip izjeme ali ne deklarira nobene preverjane izjeme. Pri ročnem klicu prek reference tipa AutoCloseable je treba Exception prestreči ali deklarirati, tudi če je konkretna implementacija ne deklarira.

Stavek try-with-resources pokliče close() za uspešno inicializirane vire, katerih vrednost ni null, v obratnem vrstnem redu inicializacije. To velja ob običajnem izhodu iz bloka in tudi, če blok sproži izjemo. Če blok in close() sprožita različna primerka Throwable, ostane izjema iz bloka glavna. Če je pri njej omogočeno tlačenje izjem, se ji izjema pri zapiranju doda kot potlačena izjema in je dostopna prek getSuppressed(). Če blok in close() sprožita isti primerek Throwable, poskuša implicitni klic addSuppressed() izjemo dodati sami sebi kot potlačeno izjemo. Metoda zato sproži IllegalArgumentException, ki se širi naprej namesto prvotne izjeme. Če se blok konča normalno, se lahko izjema pri zapiranju širi naprej.

Idempotentnost tu pomeni, da klic close() po zaprtju nima dodatnega učinka. AutoCloseable to priporoča, ne zahteva pa tega. Nasprotno java.io.Closeable razširja AutoCloseable, zahteva, da klic po zaprtju nima učinka, in deklarira IOException namesto Exception. V primeru za idempotentnost poskrbi MemoryBuffer: prvo zapiranje odstrani referenco na tabelo, poznejši klici pa se takoj končajo. Odstranitev reference ne prisili sistema, da pomnilnik sprosti takoj.

Primeri

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

Spremenljivki `buffer` nikoli ne priredimo nove vrednosti, zato je dejansko končna in jo lahko uporabimo v `try (buffer)`. Samodejno zapiranje izpiše `Buffer closed`; poznejši ročni klic `buffer.close()` ne naredi ničesar.

Povezane lekcije

  • Java · Lekcija 31 · Srednja · Različica: 2

Viri