Интерфейс ObjectInput

Все суперинтерфейсы:: AutoCloseable, DataInput

Все известные реализующие классы:: ObjectInputStream

public interface ObjectInput extends DataInput, AutoCloseable

ObjectInput расширяет интерфейс DataInput, добавляя возможность чтения объектов. DataInput включает методы для ввода примитивных типов, а ObjectInput расширяет этот интерфейс, добавляя объекты, массивы и строки.

Начиная с:

1.1

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`available()`	Возвращает количество байтов, которые можно прочитать без блокировки.
`void`	`close()`	Закрывает входной поток.
`int`	`read()`	Читает байт данных.
`int`	`read(byte[] b)`	Читает данные в массив байтов.
`int`	`read(byte[] b, int off, int len)`	Читает данные в массив байтов.
`Object`	`readObject()`	Читает и возвращает объект.
`long`	`skip(long n)`	Пропускает n байтов входных данных.

Методы, объявленные в интерфейсе DataInput

readBoolean, readByte, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedShort, readUTF, skipBytes

Модификатор и тип	Метод	Описание
`boolean`	`readBoolean()`	Читает один входной байт и возвращает `true`, если этот байт не равен нулю, или `false`, если этот байт равен нулю.
`byte`	`readByte()`	Читает и возвращает один входной байт.
`char`	`readChar()`	Читает два входных байта и возвращает значение типа `char`.
`double`	`readDouble()`	Читает восемь входных байтов и возвращает значение типа `double`.
`float`	`readFloat()`	Читает четыре входных байта и возвращает значение типа `float`.
`void`	`readFully(byte[] b)`	Читает несколько байтов из входного потока и сохраняет их в массиве буфера `b`.
`void`	`readFully(byte[] b, int off, int len)`	Читает `len` байтов из входного потока.
`int`	`readInt()`	Читает четыре входных байта и возвращает значение типа `int`.
`String`	`readLine()`	Читает следующую строку текста из входного потока.
`long`	`readLong()`	Читает восемь входных байтов и возвращает значение типа `long`.
`short`	`readShort()`	Читает два входных байта и возвращает значение типа `short`.
`int`	`readUnsignedByte()`	Читает один входной байт, расширяет его нулями до типа `int` и возвращает результат, который, следовательно, находится в диапазоне от `0` до `255`.
`int`	`readUnsignedShort()`	Читает два входных байта и возвращает значение типа `int` в диапазоне от `0` до `65535`.
`String`	`readUTF()`	Читает строку, закодированную в формате модифицированного UTF-8.
`int`	`skipBytes(int n)`	Пытается пропустить `n` байтов данных во входном потоке, отбрасывая пропущенные байты.

Подробное описание методов

readObject

Object readObject() throws ClassNotFoundException, IOException

Читает и возвращает объект. Класс, реализующий этот интерфейс, определяет, откуда считывается объект.

Возвращает:: объект, прочитанный из потока
Вызывает исключение:: ClassNotFoundException — если класс сериализованного объекта не найден.; IOException — если возникает какое-либо из обычных исключений, связанных с вводом-выводом.

read

int read() throws IOException

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

Возвращает:: прочитанный байт или -1, если достигнут конец потока.
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода.

read

int read(byte[] b) throws IOException

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

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

read

int read(byte[] b, int off, int len) throws IOException

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

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

skip

long skip(long n) throws IOException

Пропускает n байтов входных данных.

Параметры:: n — количество байтов, которые нужно пропустить
Возвращает:: фактическое количество пропущенных байтов.
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода.

available

int available() throws IOException

Возвращает количество байтов, которые можно прочитать без блокировки.

Возвращает:: количество доступных байтов.
Вызывает исключение:: IOException — если произошла ошибка ввода-вывода.

close

void close() throws IOException

Закрывает входной поток. Метод необходимо вызвать, чтобы освободить все ресурсы, связанные с потоком.

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

© 1993, 2025, 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.