Padrão Try With Resources

Parte da seção Programação Orientada a Objetos do Journey de Java da Coddy — lição 62 de 87.

Ao trabalhar com recursos como fluxos de arquivos ou conexões de banco de dados, você deve sempre fechá-los quando terminar — caso contrário, corre o risco de vazamentos de memória. A abordagem tradicional usa um bloco finally, mas é verbosa e propensa a erros.

A instrução try-with-resources do Java fecha automaticamente os recursos quando o bloco é concluído. Qualquer classe que implemente a interface AutoCloseable pode ser usada com esta sintaxe:

// Abordagem tradicional - verbosa e arriscada
BufferedReader reader = null;
try {
    reader = new BufferedReader(new FileReader("file.txt"));
    String line = reader.readLine();
} finally {
    if (reader != null) {
        reader.close();  // Também pode lançar uma exceção!
    }
}

// Try-with-resources - limpo e seguro
try (BufferedReader reader = new BufferedReader(new FileReader("file.txt"))) {
    String line = reader.readLine();
}  // Fechado automaticamente aqui

Você pode gerenciar múltiplos recursos separando-os com pontos e vírgulas. Eles são fechados na ordem inversa da declaração:

try (FileReader fr = new FileReader("input.txt");
     BufferedReader br = new BufferedReader(fr)) {
    // Use ambos os recursos
}  // br fechado primeiro, depois fr

Para criar sua própria classe auto-closeable, implemente a interface AutoCloseable e seu único método close():

public class DatabaseConnection implements AutoCloseable {
    public DatabaseConnection() {
        System.out.println("Connection opened");
    }
    
    @Override
    public void close() {
        System.out.println("Connection closed");
    }
}

Este padrão garante que os recursos sejam sempre liberados adequadamente, mesmo que ocorram exceções durante o processamento.

Desafio

Fácil

Vamos construir um sistema de gerenciamento de recursos que demonstra o poder do try-with-resources! Você criará classes auto-closeable personalizadas que simulam o gerenciamento de conexões e sessões, garantindo que elas sejam sempre limpas adequadamente.

Você organizará seu código em três arquivos:

Connection.java: Crie uma classe que simule uma conexão de banco de dados. Sua classe Connection deve implementar AutoCloseable. Ela precisa de um campo privado para o nome da conexão (String), um construtor que recebe o nome e imprime [name] connection opened, um método query(String sql) que imprime Executing on [name]: [sql], e o método close() obrigatório que imprime [name] connection closed.
Session.java: Crie outra classe auto-closeable que simule uma sessão de usuário. Sua classe Session também deve implementar AutoCloseable. Inclua um campo privado para o nome de usuário (String), um construtor que recebe o nome de usuário e imprime Session started for [username], um método performAction(String action) que imprime [username] performed: [action], e um método close() que imprime Session ended for [username].
Main.java: Reúna seu sistema de gerenciamento de recursos! Você receberá três entradas: um nome de conexão, um nome de usuário e uma ação a ser realizada.
Primeiro, demonstre o gerenciamento de um único recurso. Imprima === Single Resource ===, então use try-with-resources para criar uma Connection com o nome fornecido. Dentro do bloco try, chame query("SELECT * FROM users"). A conexão deve fechar automaticamente quando o bloco terminar.

Em seguida, demonstre múltiplos recursos. Imprima uma linha em branco, depois === Multiple Resources ===. Use try-with-resources com uma Connection (usando o mesmo nome) e uma Session (usando o nome de usuário), declaradas nessa ordem com ponto e vírgula. Dentro do bloco try, primeiro chame query("INSERT INTO logs") na conexão, depois chame performAction com a ação de entrada na sessão. Observe como os recursos fecham na ordem inversa!

Você receberá três entradas em ordem: nome da conexão (String), nome de usuário (String) e ação (String).

Observe como o try-with-resources elimina a necessidade de chamadas explícitas de fechamento e blocos finally. Os recursos têm o fechamento garantido mesmo se ocorrerem exceções, e múltiplos recursos fecham na ordem inversa da declaração!

Folha de consulta

A instrução try-with-resources fecha automaticamente os recursos quando o bloco é concluído. Qualquer classe que implemente AutoCloseable pode ser usada:

try (BufferedReader reader = new BufferedReader(new FileReader("file.txt"))) {
    String line = reader.readLine();
}  // Fechado automaticamente aqui

Múltiplos recursos podem ser gerenciados separando-os com pontos e vírgulas. Eles fecham na ordem inversa da declaração:

try (FileReader fr = new FileReader("input.txt");
     BufferedReader br = new BufferedReader(fr)) {
    // Use ambos os recursos
}  // br fechado primeiro, depois fr

Para criar uma classe auto-closeable personalizada, implemente a interface AutoCloseable e seu método close():

public class DatabaseConnection implements AutoCloseable {
    public DatabaseConnection() {
        System.out.println("Connection opened");
    }
    
    @Override
    public void close() {
        System.out.println("Connection closed");
    }
}

Experimente você mesmo

import java.util.Scanner;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        String connectionName = scanner.nextLine();
        String username = scanner.nextLine();
        String action = scanner.nextLine();
        
        // === Recurso Único ===
        // TODO: Imprimir o cabeçalho
        // TODO: Usar try-with-resources para criar uma Connection
        // TODO: Dentro do bloco try, chamar query("SELECT * FROM users")
        
        // === Múltiplos Recursos ===
        // TODO: Imprimir uma linha em branco e o cabeçalho
        // TODO: Usar try-with-resources com ambos Connection e Session
        // TODO: Dentro do bloco try:
        //       - Chamar query("INSERT INTO logs") na conexão
        //       - Chamar performAction com a ação de entrada na sessão
        
    }
}