jsimple.io

Class Utf8OutputStreamWriter

java.lang.Object

jsimple.lang.AutoCloseable

jsimple.io.Writer

jsimple.io.Utf8OutputStreamWriter

All Implemented Interfaces:

java.lang.AutoCloseable

public class Utf8OutputStreamWriter
extends Writer

This class was based on, and modified from, the Apache Harmony java.io.OutputStreamWriter class. Unlike the standard Java Writer subclasses, this doesn't throw any checked exceptions.

A class for turning a character stream into a byte stream. Data written to the target writer is converted into bytes, using UTF-8 encoding.

Since:

10/14/12 9:52 PM

See Also:

Utf8InputStreamReader

Constructor Summary

Constructors

Constructor and Description
Utf8OutputStreamWriter(OutputStream outputStream) Constructs a new OutputStreamWriter using out as the target stream to write converted characters to.
Utf8OutputStreamWriter(OutputStream outputStream, boolean closeOuterStream) Constructs a new OutputStreamWriter using out as the target stream to write converted characters to.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this writer.
void	flush() Flushes this writer.
void	write(char[] buf, int offset, int count) Writes count characters starting at offset in buf to this writer.

Methods inherited from class jsimple.io.Writer

getLineSeparator, setLineSeparator, write, write, write, write, writeln, writeln

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Utf8OutputStreamWriter

public Utf8OutputStreamWriter(OutputStream outputStream)

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to.

Parameters:

outputStream - the non-null target stream to write converted bytes to

Utf8OutputStreamWriter

public Utf8OutputStreamWriter(OutputStream outputStream,
                              boolean closeOuterStream)

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to.

Parameters:

outputStream - the non-null target stream to write converted bytes to

closeOuterStream - whether or not to close the outer stream when this stream is close

Method Detail

close

public void close()

Description copied from class: Writer

Closes this writer. Implementations of this method should free any resources associated with the writer.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class Writer

Throws:

IOException - if an error occurs while closing this writer.

flush

public void flush()

Flushes this writer. This implementation ensures that all buffered bytes are written to the target stream. After writing the bytes, the target stream is flushed as well.

Specified by:

flush in class Writer

Throws:

IOException - if an error occurs while flushing this writer

write

public void write(char[] buf,
                  int offset,
                  int count)

Writes count characters starting at offset in buf to this writer. The characters are immediately converted to bytes by the character converter and stored in a local buffer. If the buffer gets full as a result of the conversion, this writer is flushed.

Specified by:

write in class Writer

Parameters:

buf - the array containing characters to write.

offset - the index of the first character in buf to write.

count - the maximum number of characters to write.

Throws:

java.lang.IndexOutOfBoundsException - if offset < 0 or count < 0, or if offset + count is greater than the size of buf.

IOException - if this writer has already been closed or another I/O error occurs.