java.io

Класс OutputStream

java.lang. Объект

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 унаследованный от класса. Объект

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

Деталь конструктора

OutputStream

public OutputStream()

Деталь метода

записать

public abstract void write(int b)
                    throws IOException

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

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

Параметры:

b - byte.

Броски:

IOException - если ошибка ввода-вывода происходит. В частности IOException может быть брошен, если поток вывода был закрыт.

записать

public void write(byte[] b)
           throws IOException

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

Параметры:

b - данные.

Броски:

IOException - если ошибка ввода-вывода происходит.

См. Также:

write(byte[], int, int)

записать

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 вызывает метод записи одного параметра на каждом из байтов, которые будут выписаны. Подклассы поощряются переопределить этот метод и обеспечить более эффективную реализацию.

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

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

Параметры:

b - данные.

off - запуск смещается в данных.

len - число байтов, чтобы записать.

Броски:

IOException - если ошибка ввода-вывода происходит. В частности IOException бросается, если поток вывода закрывается.

сброс

public void flush()
           throws IOException

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

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

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

Определенный:

flush в интерфейсе Flushable

Броски:

IOException - если ошибка ввода-вывода происходит.

близко

public void close()
           throws IOException

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

close метод OutputStream ничего не делает.

Определенный:

close в интерфейсе Closeable

Определенный:

close в интерфейсе AutoCloseable

Броски:

IOException - если ошибка ввода-вывода происходит.