CKTIS / Java
AutoCloseable — затваряне на ресурси
java.lang.AutoCloseable определя договор за затваряне на ресурси чрез close(). При try-with-resources Java извиква този метод при напускане на блока, включително заради изключение, а няколко ресурса се затварят в обратен ред.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
public interface AutoCloseable {
void close() throws Exception;
}
try (Resource resource = new Resource()) {
// Use resource.
}java.lang.AutoCloseable е интерфейс за обекти, които могат да съдържат ресурси, изискващи освобождаване, например файлови дескриптори. Самото implements AutoCloseable не задейства затварянето: обектът трябва да се управлява чрез try-with-resources или да се затвори изрично.
AutoCloseable.close има сигнатура void close() throws Exception. Реализацията трябва да е public и може да декларира по-тясно изключение или изобщо да не декларира такова. За разлика от java.io.Closeable, чийто close() декларира IOException, AutoCloseable не изисква идемпотентност: повторното затваряне може да има странични ефекти. Въпреки това идемпотентността се препоръчва.
try-with-resources затваря успешно инициализираните ресурси, които не са null, в обратен ред на декларирането им, включително при напускане чрез return или заради изключение. Ако и блокът, и close() хвърлят изключение, генерираното извикване на addSuppressed се опитва да добави изключението при затваряне към основното изключение. Ако блокът и close() хвърлят една и съща инстанция на Throwable, това извикване хвърля IllegalArgumentException, дори когато потискането на изключения е изключено. Ако инстанциите са различни и потискането е включено, масивът, върнат от getSuppressed() на основното изключение, съдържа изключението при затваряне. Ако потискането е изключено, изключението при затваряне не се добавя и getSuppressed() връща празен масив.
Примерът симулира два ресурса без достъп до файлове или мрежа. Първо отпечатва work, след това close second и close first. Реализацията на Resource.close() не декларира изключения, затова main не трябва да обработва проверено изключение при затваряне.
Примери
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");
}
}
}Резултат
work close second close first
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.