com.sun.xml.stream.writers

Class UTF8OutputStreamWriter

java.lang.Object

java.io.Writer

com.sun.xml.stream.writers.UTF8OutputStreamWriter

All Implemented Interfaces:

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

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

Constructors

Constructor and Description
UTF8OutputStreamWriter(java.io.OutputStream out)

Method Summary

Methods

Modifier and Type	Method and Description
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.io.Writer

append, append, append

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

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 interface java.lang.AutoCloseable

Specified by:

close in class java.io.Writer

Throws:

java.io.IOException