CKTIS / Java
AutoCloseable.close(): automatické zatváranie prostriedkov
`close()` uvoľňuje prostriedky objektu. Príkaz try-with-resources ju volá automaticky, no rozhranie nevyžaduje, aby opakované volanie nemalo žiadny účinok.
Verzia: Java SE 21
Syntax
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 metóda bez argumentov z rozhrania java.lang.AutoCloseable. Nevracia žiadnu hodnotu (void): zatvára objekt a uvoľňuje prostriedky, ktoré objekt spravuje. Deklarácia throws Exception umožňuje pri zlyhaní zatvárania vyhodiť kontrolovanú výnimku. Prekrývajúca metóda môže deklarovať konkrétnejší typ výnimky alebo nedeklarovať žiadnu kontrolovanú výnimku. Pri ručnom volaní cez referenciu typu AutoCloseable treba Exception zachytiť alebo deklarovať, aj keď ju konkrétna implementácia nedeklaruje.
Príkaz try-with-resources volá close() na úspešne inicializovaných prostriedkoch iných než null, v opačnom poradí inicializácie. Platí to pri bežnom ukončení bloku aj vtedy, keď blok vyhodí výnimku. Ak blok a close() vyhodia rôzne inštancie Throwable, hlavnou zostáva výnimka z bloku. Ak je pri nej povolené potláčanie, výnimka zo zatvárania sa k nej pridá ako potlačená a možno ju získať cez getSuppressed(). Ak blok a close() vyhodia tú istú inštanciu Throwable, implicitné volanie addSuppressed() sa pokúsi pridať výnimku k nej samej ako potlačenú. Metóda potom vyhodí IllegalArgumentException, ktorá sa šíri ďalej namiesto pôvodnej výnimky. Ak sa blok ukončí normálne, výnimka zo zatvárania sa môže šíriť ďalej.
Idempotentnosť tu znamená, že volanie close() po zatvorení už nemá ďalší účinok. AutoCloseable to odporúča, ale nevyžaduje. Naopak, java.io.Closeable rozširuje AutoCloseable, vyžaduje, aby volanie po zatvorení nemalo účinok, a deklaruje IOException namiesto Exception. V príklade idempotentnosť zabezpečuje MemoryBuffer: prvé zatvorenie odstráni referenciu na pole a ďalšie volania sa hneď skončia. Odstránenie referencie nevynúti okamžité uvoľnenie pamäte.
Prí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ýsledok
Value: 42 Buffer closed Done
Premennej `buffer` sa nepriraďuje nová hodnota, takže je efektívne finálna a dá sa použiť v `try (buffer)`. Automatické zatvorenie vypíše `Buffer closed`; neskoršie ručné volanie `buffer.close()` nič neurobí.
Súvisiace lekcie
- Java · Lekcia 31 · Stredne pokročilá · Verzia: 2