Saída Formatada com PrintStream e PrintWriter

Enquanto classes como FileOutputStream são eficientes para escrever bytes brutos, elas são pouco práticas para gravar texto formatado, números e outros tipos de dados primitivos de forma legível. Para essa finalidade, Java oferece classes de alto nível que "envolvem" outros streams de saída, adicionando funcionalidades de formatação: PrintStream e PrintWriter.

A Classe PrintStream

A classe PrintStream é o stream de saída mais conhecido em Java, pois é a classe por trás de System.out. Quando executamos System.out.println(), estamos utilizando um método de um objeto PrintStream.

Além do console, PrintStream pode ser usado para escrever informações formatadas em qualquer OutputStream. Ele oferece métodos convenientes para formatar a saída:

• print(): Escreve os dados sem adicionar uma quebra de linha.
• println(): Escreve os dados e adiciona uma quebra de linha.
• printf(): Permite a escrita com formatação de string (ex: "%s" para string, "%d" para inteiro).

Uma característica única e importante do PrintStream é que ele não lança IOException. Em caso de erro, ele define um flag interno que pode ser verificado com o método checkError(). Esse comportamento foi projetado para tornar a saída para o console mais conveniente, evitando que um simples println exija um bloco try-catch.

O exemplo a seguir demonstra como gravar dados formatados em um arquivo:

import java.io.*;

public class Program {

    public static void main(String[] args) {

        try (PrintStream printStream = new PrintStream("notes_formatted.txt")) {
            printStream.print("Hello World!"); // Sem quebra de linha
            printStream.println("Welcome to Java!"); // Com quebra de linha

            printStream.printf("Name: %s Age: %d \n", "Tom", 34);

            String message = "PrintStream";
            byte[] messageToBytes = message.getBytes();
            printStream.write(messageToBytes); // Também pode escrever bytes brutos

            System.out.println("The file has been written");
        } catch (IOException ex) {
            // Este catch é para a falha na criação do PrintStream (ex: permissão negada)
            // não para as operações de escrita.
            System.out.println(ex.getMessage());
        }
    }
}

Após a execução, o arquivo notes_formatted.txt terá o seguinte conteúdo:

Hello World!Welcome to Java!
Name: Tom Age: 34
PrintStream

A Classe PrintWriter

A classe PrintWriter é a análoga moderna da PrintStream. A diferença fundamental é que PrintWriter foi projetada para trabalhar com fluxos de caracteres (Writer), enquanto PrintStream trabalha com fluxos de bytes (OutputStream). Isso torna PrintWriter a escolha preferida para a escrita de arquivos de texto, pois ele gerencia a codificação de caracteres de forma mais robusta e explícita.

PrintWriter também oferece os métodos print(), println() e printf(). Assim como PrintStream, ele não lança IOException em suas operações de escrita, utilizando um mecanismo interno de flag de erro.

Para maior flexibilidade, PrintWriter pode "envolver" não apenas um Writer, mas também um OutputStream, criando internamente a ponte necessária (OutputStreamWriter) para converter caracteres em bytes.

O exemplo a seguir usa PrintWriter para escrever em um arquivo de texto, a abordagem recomendada:

import java.io.*;

public class Program {
    public static void main(String[] args) {
        // Envolvendo um FileWriter, que é um Writer
        try (FileWriter fw = new FileWriter("notes_writer.txt");
             PrintWriter pw = new PrintWriter(fw)) {

            pw.println("This text was written using PrintWriter.");
            pw.printf("It supports formatted numbers like %.2f", 123.456);
        } catch (IOException e) {
            // O catch trata exceções da criação do FileWriter ou do PrintWriter
            System.out.println(e.getMessage());
        }
    }
}

PrintStream vs. PrintWriter: Qual Usar?

A escolha depende do que você está fazendo. A tabela abaixo resume as diferenças:

Resumo

• PrintStream e PrintWriter são classes de alto nível que simplificam a escrita de texto e dados formatados.
• Ambas suprimem IOException nas operações de escrita, o que as torna convenientes, mas exige verificação manual de erros (checkError()) se a robustez for crítica.
• PrintStream opera sobre fluxos de bytes e é ideal para o console (System.out).
• PrintWriter opera sobre fluxos de caracteres e é a escolha preferencial e mais segura para escrever em arquivos de texto.