java.io

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

java.lang. Объект

java.io. Писатель

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

Closeable, Flushable, Appendable, AutoCloseable

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

BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter

public abstract class Writer
extends Object
implements Appendable, Closeable, Flushable

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

С тех пор:

JDK1.1

См. Также:

Writer, BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, FileWriter, PipedWriter, PrintWriter, StringWriter, Reader

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

Поля

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

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

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

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

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

Методы

Модификатор и Тип	Метод и Описание
Писатель	append(char c) Добавляет указанный символ этому писателю.
Писатель	append(CharSequence csq) Добавляет указанную символьную последовательность этому писателю.
Писатель	append(CharSequence csq, int start, int end) Добавляет подпоследовательность указанной символьной последовательности этому писателю.
abstract void	close() Закрывает поток, сбрасывая это сначала.
abstract void	flush() Сбрасывает поток.
void	write(char[] cbuf) Пишет массив символов.
abstract void	write(char[] cbuf, int off, int len) Пишет часть массива символов.
void	write(int c) Пишет единственный символ.
void	write(String str) Пишет строка.
void	write(String str, int off, int len) Пишет часть строки.

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

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

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

блокировка

protected Object lock

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

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

Писатель

protected Writer()

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

Писатель

protected Writer(Object lock)

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

Параметры:

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

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

записать

public void write(int c)
           throws IOException

Пишет единственный символ. Символ, который будет записан, содержится в 16 битах младшего разряда данного целочисленного значения; 16 битов старшего разряда игнорируются.

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

Параметры:

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

Броски:

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

записать

public void write(char[] cbuf)
           throws IOException

Пишет массив символов.

Параметры:

cbuf - Массив символов, которые будут записаны

Броски:

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

записать

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

Пишет часть массива символов.

Параметры:

cbuf - Массив символов

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

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

Броски:

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

записать

public void write(String str)
           throws IOException

Пишет строка.

Параметры:

str - Строка, которая будет записана

Броски:

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

записать

public void write(String str,
         int off,
         int len)
           throws IOException

Пишет часть строки.

Параметры:

str - Строка

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

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

Броски:

IndexOutOfBoundsException - Если off отрицателен, или len отрицателен, или off+len отрицателен или больше чем длина данной строки

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

добавить

public Writer append(CharSequence csq)
              throws IOException

Добавляет указанную символьную последовательность этому писателю.

Вызов этого метода формы out.append(csq) ведет себя точно таким же образом как вызов

     out.write(csq.toString()) 

В зависимости от спецификации toString для символьной последовательности csq не может быть добавлена вся последовательность. Например, вызов метода toString символьного буфера возвратит подпоследовательность, контент которой зависит от позиции буфера и предела.

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

append в интерфейсе Appendable

Параметры:

csq - Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются этому писателю.

Возвраты:

Этот писатель

Броски:

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

С тех пор:

1.5

добавить

public Writer append(CharSequence csq,
            int start,
            int end)
              throws IOException

Добавляет подпоследовательность указанной символьной последовательности этому писателю. Appendable.

Вызов этого метода формы out.append(csq, start, end), когда csq не является null, ведет себя точно таким же образом как вызов

     out.write(csq.subSequence(start, end).toString()) 

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

append в интерфейсе Appendable

Параметры:

csq - Символьная последовательность, от которой будет добавлена подпоследовательность. Если csq будет null, то символы будут добавлены как будто csq, содержавший эти четыре символа "null".

start - Индекс первого символа в подпоследовательности

end - Индекс символа после последнего знака в подпоследовательности

Возвраты:

Этот писатель

Броски:

IndexOutOfBoundsException - Если start или end отрицательны, start больше чем end, или end больше чем csq.length()

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

С тех пор:

1.5

добавить

public Writer append(char c)
              throws IOException

Добавляет указанный символ этому писателю.

Вызов этого метода формы out.append(c) ведет себя точно таким же образом как вызов

     out.write(c) 

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

append в интерфейсе Appendable

Параметры:

c - 16-разрядный символ, чтобы добавить

Возвраты:

Этот писатель

Броски:

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

С тех пор:

1.5

сброс

public abstract void flush()
                    throws IOException

Сбрасывает поток. Если поток сохранил какие-либо символы от различной записи () методы в буфере, запишите им сразу в их намеченное место назначения. Затем, если то место назначения является другим символьным или потоком байтов, сбросьте его. Таким образом один сброс () вызов сбросит все буферы в цепочке Писателей и OutputStreams.

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

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

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

Броски:

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

близко

public abstract void close()
                    throws IOException

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

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

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

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

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

Броски:

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