CKTIS / Java
try-with-resources — fecho automático de recursos
A instrução try-with-resources chama automaticamente close() nos recursos AutoCloseable. Define durante quanto tempo são utilizados e como são tratadas as exceções que ocorrem durante o fecho.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
try (Resource r = expression) {
// use r
}Em try (Resource r = ...), Resource designa o tipo declarado do recurso, que tem de ser um subtipo de AutoCloseable. O próprio tipo AutoCloseable cumpre este requisito. As reticências ... representam uma expressão de inicialização. Ao sair do bloco, incluindo através de return ou de uma exceção, Java chama close() no recurso se este não for null.
Separa os recursos com ponto e vírgula. A inicialização decorre da esquerda para a direita e o fecho pela ordem inversa. Se uma inicialização falhar, os recursos inicializados anteriormente são fechados. A falha de um close() não impede as restantes tentativas de fecho.
Uma variável declarada no cabeçalho é implicitamente final. Também podes usar try (r) se já tiver sido atribuído um valor à variável existente e esta for final ou efetivamente final, ou seja, não lhe for atribuído outro valor.
Se o bloco lançar uma exceção, esta passa a ser a exceção principal. Se close() lançar um objeto de exceção diferente, addSuppressed() só o regista como exceção suprimida, acessível através de getSuppressed(), se a supressão estiver ativada na exceção principal. Se estiver desativada, a exceção de fecho distinta não é registada. Se close() lançar o mesmo objeto de exceção que o bloco, addSuppressed() rejeita a tentativa de adicionar a exceção a si própria e lança IllegalArgumentException, mesmo com a supressão desativada. A IllegalArgumentException pode então propagar-se em vez da exceção original. Se não existir uma exceção anterior, a primeira exceção de fecho passa a ser a principal. As cláusulas opcionais catch e finally são executadas depois das tentativas de fecho; catch também pode tratar erros de inicialização e 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 a = new Resource("A");
Resource b = new Resource("B")) {
System.out.println("work");
}
}
}Resultado
work close B close A
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.