База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници