Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

AutoCloseable.close(): automatické zavírání prostředků

`close()` uvolňuje prostředky objektu. Příkaz try-with-resources ji volá automaticky, ale rozhraní nevyžaduje, aby opakované volání bylo bez účinku.

Verze: Java SE 21

Syntaxe

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 argumentů z rozhraní java.lang.AutoCloseable. Nevrací žádnou hodnotu (void): zavírá objekt a uvolňuje prostředky, které objekt spravuje. Deklarace throws Exception umožňuje při selhání zavírání vyhodit kontrolovanou výjimku. Překrývající metoda může deklarovat konkrétnější typ výjimky nebo žádnou kontrolovanou výjimku. Při ručním volání přes referenci typu AutoCloseable je nutné Exception zachytit nebo deklarovat, i když ji konkrétní implementace nedeklaruje.

Příkaz try-with-resources volá close() u úspěšně inicializovaných prostředků různých od null v opačném pořadí, než v jakém byly inicializovány. Platí to při běžném ukončení bloku i tehdy, když blok vyhodí výjimku. Pokud blok a close() vyhodí různé instance Throwable, hlavní zůstane výjimka z bloku. Je-li u ní potlačování povoleno, výjimka ze zavírání se k ní přidá jako potlačená a lze ji získat pomocí getSuppressed(). Pokud blok a close() vyhodí tutéž instanci Throwable, implicitní volání addSuppressed() se pokusí přidat výjimku k ní samotné jako potlačenou. Metoda pak vyhodí IllegalArgumentException, která se šíří dál místo původní výjimky. Pokud blok skončí normálně, výjimka ze zavírání se může šířit dál.

Idempotence zde znamená, že volání close() po zavření nemá žádný další účinek. AutoCloseable to doporučuje, ale nevyžaduje. Naproti tomu java.io.Closeable rozšiřuje AutoCloseable, vyžaduje, aby volání po zavření nemělo žádný účinek, a deklaruje IOException místo Exception. V příkladu idempotenci zajišťuje MemoryBuffer: první zavření odstraní referenci na pole a další volání se hned ukončí. Odstranění reference nevynutí okamžité uvolnění paměti.

Příklady

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

Výsledek

Value: 42
Buffer closed
Done

Proměnné `buffer` se nepřiřazuje nová hodnota, takže je efektivně finální a lze ji použít v `try (buffer)`. Automatické zavření vypíše `Buffer closed`; pozdější ruční volání `buffer.close()` nic neudělá.

Související lekce

  • Java · Lekce 31 · Středně pokročilá · Verze: 2

Zdroje