Write text to a character-output stream, buffering characters so as
to provide for the efficient writing of single characters, arrays,
and strings.
Provide support for discarding for the output that has been buffered.
clear
public void clear()
throws IOException
Clear the contents of the buffer. If the buffer has been already
been flushed then the clear operation shall throw an IOException
to signal the fact that some data has already been irrevocably
written to the client response stream.
clearBuffer
public void clearBuffer()
throws IOException
Clears the current contents of the buffer. Unlike clear(), this
mehtod will not throw an IOException if the buffer has already been
flushed. It merely clears the current content of the buffer and
returns.
close
public void close()
throws IOException
Close the stream, flushing it first. Once a stream has been closed,
further write() or flush() invocations will cause an IOException to be
thrown. Closing a previously-closed stream, however, has no effect.
getReader
public Reader getReader()
Return the value of this BodyJspWriter as a Reader.
Note: this is after evaluation!! There are no scriptlets,
etc in this stream.
- the value of this BodyJspWriter as a Reader
getRemaining
public int getRemaining()
- the number of bytes unused in the buffer
getString
public String getString()
Return the value of the BodyJspWriter as a String.
Note: this is after evaluation!! There are no scriptlets,
etc in this stream.
- the value of the BodyJspWriter as a String
newLine
public void newLine()
throws IOException
Write a line separator. The line separator string is defined by the
system property line.separator, and is not necessarily a single
newline ('\n') character.
print
public void print(Object obj)
throws IOException
Print an object. The string produced by the
java.lang.String.valueOf(Object)
method is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
obj
- The Object
to be printed
print
public void print(String s)
throws IOException
Print a string. If the argument is
null
then the string
"null"
is printed. Otherwise, the string's characters are
converted into bytes according to the platform's default character
encoding, and these bytes are written in exactly the manner of the
write(int)
method.
s
- The String
to be printed
print
public void print(boolean b)
throws IOException
Print a boolean value. The string produced by
java.lang.String.valueOf(boolean)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
b
- The boolean
to be printed
print
public void print(char c)
throws IOException
Print a character. The character is translated into one or more bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
c
- The char
to be printed
print
public void print(char[] s)
throws IOException
Print an array of characters. The characters are converted into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
s
- The array of chars to be printed
print
public void print(double d)
throws IOException
Print a double-precision floating-point number. The string produced by
java.lang.String.valueOf(double)
is translated into
bytes according to the platform's default character encoding, and these
bytes are written in exactly the manner of the
write(int)
method.
d
- The double
to be printed
print
public void print(float f)
throws IOException
Print a floating-point number. The string produced by
java.lang.String.valueOf(float)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
f
- The float
to be printed
print
public void print(int i)
throws IOException
Print an integer. The string produced by
java.lang.String.valueOf(int)
is translated into bytes according
to the platform's default character encoding, and these bytes are
written in exactly the manner of the
write(int)
method.
i
- The int
to be printed
print
public void print(long l)
throws IOException
Print a long integer. The string produced by
java.lang.String.valueOf(long)
is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
write(int)
method.
l
- The long
to be printed
println
public void println()
throws IOException
Terminate the current line by writing the line separator string. The
line separator string is defined by the system property
line.separator
, and is not necessarily a single newline
character ('\n'
).
println
public void println(Object x)
throws IOException
Print an Object and then terminate the line. This method behaves as
though it invokes
print(Object)
and then
println()
.
println
public void println(String x)
throws IOException
Print a String and then terminate the line. This method behaves as
though it invokes
print(String)
and then
println()
.
println
public void println(boolean x)
throws IOException
Print a boolean value and then terminate the line. This method behaves
as though it invokes
print(boolean)
and then
println()
.
println
public void println(char x)
throws IOException
Print a character and then terminate the line. This method behaves as
though it invokes
print(char)
and then
println()
.
println
public void println(double x)
throws IOException
Print a double-precision floating-point number and then terminate the
line. This method behaves as though it invokes
print(double)
and then
println()
.
println
public void println(float x)
throws IOException
Print a floating-point number and then terminate the line. This method
behaves as though it invokes
print(float)
and then
println()
.
println
public void println(int x)
throws IOException
Print an integer and then terminate the line. This method behaves as
though it invokes
print(int)
and then
println()
.
println
public void println(long x)
throws IOException
Print a long integer and then terminate the line. This method behaves
as though it invokes
print(long)
and then
println()
.
println
public void println(x[] )
throws IOException
Print an array of characters and then terminate the line. This method
behaves as though it invokes
print(char[])
and
then
println()
.
write
public void write(String s)
throws IOException
Write a string. This method cannot be inherited from the Writer class
because it must suppress I/O exceptions.
write
public void write(String s,
int off,
int len)
throws IOException
Write a portion of a String.
s
- String to be writtenoff
- Offset from which to start reading characterslen
- Number of characters to be written
write
public void write(char[] buf)
throws IOException
Write an array of characters. This method cannot be inherited from the
Writer class because it must suppress I/O exceptions.
write
public void write(char[] cbuf,
int off,
int len)
throws IOException
Write a portion of an array of characters.
Ordinarily this method stores characters from the given array into
this stream's buffer, flushing the buffer to the underlying stream as
needed. If the requested length is at least as large as the buffer,
however, then this method will flush the buffer and write the characters
directly to the underlying stream. Thus redundant
DiscardableBufferedWriter
s will not copy data
unnecessarily.
cbuf
- A character arrayoff
- Offset from which to start reading characterslen
- Number of characters to write
write
public void write(int c)
throws IOException
Write a single character.
writeOut
public void writeOut(Writer out)
throws IOException
Write the contents of this BodyJspWriter into a Writer.
Subclasses are likely to do interesting things with the
implementation so some things are extra efficient.
out
- The writer into which to place the contents of this body
evaluation