Интерфейс DataInput

void readFully(byte[] b) throws IOException

Считывает несколько байтов из входного потока и сохраняет их в массив буфера b. Количество считанных байтов равно длине b.

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

• b.length байты входных данных доступны, в этом случае выполняется обычное возвращение.
• Обнаружен конец файла, в этом случае выбрасывается EOFException.
• Возникает ошибка ввода-вывода, в этом случае выбрасывается IOException отличная от EOFException.

Если b равно null, выбрасывается NullPointerException. Если b.length равно нулю, то байты не считываются. В противном случае первый считанный байт сохраняется в элемент b[0], следующий - в b[1], и так далее. Если из этого метода выбрасывается исключение, то возможно, что некоторые, но не все байты b были обновлены данными из входного потока.

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

Считывает len байтов из входного потока.

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

• len байты входных данных доступны, в этом случае выполняется обычное возвращение.
• Обнаружен конец файла, в этом случае выбрасывается EOFException.
• Возникает ошибка ввода-вывода, в этом случае выбрасывается IOException отличная от EOFException.

Если b равно null, выбрасывается NullPointerException. Если off отрицательное, или len отрицательное, или off+len больше длины массива b, выбрасывается IndexOutOfBoundsException. Если len равно нулю, то байты не считываются. В противном случае первый считанный байт сохраняется в элемент b[off], следующий - в b[off+1], и так далее. Количество считанных байтов, самое большее, равно len.

int skipBytes(int n) throws IOException

Пытается пропустить n байтов данных из входного потока, отбрасывая пропущенные байты. Однако может пропустить меньшее количество байтов, возможно, ноль. Это может произойти по ряду причин; достижение конца файла до того, как было пропущено n байтов, — всего лишь один из вариантов. Этот метод никогда не выбрасывает EOFException. Возвращается фактическое количество пропущенных байтов.

boolean readBoolean() throws IOException

Считывает один байт входных данных и возвращает true, если этот байт не равен нулю, false, если этот байт равен нулю. Этот метод подходит для чтения байта, записанного методом writeBoolean интерфейса DataOutput.

byte readByte() throws IOException

Считывает и возвращает один байт входных данных. Байта обрабатывается как значение со знаком в диапазоне -128 по 127, включительно. Этот метод подходит для чтения байта, записанного методом writeByte интерфейса DataOutput.

int readUnsignedByte() throws IOException

Считывает один байт входных данных, расширяет его до типа int, не расширяя знак, и возвращает результат, который, следовательно, находится в диапазоне 0 по 255. Этот метод подходит для чтения байта, записанного методом writeByte интерфейса DataOutput, если аргумент метода writeByte предполагалось значение в диапазоне 0 по 255.

short readShort() throws IOException

Считывает два входных байта и возвращает значение типа short. Пусть a — первый считанный байт, а b — второй байт. Возвращаемое значение:

(short)((a << 8) | (b & 0xff))
 

Этот метод подходит для чтения байтов, записанных методом writeShort интерфейса DataOutput.

int readUnsignedShort() throws IOException

Считывает два входных байта и возвращает значение типа int в диапазоне 0 по 65535. Пусть a — первый считанный байт, а b — второй байт. Возвращаемое значение:

(((a & 0xff) << 8) | (b & 0xff))
 

Этот метод подходит для чтения байтов, записанных методом writeShort интерфейса DataOutput, если аргумент метода writeShort предполагалось значение в диапазоне 0 по 65535.

char readChar() throws IOException

Считывает два входных байта и возвращает значение типа char. Пусть a — первый считанный байт, а b — второй байт. Возвращаемое значение:

(char)((a << 8) | (b & 0xff))
 

Этот метод подходит для чтения байтов, записанных методом writeChar интерфейса DataOutput.

int readInt() throws IOException

Считывает четыре входных байта и возвращает значение типа int. Пусть a-d — первый, второй, третий и четвертый считанные байты. Возвращаемое значение:

 (((a & 0xff) << 24) | ((b & 0xff) << 16) |
  ((c & 0xff) <<  8) | (d & 0xff))
 

Этот метод подходит для чтения байтов, записанных методом writeInt интерфейса DataOutput.

