Spec-Zone .ru спецификации, руководства, описания, API

javax.servlet.jsp
Класс JspWriter

java.lang.Object
  java.io.Writer
      javax.servlet.jsp.JspWriter

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

java.io. Closeable, java.io. Flushable, java.lang. Appendable

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

BodyContent

public abstract class JspWriter
расширяет java.io. Писатель

Данные действий и шаблона в странице JSP пишутся, используя объект JspWriter, на который ссылается неявная переменная, которая инициализируется, автоматически используя методы в объекте PageContext.

Этот абстрактный class эмулирует часть функциональности, найденной в java.io. BufferedWriter и java.io. Классы PrintWriter, однако это отличается, в который это бросает java.io. IOException от методов печати, в то время как PrintWriter не делает.

Буферизация

Начальный объект JspWriter связывается с объектом PrintWriter ServletResponse в пути, который зависит от того, является ли страница или не буферизуется. Если страница не будет буферизована, выведите записанный этому объекту JspWriter, то будет записан через PrintWriter непосредственно, который будет создаваться в случае необходимости, вызывая getWriter () метод на объекте ответа. Но если страница будет буферизована, то объект PrintWriter не будет создаваться, пока буфер не будет сброшен, и операции как setContentType () законные. Так как эта гибкость упрощает программирование существенно, буферизация является значением по умолчанию для страниц JSP.

Буферизация повышает проблему того, что сделать, когда буфер превышается. Могут быть проявлены два подхода:

• Превышение буфера не является фатальной ошибкой; когда буфер превышается, только сбросьте вывод.
• Превышение буфера является фатальной ошибкой; когда буфер превышается, повысьте исключение.

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

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

Неявная переменная реализации JSP class имеет этот тип. Если направляющая страница выберет автосброс = "истина" тогда, то все операции ввода-вывода на этом class должны автоматически сбросить содержание буфера, если условие переполнения закончилось бы, если бы текущая работа выполнялась без сброса. Если автосброс = "ложь" тогда все операции ввода-вывода на этом class должны бросить IOException, если выполнение текущей работы привело бы к условию переполнения буфера.

См. Также:

Writer, BufferedWriter, PrintWriter

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

protected boolean	автосброс Автосбрасывает ли JspWriter.
protected int	bufferSize Размер буфера используется JspWriter.
static int	DEFAULT_BUFFER Постоянное указание, что Писатель буферизуется и использует размер буфера значения по умолчанию реализации.
static int	NO_BUFFER Постоянное указание, что Писатель не буферизует вывод.
static int	UNBOUNDED_BUFFER Постоянное указание, что Писатель буферизуется и неограничен; это используется в BodyContent.

Поля, наследованные от class java.io. Писатель

lock

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

protected

JspWriter(int bufferSize, boolean autoFlush) Защищенный конструктор.

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

abstract void	clear() Очистите содержание буфера.
abstract void	clearBuffer() Очищает текущее содержание буфера.
abstract void	close() Закройте поток, сбрасывая это сначала.
abstract void	flush() Сбросьте поток.
int	getBufferSize() Этот метод возвращает размер буфера, используемого JspWriter.
abstract int	getRemaining() Этот метод возвращает число неиспользованных байтов в буфере.
boolean	isAutoFlush() Этот метод указывает, автосбрасывает ли JspWriter.
abstract void	newLine() Запишите разделитель строки.
abstract void	print(boolean b) Напечатайте булево значение.
abstract void	print(char c) Напечатайте символ.
abstract void	print(char[] s) Напечатайте массив символов.
abstract void	print(double d) Напечатайте двойную точность число с плавающей точкой.
abstract void	print(float f) Напечатайте число с плавающей точкой.
abstract void	print(int i) Напечатайте целое число.
abstract void	print(long l) Напечатайте длинное целое.
abstract void	print(java.lang.Object obj) Напечатайте объект.
abstract void	print(java.lang.String s) Напечатайте строку.
abstract void	println() Завершите текущую строку при записи строки разделителя строки.
abstract void	println(boolean x) Напечатайте булево значение и затем завершите строку.
abstract void	println(char x) Напечатайте символ и затем завершите строку.
abstract void	println(char[] x) Напечатайте массив символов и затем завершите строку.
abstract void	println(double x) Напечатайте двойную точность число с плавающей точкой и затем завершите строку.
abstract void	println(float x) Напечатайте число с плавающей точкой и затем завершите строку.
abstract void	println(int x) Напечатайте целое число и затем завершите строку.
abstract void	println(long x) Напечатайте длинное целое и затем завершите строку.
abstract void	println(java.lang.Object x) Напечатайте Объект и затем завершите строку.
abstract void	println(java.lang.String x) Напечатайте Строку и затем завершите строку.

Методы, наследованные от class java.io. Писатель

append, append, append, write, write, write, write, write

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

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

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

NO_BUFFER

public static final int NO_BUFFER

Постоянное указание, что Писатель не буферизует вывод.

См. Также:

Постоянные Значения полей

DEFAULT_BUFFER

public static final int DEFAULT_BUFFER

Постоянное указание, что Писатель буферизуется и использует размер буфера значения по умолчанию реализации.

См. Также:

Постоянные Значения полей

UNBOUNDED_BUFFER

public static final int UNBOUNDED_BUFFER

Постоянное указание, что Писатель буферизуется и неограничен; это используется в BodyContent.

См. Также:

Постоянные Значения полей

bufferSize

protected int bufferSize

Размер буфера используется JspWriter.

автосброс

protected boolean autoFlush

Автосбрасывает ли JspWriter.

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

JspWriter

protected JspWriter(int bufferSize,
                    boolean autoFlush)

Защищенный конструктор.

Параметры:

bufferSize - размер буфера, который будет использоваться JspWriter

