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.