com.sun.xml.stream.writers
Class UTF8OutputStreamWriter

java.lang.Object
  extended by java.io.Writer
      extended by com.sun.xml.stream.writers.UTF8OutputStreamWriter
All Implemented Interfaces:
java.io.Closeable, java.io.Flushable, java.lang.Appendable

public final class UTF8OutputStreamWriter
extends java.io.Writer

This class is used to write a stream of chars as a stream of bytes using the UTF8 encoding. It assumes that the underlying output stream is buffered or does not need additional buffering.

It is more efficient than using a java.io.OutputStreamWriter because it does not need to be wrapped in a java.io.BufferedWriter. Creating multiple instances of java.io.BufferedWriter has been shown to be very expensive in JAX-WS.

Author:
Santiago.PericasGeertsen@sun.com

Field Summary
 
Fields inherited from class java.io.Writer
lock
 
Constructor Summary
UTF8OutputStreamWriter(java.io.OutputStream out)
           
 
Method Summary
 java.io.Writer append(char c)
           
 java.io.Writer append(java.lang.CharSequence csq)
           
 java.io.Writer append(java.lang.CharSequence csq, int start, int end)
           
 void close()
           
 void flush()
           
 java.lang.String getEncoding()
           
 void write(char[] cbuf)
           
 void write(char[] cbuf, int off, int len)
           
 void write(int c)
           
 void write(java.lang.String str)
           
 void write(java.lang.String str, int off, int len)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

UTF8OutputStreamWriter

public UTF8OutputStreamWriter(java.io.OutputStream out)
Method Detail

getEncoding

public java.lang.String getEncoding()

write

public void write(int c)
           throws java.io.IOException
Overrides:
write in class java.io.Writer
Throws:
java.io.IOException

write

public void write(char[] cbuf)
           throws java.io.IOException
Overrides:
write in class java.io.Writer
Throws:
java.io.IOException

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws java.io.IOException
Specified by:
write in class java.io.Writer
Throws:
java.io.IOException

write

public void write(java.lang.String str)
           throws java.io.IOException
Overrides:
write in class java.io.Writer
Throws:
java.io.IOException

write

public void write(java.lang.String str,
                  int off,
                  int len)
           throws java.io.IOException
Overrides:
write in class java.io.Writer
Throws:
java.io.IOException

append

public java.io.Writer append(java.lang.CharSequence csq)
                      throws java.io.IOException
Specified by:
append in interface java.lang.Appendable
Overrides:
append in class java.io.Writer
Throws:
java.io.IOException

append

public java.io.Writer append(java.lang.CharSequence csq,
                             int start,
                             int end)
                      throws java.io.IOException
Specified by:
append in interface java.lang.Appendable
Overrides:
append in class java.io.Writer
Throws:
java.io.IOException

append

public java.io.Writer append(char c)
                      throws java.io.IOException
Specified by:
append in interface java.lang.Appendable
Overrides:
append in class java.io.Writer
Throws:
java.io.IOException

flush

public void flush()
           throws java.io.IOException
Specified by:
flush in interface java.io.Flushable
Specified by:
flush in class java.io.Writer
Throws:
java.io.IOException

close

public void close()
           throws java.io.IOException
Specified by:
close in interface java.io.Closeable
Specified by:
close in class java.io.Writer
Throws:
java.io.IOException


Copyright ? 2002-2003 Apache XML Project. All Rights Reserved.