long readLong() throws IOException

Считывает восемь входных байтов и возвращает значение типа long. Пусть a-h — первый по восьмой считанные байты. Возвращаемое значение:

 (((long)(a & 0xff) << 56) |
  ((long)(b & 0xff) << 48) |
  ((long)(c & 0xff) << 40) |
  ((long)(d & 0xff) << 32) |
  ((long)(e & 0xff) << 24) |
  ((long)(f & 0xff) << 16) |
  ((long)(g & 0xff) <<  8) |
  ((long)(h & 0xff)))
 

Этот метод подходит для чтения байтов, записанных методом writeLong интерфейса DataOutput.

float readFloat() throws IOException

Считывает четыре входных байта и возвращает значение типа float. Для этого сначала создается значение типа int точно так же, как в методе readInt, а затем это значение типа int преобразуется в float точно так же, как в методе Float.intBitsToFloat. Этот метод подходит для чтения байтов, записанных методом writeFloat интерфейса DataOutput.

double readDouble() throws IOException

Читает восемь байтов входных данных и возвращает значение типа double. Это делается путём сначала построения значения типа long точно так же, как и в методе readLong, а затем преобразования этого значения типа long в значение типа double точно так же, как и в методе Double.longBitsToDouble. Данный метод подходит для чтения байтов, записанных методом writeDouble интерфейса DataOutput.

String readLine() throws IOException

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

Если в ходе чтения достигнут конец файла, даже если ни один байт ещё не был прочитан, то возвращается null. В противном случае каждый прочитанный байт преобразуется в тип char путём расширения нулями. Если встретится символ '\n', он игнорируется, и чтение прекращается. Если встретится символ '\r', он игнорируется, и если следующий байт преобразуется в символ '\n', то и он игнорируется; чтение прекращается. Если конец файла встретится до того, как встретятся символы '\n' и '\r', чтение прекращается. После прекращения чтения возвращается String, содержащая все прочитанные и не отброшенные символы в том порядке, в котором они были прочитаны. Обратите внимание, что каждое значение символа в этой строке будет меньше \u0100, то есть (char)256.

String readUTF() throws IOException

Читает строку, закодированную в формате модифицированного UTF-8. Общий контракт метода readUTF заключается в том, что он читает представление строки Unicode, закодированной в формате модифицированного UTF-8; эта строка символов затем возвращается в виде String.

Сначала считываются два байта, которые используются для построения беззнакового 16-битного целого числа точно так же, как и в методе readUnsignedShort. Это целое значение называется длиной UTF и определяет количество дополнительных байтов, которые необходимо прочитать. Эти байты затем преобразуются в символы, рассматривая их группами. Длина каждой группы вычисляется из значения первого байта группы. Байты, следующие за группой, если таковые имеются, являются первыми байтами следующей группы.

Если первый байт группы соответствует битовой последовательности 0xxxxxxx (где x означает "может быть 0 или 1"), то группа состоит только из этого байта. Байты расширяются нулями до формирования символа.

Если первый байт группы соответствует битовой последовательности 110xxxxx, то группа состоит из этого байта a и второго байта b. Если байта b нет (потому что байт a был последним из прочитанных байтов), или если байт b не соответствует битовой последовательности 10xxxxxx, то выбрасывается исключение UTFDataFormatException. В противном случае группа преобразуется в символ:

(char)(((a & 0x1F) << 6) | (b & 0x3F))
 

Если первый байт группы соответствует битовой последовательности 1110xxxx, то группа состоит из этого байта a и двух дополнительных байтов b и c. Если байта c нет (потому что байт a был одним из двух последних прочитанных байтов), или байт b или байт c не соответствует битовой последовательности 10xxxxxx, то выбрасывается исключение UTFDataFormatException. В противном случае группа преобразуется в символ:

 (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
 

Если первый байт группы соответствует последовательности 1111xxxx или последовательности 10xxxxxx, то выбрасывается исключение UTFDataFormatException.

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

После преобразования каждой группы в символ в указанном порядке, полученные символы собираются в String, который и возвращается.

Метод writeUTF интерфейса DataOutput может использоваться для записи данных, пригодных для чтения этим методом.