autoFlush - должен ли JspWriter автосбрасывать

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

новая строка

public abstract void newLine()
                      throws java.io.IOException

Запишите разделитель строки. Строка разделителя строки определяется системным свойством line.separator, и является не обязательно единственной новой строкой ('\n') символ.

Броски:

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

печать

public abstract void print(boolean b)
                    throws java.io.IOException

Напечатайте булево значение. Строка, произведенная String.valueOf(boolean) пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

b - boolean быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

печать

public abstract void print(char c)
                    throws java.io.IOException

Напечатайте символ. Символ пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

c - char быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

печать

public abstract void print(int i)
                    throws java.io.IOException

Напечатайте целое число. Строка, произведенная String.valueOf(int) пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

i - int быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

См. Также:

Integer.toString(int)

печать

public abstract void print(long l)
                    throws java.io.IOException

Напечатайте длинное целое. Строка, произведенная String.valueOf(long) пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

l - long быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

См. Также:

Long.toString(long)

печать

public abstract void print(float f)
                    throws java.io.IOException

Напечатайте число с плавающей точкой. Строка, произведенная String.valueOf(float) пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

f - float быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

См. Также:

Float.toString(float)

печать

public abstract void print(double d)
                    throws java.io.IOException

Напечатайте двойную точность число с плавающей точкой. Строка, произведенная String.valueOf(double) пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

d - double быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

См. Также:

Double.toString(double)

печать

public abstract void print(char[] s)
                    throws java.io.IOException

Напечатайте массив символов. Символы пишутся буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

s - Массив случайных работ, которые будут напечатаны

Броски:

java.lang.NullPointerException - Если s null

java.io.IOException - Если ошибка произошла при записи

печать

public abstract void print(java.lang.String s)
                    throws java.io.IOException

Напечатайте строку. Если параметр null тогда строка "null" печатается. Иначе, символы строки пишутся буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

s - String быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

печать

public abstract void print(java.lang.Object obj)
                    throws java.io.IOException

Напечатайте объект. Строка, произведенная String.valueOf(Object) метод пишется буферу JspWriter или, если никакой буфер не используется, непосредственно базовому писателю.

Параметры:

obj - Object быть напечатанным

Броски:

java.io.IOException - Если ошибка произошла при записи

См. Также:

Object.toString()

println

public abstract void println()
                      throws java.io.IOException

Завершите текущую строку при записи строки разделителя строки. Строка разделителя строки определяется системным свойством line.separator, и не обязательно единственный символ новой строки ('\n').

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(boolean x)
                      throws java.io.IOException

Напечатайте булево значение и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(boolean) и затем println().

Параметры:

x - булево, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(char x)
                      throws java.io.IOException

Напечатайте символ и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(char) и затем println().

Параметры:

x - случайная работа, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(int x)
                      throws java.io.IOException

Напечатайте целое число и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(int) и затем println().

Параметры:

x - интервал, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(long x)
                      throws java.io.IOException

Напечатайте длинное целое и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(long) и затем println().

Параметры:

x - длинное, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(float x)
                      throws java.io.IOException

Напечатайте число с плавающей точкой и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(float) и затем println().

Параметры:

x - плавание, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(double x)
                      throws java.io.IOException

Напечатайте двойную точность число с плавающей точкой и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(double) и затем println().

Параметры:

x - вдвое большее по сравнению с записью

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(char[] x)
                      throws java.io.IOException

Напечатайте массив символов и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(char[]) и затем println().

Параметры:

x - случайная работа [], чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(java.lang.String x)
                      throws java.io.IOException

Напечатайте Строку и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(String) и затем println().

Параметры:

x - Строка, чтобы записать

Броски:

java.io.IOException - Если ошибка произошла при записи

println

public abstract void println(java.lang.Object x)
                      throws java.io.IOException

Напечатайте Объект и затем завершите строку. Этот метод ведет себя, как если бы он вызывает print(Object) и затем println().

Параметры:

x - Объект записать

Броски:

java.io.IOException - Если ошибка произошла при записи

очистить

public abstract void clear()
                    throws java.io.IOException

Очистите содержание буфера. Если буфер уже был сброшен тогда, четкая работа должна бросить IOException, чтобы сигнализировать факт, что некоторые данные были уже безвозвратно записаны клиентскому ответному потоку.

Броски:

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

clearBuffer

public abstract void clearBuffer()
                          throws java.io.IOException

Очищает текущее содержание буфера. В отличие от четкого (), этот метод не будет бросать IOException, если буфер был уже сброшен. Это просто очищает текущий контент буфера и возвратов.

Броски:

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

сброс

public abstract void flush()
                    throws java.io.IOException

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

Метод может быть вызван косвенно, если размер буфера превышается.

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

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

flush в интерфейсе java.io.Flushable

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

flush в class java.io.Writer

Броски:

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

близко

public abstract void close()
                    throws java.io.IOException

Закройте поток, сбрасывая это сначала.

Этот метод не должен быть вызван явно для начального JspWriter, поскольку код, сгенерированный контейнером JSP, будет автоматически включать вызов, чтобы закрыться ().

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

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

close в интерфейсе java.io.Closeable

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

close в class java.io.Writer

Броски:

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

getBufferSize

public int getBufferSize()

Этот метод возвращает размер буфера, используемого JspWriter.

Возвраты:

размер буфера в байтах, или 0 небуферизуется.

getRemaining

public abstract int getRemaining()

Этот метод возвращает число неиспользованных байтов в буфере.

Возвраты:

число байтов, неиспользованных в буфере

isAutoFlush

public boolean isAutoFlush()

Этот метод указывает, автосбрасывает ли JspWriter.

Возвраты:

если этот JspWriter является автоматическим сбрасыванием или броском IOExceptions на условиях переполнения буфера