Класс OutputStream

java.lang.Object
- java.io.OutputStream

Все реализованные интерфейсы:: Closeable, Flushable, AutoCloseable

Прямые известные подклассы:: ByteArrayOutputStream, FileOutputStream, FilterOutputStream, ObjectOutputStream, OutputStream, PipedOutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

Этот абстрактный класс является суперклассом для всех классов, представляющих поток вывода байтов. Поток вывода принимает байты вывода и отправляет их в какой-либо приемник.

Приложения, которым необходимо определить подкласс OutputStream , всегда должны предоставлять по крайней мере метод, который записывает один байт вывода.

С:: JDK1.0
См. также:: BufferedOutputStream, ByteArrayOutputStream, DataOutputStream, FilterOutputStream, InputStream, write(int)

Конструкторы

Конструктор и описание
`OutputStream()`

Методы

Модификатор и тип	Метод и описание
`void`	`close()` Закрывает этот поток вывода и освобождает все системные ресурсы, связанные с этим потоком.
`void`	`flush()` Сбрасывает этот поток вывода и принудительно записывает все буферизованные байты вывода.
`void`	`write(byte[] b)` Записывает `b.length` байтов из указанного массива байтов в этот поток вывода.
`void`	`write(byte[] b, int off, int len)` Записывает `len` байтов из указанного массива байтов, начиная с смещения `off` в этот поток вывода.
`abstract void`	`write(int b)` Записывает указанный байт в этот поток вывода.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

OutputStream

public OutputStream()

Методы

write

public abstract void write(int b)
                    throws IOException

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

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

Параметры:: b - байт.
Исключения:: IOException - если возникает ошибка ввода-вывода. В частности, может быть вызвано исключение IOException , если поток вывода был закрыт.

write

public void write(byte[] b)
           throws IOException

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

Параметры:: b - данные.
Исключения:: IOException - если возникает ошибка ввода-вывода.
См. также:: write(byte[], int, int)

write

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.

Параметры:: b - данные.; off - начальное смещение в данных.; len - количество байтов для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода. В частности, исключение IOException выбрасывается, если поток вывода закрыт.

flush

public void flush()
           throws IOException

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

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

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

Указано в:: flush в интерфейсе Flushable
Исключения:: IOException - если возникает ошибка ввода-вывода.

close

public void close()
           throws IOException

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

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

Указано в:: close в интерфейсе Closeable
Указано в:: close в интерфейсе AutoCloseable
Исключения:: IOException - если возникает ошибка ввода-вывода.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.