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.
Modifier and Type | Field and Description |
---|---|
pack-priv int | lastUTF16CodePoint
Java represents chars that are not in the Basic Multilingual Plane (BMP) in UTF-16. |
pack-priv OutputStream | out
Undelying output stream. |
Access | Constructor and Description |
---|---|
public |
Modifier and Type | Method and Description |
---|---|
public void | close()
Implements abstract java. Implements java. Closes the stream, flushing it first. |
public void | flush()
Implements abstract java. Implements java. Flushes the stream. |
public String | |
public void | write(int
int specifying a character to be written c)Overrides java. Writes a single character. |
public void | write(char[]
Array of characters to be written cbuf)Overrides java. Writes an array of characters. |
public void | write(char[]
Array of characters cbuf, int Offset from which to start writing characters off, int Number of characters to write len)Implements abstract java. Writes a portion of an array of characters. |
public void | |
public void | write(String
A String str, int Offset from which to start writing characters off, int Number of characters to write len)Overrides java. Writes a portion of a string. |
lastUTF16CodePoint | back to summary |
---|---|
pack-priv int lastUTF16CodePoint Java represents chars that are not in the Basic Multilingual Plane (BMP) in UTF-16. This int stores the first code unit for a code point encoded in two UTF-16 code units. |
out | back to summary |
---|---|
pack-priv OutputStream out Undelying output stream. This class assumes that this output stream does not need buffering. |
UTF8OutputStreamWriter | back to summary |
---|---|
public UTF8OutputStreamWriter(OutputStream out) |
close | back to summary |
---|---|
public void close() throws IOException Implements abstract java. Implements java. Doc from java. Closes the stream, flushing it first. Once the stream has been closed, further write() or flush() invocations will cause an IOException to be thrown. Closing a previously closed stream has no effect.
|
flush | back to summary |
---|---|
public void flush() throws IOException Implements abstract java. Implements java. Doc from java. Flushes the stream. If the stream has saved any characters from the various write() methods in a buffer, write them immediately to their intended destination. Then, if that destination is another character or byte stream, flush it. Thus one flush() invocation will flush all the buffers in a chain of Writers and OutputStreams. If the intended destination of this stream is an abstraction provided by the underlying operating system, for example a file, then flushing the stream guarantees only that bytes previously written to the stream are passed to the operating system for writing; it does not guarantee that they are actually written to a physical device such as a disk drive.
|
getEncoding | back to summary |
---|---|
public String getEncoding() |
write | back to summary |
---|---|
public void write(int c) throws IOException Overrides java. Doc from java. Writes a single character. The character to be written is contained in the 16 low-order bits of the given integer value; the 16 high-order bits are ignored. Subclasses that intend to support efficient single-character output should override this method.
|
write | back to summary |
---|---|
public void write(char[] cbuf) throws IOException Overrides java. Doc from java. Writes an array of characters.
|
write | back to summary |
---|---|
public void write(char[] cbuf, int off, int len) throws IOException Implements abstract java. Doc from java. Writes a portion of an array of characters.
|
write | back to summary |
---|---|
public void write(String str) throws IOException Overrides java. Doc from java. Writes a string.
|
write | back to summary |
---|---|
public void write(String str, int off, int len) throws IOException Overrides java. Doc from java. Writes a portion of a string.
|