CKTIS / Java
AutoCloseable — zapiranje virov
java.lang.AutoCloseable določa pogodbo za zapiranje virov z metodo close(). Pri uporabi try-with-resources Java to metodo pokliče ob izhodu iz bloka, tudi zaradi izjeme, več virov pa zapre v obratnem vrstnem redu.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable je vmesnik za objekte, ki lahko hranijo vire, ki jih je treba sprostiti, na primer datotečne ročice. Zgolj zapis implements AutoCloseable ne sproži zapiranja: objekt mora upravljati try-with-resources ali pa ga je treba zapreti izrecno.
AutoCloseable.close ima podpis void close() throws Exception. Implementacija mora biti public in lahko deklarira ožjo izjemo ali pa nobene. V nasprotju z java.io.Closeable, katerega close() deklarira IOException, AutoCloseable ne zahteva idempotentnosti: ponovno zapiranje ima lahko stranske učinke. Idempotentnost je kljub temu priporočena.
try-with-resources zapre uspešno inicializirane vire, ki niso null, v obratnem vrstnem redu deklaracij, tudi ob izhodu z return ali zaradi izjeme. Če tako blok kot close() vržeta izjemo, samodejno ustvarjeni klic addSuppressed poskuša izjemo pri zapiranju dodati glavni izjemi. Če oba vržeta isti primerek tipa Throwable, ta klic vrže IllegalArgumentException, tudi če je zatiranje izjem onemogočeno. Če sta primerka različna in je zatiranje omogočeno, polje, ki ga vrne getSuppressed() na glavni izjemi, vsebuje izjemo pri zapiranju. Če je zatiranje onemogočeno, se izjema pri zapiranju ne doda in getSuppressed() vrne prazno polje.
Primer simulira dva vira brez dostopa do datotek ali omrežja. Najprej izpiše work, nato close second in close first. Implementacija Resource.close() ne deklarira izjem, zato v main ni treba obravnavati preverjene izjeme pri zapiranju.
Primeri
public class Main {
static final class Resource implements AutoCloseable {
private final String name;
Resource(String name) {
this.name = name;
}
@Override
public void close() {
System.out.println("close " + name);
}
}
public static void main(String[] args) {
try (Resource first = new Resource("first");
Resource second = new Resource("second")) {
System.out.println("work");
}
}
}Rezultat
work close second close first
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.