CKTIS / Java
AutoCloseable.close(): автоматично затваряне на ресурси
`close()` освобождава ресурсите на обекта. Конструкцията try-with-resources извиква метода автоматично, но интерфейсът не изисква повторното извикване да няма ефект.
Версия: Java SE 21
Синтаксис
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 е метод без аргументи в интерфейса java.lang.AutoCloseable. Той не връща стойност (void): затваря обекта и освобождава ресурсите, които той управлява. Декларацията throws Exception позволява да се хвърли проверявано изключение при неуспешно затваряне. Предефинираният метод може да декларира по-конкретен тип изключение или да не декларира проверявани изключения. При ръчно извикване чрез референция от тип AutoCloseable трябва да се прихване или декларира Exception, дори конкретната реализация да не го декларира.
Конструкцията try-with-resources извиква close() за успешно инициализираните ресурси, които не са null, в обратен ред на инициализацията. Това става и при нормално приключване на блока, и когато блокът хвърли изключение. Ако блокът и close() хвърлят различни екземпляри на Throwable, изключението от блока остава основно. Ако потискането е разрешено за него, изключението от затварянето се добавя към него като потиснато и е достъпно чрез getSuppressed(). Ако блокът и close() хвърлят един и същ екземпляр на Throwable, неявното извикване на addSuppressed() се опитва да добави изключението към самото него като потиснато. Тогава методът хвърля IllegalArgumentException, което се предава нататък вместо първоначалното изключение. Ако блокът приключи нормално, изключение от затварянето може да се предаде нататък.
Идемпотентност тук означава, че извикването на close() върху вече затворен ресурс няма допълнителен ефект. AutoCloseable препоръчва това, но не го изисква. За разлика от него, java.io.Closeable разширява AutoCloseable, изисква извикването след затваряне да няма ефект и декларира IOException вместо Exception. В примера MemoryBuffer осигурява идемпотентността: първото затваряне премахва референцията към масива, а следващите извиквания приключват веднага. Премахването на референцията не налага незабавно освобождаване на паметта.
Примери
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");
}
}Резултат
Value: 42 Buffer closed Done
На `buffer` не се присвоява нова стойност, затова променливата е ефективно финална и може да се използва в `try (buffer)`. Автоматичното затваряне отпечатва `Buffer closed`, а последващото ръчно извикване на `buffer.close()` не прави нищо.
Свързани уроци
- Java · Урок 31 · Средно · Версия: 2