java.io

Читатель класса

java.lang. Объект

java.io. Читатель

Все Реализованные Интерфейсы:

Closeable, AutoCloseable, Читаемый

Прямые Известные Подклассы:

BufferedReader, CharArrayReader, FilterReader, InputStreamReader, PipedReader, StringReader

public abstract class Reader
extends Object
implements Readable, Closeable

Абстрактный класс для того, чтобы считать символьные потоки. Единственные методы, которые должен реализовать подкласс, читаются (случайная работа [], интервал, интервал) и близко (). Большинство подклассов, однако, переопределит некоторые из методов, определенных здесь, чтобы обеспечить более высокую эффективность, дополнительную функциональность, или обоих.

С тех пор:

JDK1.1

См. Также:

BufferedReader, LineNumberReader, CharArrayReader, InputStreamReader, FileReader, FilterReader, PushbackReader, PipedReader, StringReader, Writer

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected Object	блокировка Объект, используемый, чтобы синхронизировать операции на этом потоке.

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	Reader() Создает нового символьно-потокового читателя, критические разделы которого будут синхронизироваться на читателе непосредственно.
protected	Reader(Object lock) Создает нового символьно-потокового читателя, критические разделы которого будут синхронизироваться на данном объекте.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract void	close() Закрывает поток и выпускает любые системные ресурсы, связанные с этим.
void	mark(int readAheadLimit) Отмечает нынешнее положение в потоке.
boolean	markSupported() Говорит, поддерживает ли этот поток метку () работа.
int	read() Читает единственный символ.
int	read(char[] cbuf) Символы чтений в массив.
abstract int	read(char[] cbuf, int off, int len) Символы чтений в часть массива.
int	read(CharBuffer target) Попытки считать символы в указанный символьный буфер.
boolean	ready() Говорит, готов ли этот поток быть считанным.
void	reset() Сбрасывает поток.
long	skip(long n) Символы пропусков.

Методы java.lang унаследованный от класса. Объект

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

Полевая Деталь

блокировка

protected Object lock

Объект, используемый, чтобы синхронизировать операции на этом потоке. Для эффективности символьный потоковый объект может использовать объект кроме себя, чтобы защитить критические разделы. Подкласс должен поэтому использовать объект в этом поле, а не this или синхронизируемом методе.

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

Читатель

protected Reader()

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

Читатель

protected Reader(Object lock)

Создает нового символьно-потокового читателя, критические разделы которого будут синхронизироваться на данном объекте.

Параметры:

lock - Объект синхронизироваться на.

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

читать

public int read(CharBuffer target)
         throws IOException

Попытки считать символы в указанный символьный буфер. Буфер используется в качестве репозитария символов как есть: единственные произведенные изменения являются результатами помещенной работы. Никакое зеркальное отражение или перемотка буфера не выполняются.

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

read в интерфейсе Readable

Параметры:

target - буфер, чтобы считать символы в

Возвраты:

Число символов, добавленных к буферу, или-1, если этот источник символов в его конце

Броски:

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

NullPointerException - если цель является нулем

ReadOnlyBufferException - если цель является буфером только для чтения

С тех пор:

1.5

читать

public int read()
         throws IOException

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

Подклассы, которые намереваются поддерживать эффективный одно-символьный ввод, должны переопределить этот метод.

Возвраты:

Символьное чтение, как целое число в диапазоне от 0 до 65535 (0x00-0xffff), или-1, если конец потока был достигнут

Броски:

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

читать

public int read(char[] cbuf)
         throws IOException

Символы чтений в массив. Этот метод блокирует, пока некоторый ввод не доступен, ошибка ввода-вывода происходит, или конец потока достигается.

Параметры:

cbuf - Целевой буфер

Возвраты:

Число символов читало, или-1, если конец потока был достигнут

Броски:

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

читать

public abstract int read(char[] cbuf,
       int off,
       int len)
                  throws IOException

Символы чтений в часть массива. Этот метод блокирует, пока некоторый ввод не доступен, ошибка ввода-вывода происходит, или конец потока достигается.

Параметры:

cbuf - Целевой буфер

off - Смещение, при котором можно начать хранить символы

len - Максимальное количество символов, чтобы читать

Возвраты:

Число символов читало, или-1, если конец потока был достигнут

Броски:

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

пропустить

public long skip(long n)
          throws IOException

Символы пропусков. Этот метод блокирует, пока некоторые символы не доступны, ошибка ввода-вывода происходит, или конец потока достигается.

Параметры:

n - Число символов, чтобы пропустить

Возвраты:

Число символов фактически пропускается

Броски:

IllegalArgumentException - Если n отрицательно.

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

готовый

public boolean ready()
              throws IOException

Говорит, готов ли этот поток быть считанным.

Возвраты:

Истина, если следующее чтение (), как гарантируют, не блокирует для ввода, ложь иначе. Отметьте, что возвращение false не гарантирует, что следующее чтение блокирует.

Броски:

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

markSupported

public boolean markSupported()

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

Возвраты:

истина, если и только если этот поток поддерживает работу метки.

метка

public void mark(int readAheadLimit)
          throws IOException

Отмечает нынешнее положение в потоке. Последующие вызовы, чтобы сбросить () будут делать попытку к репозиции потока к этой точке. Не все потоки ввода символов поддерживают метку () работа.

Параметры:

readAheadLimit - Предел на числе символов, которые могут быть считаны, все еще сохраняя метку. После чтения этого могут перестать работать много символов, пытаясь сбросить поток.

Броски:

IOException - Если поток не поддерживает метку (), или если некоторая другая ошибка ввода-вывода происходит

сброс

public void reset()
           throws IOException

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

Броски:

IOException - Если поток не был отмечен, или если метка была лишена законной силы, или если поток не поддерживает сброс (), или если некоторая другая ошибка ввода-вывода происходит

близко

public abstract void close()
                    throws IOException

Закрывает поток и выпускает любые системные ресурсы, связанные с этим. Как только поток был закрыт, далее считайте (), готовый (), метка (), сбросьте (), или пропуск (), вызовы бросят IOException. Закрытие ранее закрытого потока не имеет никакого эффекта.

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

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

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

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

Броски:

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