Save This Page
Home » apache-tomcat-6.0.16-src » org.apache » jasper » runtime » [javadoc | source]
org.apache.jasper.runtime
public class: JspWriterImpl [javadoc | source]
java.lang.Object
   java.io.Writer
      javax.servlet.jsp.JspWriter
         org.apache.jasper.runtime.JspWriterImpl

All Implemented Interfaces:
    Closeable, Flushable, Appendable

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. This needs revisiting when the buffering problems in the JSP spec are fixed -akv
Field Summary
static  String lineSeparator     
Fields inherited from javax.servlet.jsp.JspWriter:
NO_BUFFER,  DEFAULT_BUFFER,  UNBOUNDED_BUFFER
Constructor:
 public JspWriterImpl() 
 public JspWriterImpl(ServletResponse response) 
    Create a buffered character-output stream that uses a default-sized output buffer.
    Parameters:
    response - A Servlet Response
 public JspWriterImpl(ServletResponse response,
    int sz,
    boolean autoFlush) 
    Create a new buffered character-output stream that uses an output buffer of the given size.
    Parameters:
    response - A Servlet Response
    sz - Output-buffer size, a positive integer
    Throws:
    IllegalArgumentException - If sz is <= 0
    exception: IllegalArgumentException - If sz is <= 0
Method from org.apache.jasper.runtime.JspWriterImpl Summary:
clear,   clearBuffer,   close,   flush,   flushBuffer,   getRemaining,   init,   newLine,   print,   print,   print,   print,   print,   print,   print,   print,   print,   println,   println,   println,   println,   println,   println,   println,   println,   println,   println,   recycle,   write,   write,   write,   write,   write
Methods from javax.servlet.jsp.JspWriter:
clear,   clearBuffer,   close,   flush,   getBufferSize,   getRemaining,   isAutoFlush,   newLine,   print,   print,   print,   print,   print,   print,   print,   print,   print,   println,   println,   println,   println,   println,   println,   println,   println,   println,   println
Methods from java.io.Writer:
append,   append,   append,   append,   append,   append,   close,   flush,   write,   write,   write,   write,   write
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.jasper.runtime.JspWriterImpl Detail:
 public final  void clear() throws IOException 
    Discard the output buffer.
 public  void clearBuffer() throws IOException 
 public  void close() throws IOException 
    Close the stream.
 public  void flush() throws IOException 
    Flush the stream.
 protected final  void flushBuffer() throws IOException 
    Flush the output buffer to the underlying character stream, without flushing the stream itself. This method is non-private only so that it may be invoked by PrintStream.
 public int getRemaining() 
  void init(ServletResponse response,
    int sz,
    boolean autoFlush) 
 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.
 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.
 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.
 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.
 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.
 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.
 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.
 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.
 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.
 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.
 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'). Need to change this from PrintWriter because the default println() writes to the sink directly instead of through the write method...
 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() .
 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() .
 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() .
 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() .
 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() .
 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() .
 public  void println(char[] 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() .
 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() .
 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() .
  void recycle() 
    Package-level access
 public  void write(int c) throws IOException 
    Write a single character.
 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.
 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.
 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 DiscardableBufferedWriters will not copy data unnecessarily.

 public  void write(String s,
    int off,
    int len) throws IOException 
    Write a portion of a String.