Класс OutputStream

public OutputStream()

Конструктор для вызова подклассами.

public static OutputStream nullOutputStream()

Возвращает новый OutputStream, который отбрасывает все байты. Возвращаемый поток изначально открыт. Поток закрывается вызовом метода close(). Последующие вызовы close() не имеют эффекта.

Пока поток открыт, методы write(int), write(byte[]), и write(byte[], int, int) ничего не делают. После закрытия потока все эти методы выбрасывают IOException.

Метод flush() ничего не делает.

public abstract void write(int b) throws IOException

Записывает указанный байт в этот поток вывода. Общий контракт для write заключается в том, что один байт записывается в поток вывода. Байтом для записи являются восемь младших битов аргумента b. 24 старших бита b игнорируются.

Подклассы OutputStream должны предоставить реализацию для этого метода.

public void write(byte[] b) throws IOException

Записывает b.length байт из заданного массива байт в этот поток вывода. Общий контракт для write(b) заключается в том, что он должен иметь точно такой же эффект, как вызов write(b, 0, b.length).

public void write(byte[] b, int off, int len) throws IOException

Записывает len байт из заданного массива байт, начиная со смещения off, в этот поток вывода. Общий контракт для write(b, off, len) заключается в том, что некоторые байты в массиве b записываются в поток вывода в порядке; элемент b[off] является первым записываемым байтом, а b[off+len-1] - последним байтом, записанным в ходе этой операции.

Метод write OutputStream вызывает метод write с одним аргументом для каждого байта, который необходимо записать. Подклассы рекомендуется переопределять этот метод и обеспечивать более эффективную реализацию.

Если b равно null, выбрасывается NullPointerException.

Если off отрицательно, или len отрицательно, или off+len больше длины массива b, выбрасывается IndexOutOfBoundsException.

public void flush() throws IOException

Сбрасывает этот поток вывода и принудительно записывает все буферизованные выходные байты. Общий контракт метода flush заключается в том, что вызов означает, что, если какие-либо ранее записанные байты были буферизованы реализацией потока вывода, такие байты должны быть немедленно записаны в их предназначенное место назначения.

Если предполагаемое место назначения этого потока является абстракцией, предоставляемой базовой операционной системой, например, файл, то сброс потока гарантирует только, что ранее записанные в поток байты передаются операционной системе для записи; он не гарантирует, что они фактически записаны на физическое устройство, например, на жесткий диск.

Метод flush OutputStream ничего не делает.

public void close() throws IOException

Закрывает этот поток вывода и освобождает все системные ресурсы, связанные с этим потоком. Общий контракт close заключается в том, что он закрывает поток вывода. Закрытый поток не может выполнять операции вывода и не может быть повторно открыт.

Метод close класса OutputStream ничего не делает.