Класс InputStream

Считывает следующий байт данных из потока ввода. Значение байта возвращается как int в диапазоне 0 до 255. Если байт недоступен, потому что достигнут конец потока, возвращается значение -1. Данный метод блокируется до тех пор, пока данные ввода не станут доступными, не будет обнаружен конец потока или не будет выброшено исключение.

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

Считывает некоторое количество байтов из потока ввода и сохраняет их в массив буфера b. Количество фактически считанных байтов возвращается в виде целого числа. Данный метод блокируется до тех пор, пока данные ввода не станут доступными, не будет обнаружен конец файла или не будет выброшено исключение.

Если длина b равна нулю, то байты не считываются, и возвращается 0; в противном случае производится попытка считывания как минимум одного байта. Если байт недоступен из-за достижения конца файла, возвращается значение -1; в противном случае как минимум один байт считывается и сохраняется в b.

Первый считанный байт сохраняется в элемент b[0], следующий - в b[1] и так далее. Количество считанных байтов не превышает длины b. Пусть k - количество фактически считанных байтов; эти байты будут сохранены в элементах b[0] по b[k-1], оставляя элементы b[k] по b[b.length-1] неизменными.

Метод read(b) для класса InputStream имеет тот же эффект, что и:

read(b, 0, b.length)

Считывает до len байтов данных из потока ввода в массив байтов. Производится попытка считать до len байтов, но может быть считан меньший объём. Количество фактически считанных байтов возвращается в виде целого числа.

Данный метод блокируется до тех пор, пока данные ввода не станут доступными, не будет обнаружен конец файла или не будет выброшено исключение.

Если len равно нулю, то байты не считываются и возвращается 0; в противном случае производится попытка считывания как минимум одного байта. Если байт недоступен из-за достижения конца файла, возвращается значение -1; в противном случае как минимум один байт считывается и сохраняется в b.

Первый считанный байт сохраняется в элемент b[off], следующий - в b[off+1] и так далее. Количество считанных байтов не превышает len. Пусть k - количество фактически считанных байтов; эти байты будут сохранены в элементах b[off] по b[off+k-1], оставляя элементы b[off+k] по b[off+len-1] неизменными.

В любом случае, элементы b[0] по b[off] и элементы b[off+len] по b[b.length-1] остаются неизменными.

Метод read(b, off, len) для класса InputStream просто многократно вызывает метод read(). Если первый вызов приводит к IOException, то данное исключение возвращается из вызова метода read(b, off, len). Если любой последующий вызов read() приводит к IOException, исключение перехватывается и обрабатывается как конец файла; считанные до этого момента байты сохраняются в b, и возвращается количество байтов, прочитанных до возникновения исключения. По умолчанию этот метод блокируется до тех пор, пока не будет прочитано необходимое количество входных данных len, не будет обнаружен конец файла или не будет выброшено исключение. Подклассы рекомендуют предоставить более эффективную реализацию этого метода.

Пропускает и отбрасывает n байтов данных из этого потока ввода. Метод skip может по различным причинам пропустить меньшее количество байтов, возможно 0. Это может быть результатом различных условий; достижение конца файла до того, как было пропущено n байтов, — лишь один из вариантов. Возвращается фактическое количество пропущенных байтов. Если n отрицательное, метод skip для класса InputStream всегда возвращает 0, и байты не пропускаются. Подклассы могут обрабатывать отрицательное значение по-разному.

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

Возвращает оценку количества байтов, которые можно прочитать (или пропустить) из этого потока ввода без блокировки до следующего вызова метода для данного потока ввода. Следующий вызов может быть выполнен той же или другой нитью.

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

Реализация этого метода в подклассе может выбрать выброс исключения IOException, если этот поток ввода был закрыт с помощью вызова метода close().

Метод available для класса InputStream всегда возвращает 0.

Этот метод должен быть переопределен подклассами.

Закрывает этот поток ввода и высвобождает все системные ресурсы, связанные с потоком.

Метод close для InputStream ничего не делает.

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

Аргумент readlimit сообщает этому потоку ввода разрешить чтение такого количества байтов, прежде чем позиция метки станет недействительной.

Общая спецификация метода mark заключается в том, что, если метод markSupported возвращает true, поток как-то запоминает все байты, прочитанные после вызова mark, и готов предоставить те же байты снова при каждом вызове метода reset. Однако поток не обязан запоминать какие-либо данные, если из потока прочитано более readlimit байтов перед вызовом reset.

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

Метод mark для InputStream ничего не делает.

Перемещает этот поток к позиции, на которой находился метод mark в последний раз, вызываемый на этом потоке ввода.

Общий контракт метода reset:

• Если метод markSupported возвращает true, то:
  • Если метод mark не вызывался с момента создания потока или количество прочитанных байтов из потока с момента последнего вызова mark больше аргумента метода mark при этом вызове, то может быть выброшено исключение IOException.
  • Если такое исключение не выброшено, то поток сбрасывается в состояние, при котором все байты, прочитанные с момента последнего вызова mark (или с начала файла, если mark не вызывался), будут повторно предоставлены последующим вызовам метода read, а затем любые байты, которые в противном случае были бы следующими входными данными на момент вызова reset.
• Если метод markSupported возвращает false, то:
  • Вызов метода reset может выбросить исключение IOException.
  • Если исключение не выброшено, то поток сбрасывается в фиксированное состояние, зависящее от конкретного типа потока ввода и способа его создания. Байты, которые будут предоставлены последующим вызовам метода read, зависят от конкретного типа потока ввода.

Метод reset для класса InputStream ничего не делает, кроме как выбросить исключение IOException.