Освоение Java OutputStreamWriter: преобразование символов в байты с практическими примерами

Класс Java OutputStreamWriter

Класс OutputStreamWriter из java.io служит мостом, преобразующим символьные данные в байтовые. Он расширяет абстрактный класс Writer и работает в паре с байтовыми потоками, такими как FileOutputStream.

Поскольку некоторые Unicode-символы занимают несколько байт, OutputStreamWriter гарантирует правильное применение кодировки символов при записи в байтовый поток.

Создание OutputStreamWriter

Импортируйте необходимые классы:

import java.io.OutputStreamWriter;
import java.io.FileOutputStream;
import java.nio.charset.Charset;

Инстанцируйте FileOutputStream для целевого файла, затем оберните в OutputStreamWriter. Конструктор по умолчанию использует кодировку платформы, но можно явно задать UTF-8 или UTF-16 для кросс-платформенной согласованности:

// Кодировка по умолчанию
OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("output.txt"));
// Явный UTF-8
OutputStreamWriter writerUtf8 = new OutputStreamWriter(
    new FileOutputStream("output_utf8.txt"), Charset.forName("UTF-8"));

Ключевые методы OutputStreamWriter

Метод write()

• write(int c) — записывает один символ.
• write(char[] cbuf) — записывает массив символов.
• write(String str) — записывает строку.

Пример: запись текста в файл

import java.io.FileOutputStream;
import java.io.OutputStreamWriter;

public class Main {
    public static void main(String[] args) {
        String data = "This is a line of text inside the file.";
        try {
            FileOutputStream fileOut = new FileOutputStream("output.txt");
            OutputStreamWriter writer = new OutputStreamWriter(fileOut, Charset.forName("UTF-8"));
            writer.write(data);
            writer.flush();
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Программа создаёт output.txt со следующим содержимым:

This is a line of text inside the file.

Метод getEncoding()

Используйте getEncoding() для получения текущей кодировки:

FileOutputStream file = new FileOutputStream("output.txt");
OutputStreamWriter defaultWriter = new OutputStreamWriter(file);
OutputStreamWriter utf8Writer = new OutputStreamWriter(file, Charset.forName("UTF-8"));
System.out.println("Кодировка по умолчанию: " + defaultWriter.getEncoding());
System.out.println("UTF-8 кодировка: " + utf8Writer.getEncoding());

Вывод

Кодировка по умолчанию: Cp1252
UTF-8 кодировка: UTF-8

Когда кодировка не задана, возвращается платформенная по умолчанию. Явное указание гарантирует согласованное поведение.

Совет: Используйте Charset.forName() для точного контроля; см. официальный Java Charset API.

Метод close()

Всегда вызывайте close() для освобождения системных ресурсов. После закрытия писатель нельзя использовать снова.

Дополнительные полезные методы

Полный справочник: официальный Java OutputStreamWriter Javadoc.