Java OutputStream: ключевые концепции, методы и практический пример с файлом

Класс Java OutputStream

Класс OutputStream в пакете java.io — абстрактный суперкласс, представляющий поток байтов, предназначенный для назначения вывода. Нельзя инстанцировать его напрямую; используются конкретные подклассы для реальных I/O операций.

Основные подклассы OutputStream

• FileOutputStream — записывает байты непосредственно в файл.
• ByteArrayOutputStream — накапливает байты в расширяемом массиве, полезно для операций в памяти.
• ObjectOutputStream — сериализует Java-объекты в байтовый поток.

Каждый подкласс будет рассмотрен в отдельных руководствах.

Создание экземпляра OutputStream

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

// Инстанцирование FileOutputStream
OutputStream out = new FileOutputStream("example.txt");

Так как OutputStream абстрактен, всегда нужно использовать подкласс. Пример создаёт поток для записи в example.txt.

Совет: Можно заменить FileOutputStream на любой другой подкласс (например, ByteArrayOutputStream) для другого назначения.

Основные методы OutputStream

Абстрактный класс объявляет ключевые методы, которые должны реализовывать подклассы:

• write(int b) — записывает один байт в поток.
• write(byte[] b) — записывает весь байтовый массив.
• flush() — принудительно сбрасывает буферизованные данные в назначение.
• close() — освобождает системные ресурсы, связанные с потоком.

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

Готовая к запуску программа, записывающая строку в output.txt через FileOutputStream:

import java.io.FileOutputStream;
import java.io.OutputStream;

public class Main {
    public static void main(String[] args) {
        String data = "This is a line of text inside the file.";
        try (OutputStream out = new FileOutputStream("output.txt")) {
            byte[] dataBytes = data.getBytes();
            out.write(dataBytes);
            System.out.println("Данные записаны в output.txt");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Ключевые моменты:

• Преобразование String в байтовый массив через getBytes().
• Запись массива в поток через write().
• Автоматическое закрытие потока блоком try-with-resources, вызывающим close().

После выполнения output.txt будет содержать:

This is a line of text inside the file.

Для глубокого изучения OutputStream обратитесь к официальной документации Java.

Java OutputStream (официальная документация)