Java InputStreamReader Explicado: Métodos, Codificação e Exemplos Práticos
Java InputStreamReader Explicado
Descubra como o InputStreamReader do Java faz a ponte entre byte streams e character streams, seus métodos principais e como lidar com codificação corretamente.
A classe InputStreamReader em java.io converte bytes brutos em caracteres, tornando-a essencial para ler arquivos de texto, streams de rede ou qualquer fonte baseada em bytes que represente caracteres.
Ela estende a classe abstrata Reader e atua como uma ponte entre byte streams (ex: FileInputStream) e character streams.
Quando um caractere requer múltiplos bytes — como texto codificado em UTF-8 ou UTF-16 — InputStreamReader lê esses bytes juntos e produz o caractere correto.
Criando um InputStreamReader
Comece importando a classe necessária:
import java.io.InputStreamReader;
Instanciação típica usa um FileInputStream como fonte de bytes subjacente:
FileInputStream file = new FileInputStream("exemplo.txt");
InputStreamReader reader = new InputStreamReader(file);
Se você souber a codificação do arquivo, especifique-a para evitar interpretação incorreta:
InputStreamReader reader = new InputStreamReader(file, Charset.forName("UTF-8"));
Usar Charset garante que o reader interprete bytes usando o character set pretendido.
Métodos Principais do InputStreamReader
read()
int read()– Lê um único caractere.int read(char[] cbuf)– Preenche um array com caracteres.int read(char[] cbuf, int off, int len)– Lê atélencaracteres emcbufcomeçando emoff.
Exemplo: Lendo um arquivo de texto em um array de caracteres.
import java.io.*;
class Main {
public static void main(String[] args) {
char[] buffer = new char[100];
try (FileInputStream file = new FileInputStream("input.txt");
InputStreamReader reader = new InputStreamReader(file)) {
reader.read(buffer);
System.out.println("Dados no stream:\n" + new String(buffer));
} catch (IOException e) {
e.printStackTrace();
}
}
}
Saída
Dados no stream: Esta é uma linha de texto dentro do arquivo.
getEncoding()
Recupere a codificação usada pelo reader:
InputStreamReader defaultReader = new InputStreamReader(file);
InputStreamReader utf8Reader = new InputStreamReader(file, Charset.forName("UTF-8"));
System.out.println("Codificação padrão: " + defaultReader.getEncoding());
System.out.println("Codificação UTF-8: " + utf8Reader.getEncoding());
Saída
Codificação padrão: Cp1252 Codificação UTF-8: UTF-8
Quando nenhuma codificação é especificada, getEncoding() retorna o charset padrão da plataforma.
Nota: Use Charset.forName() para codificações explícitas. Para mais detalhes, veja a documentação Java Charset.
close()
Sempre feche o reader após o uso. O construto try-with-resources acima trata isso automaticamente, mas você também pode chamar reader.close() explicitamente.
Outros Métodos Úteis
| Método | Descrição |
|---|---|
ready() | Verifica se o stream está pronto para leitura. |
mark(int readAheadLimit) | Marca a posição atual para reset posterior. |
reset() | Retorna à última posição marcada. |
Para referência completa, visite a página oficial InputStreamReader.
Java
- Entendendo a Palavra-chave final em Java: Variáveis, Métodos e Classes
- Operador instanceof em Java: Guia Completo
- Entendendo Classes Aninhadas Estáticas em Java: Uso, Diferenças e Exemplos
- Dominando Classes Internas Anônimas em Java: Definição, Sintaxe e Exemplos Práticos
- Padrão Singleton em Java Explicado: Como Implementar e Usar com Segurança
- Dominando Reflection em Java: Inspecionando Classes, Métodos e Campos em Tempo de Execução
- Dominando Java ObjectOutputStream: Serialização, Métodos e Exemplos Práticos
- Dominando Java Scanner: Guia Completo com Exemplos Práticos
- Dominando Java Generics – Construindo Código Reutilizável e Type-Safe
- Dominando Operações de Arquivo em Java com java.io – Criação, Leitura, Escrita e Exclusão