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