Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

AutoCloseable — fechar recursos

java.lang.AutoCloseable define um contrato para fechar recursos através de close(). Com try-with-resources, o Java chama este método ao sair do bloco, incluindo devido a uma exceção, e fecha vários recursos pela ordem inversa.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public interface AutoCloseable {
    void close() throws Exception;
}

try (Resource resource = new Resource()) {
    // Use resource.
}

java.lang.AutoCloseable é uma interface para objetos que podem conter recursos que têm de ser libertados, como identificadores de ficheiros. Escrever apenas implements AutoCloseable não inicia o fecho: o objeto tem de ser gerido com try-with-resources ou fechado explicitamente.

AutoCloseable.close tem a assinatura void close() throws Exception. Uma implementação tem de ser public e pode declarar uma exceção mais específica ou não declarar nenhuma. Ao contrário de java.io.Closeable, cujo close() declara IOException, AutoCloseable não exige idempotência: fechar novamente pode ter efeitos secundários. Ainda assim, recomenda-se a idempotência.

try-with-resources fecha os recursos não nulos que foram inicializados com sucesso pela ordem inversa à da declaração, inclusive ao sair através de return ou devido a uma exceção. Se tanto o bloco como close() lançarem uma exceção, a chamada gerada a addSuppressed tenta anexar a exceção do fecho à exceção principal. Se ambos lançarem a mesma instância de Throwable, essa chamada lança IllegalArgumentException, mesmo que a supressão esteja desativada. Se as instâncias forem distintas e a supressão estiver ativa, o array devolvido por getSuppressed() na exceção principal contém a exceção do fecho. Se a supressão estiver desativada, a exceção do fecho não é anexada e getSuppressed() devolve um array vazio.

O exemplo simula dois recursos sem acesso a ficheiros ou à rede. Primeiro, imprime work, seguido de close second e close first. A implementação de Resource.close() não declara exceções, pelo que main não precisa de tratar uma exceção verificada de fecho.

Exemplos

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");
        }
    }
}

Resultado

work
close second
close first

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes