Module com.aoapps.io.buffer

Package com.aoapps.io.buffer

Class CharArrayBufferWriter

java.lang.Object

java.io.Writer

com.aoapps.io.buffer.BufferWriter

com.aoapps.io.buffer.CharArrayBufferWriter

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

public class CharArrayBufferWriter
extends BufferWriter

Writes to a set of internally managed buffers. When possible, the buffers are reused.

Maximum length is 2 ^ 30 characters (about 1 billion). When this limit is insufficient, consider using along with AutoTempFileWriter.

This class is not thread safe.

Author:

AO Industries, Inc.

See Also:

• for a possibly more efficient implementation.

Field Summary

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor	Description
CharArrayBufferWriter()

Method Summary

Modifier and Type	Method	Description
CharArrayBufferWriter	append(char c)
CharArrayBufferWriter	append(CharSequence csq)
CharArrayBufferWriter	append(CharSequence csq, int start, int end)
void	close()
void	flush()
long	getLength()	Gets the number of characters in this buffer.
BufferResult	getResult()	Gets the result from this buffer.
String	toString()	Gets a short message (like type and length).
void	write(char[] cbuf, int off, int len)
void	write(int c)
void	write(String str, int off, int len)

Methods inherited from class java.io.Writer

nullWriter, write, write

Methods inherited from class java.lang.Object

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

Constructor Details

CharArrayBufferWriter

public CharArrayBufferWriter()

Method Details

write

public void write(int c)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

write

public void write(char[] cbuf,
 int off,
 int len)
           throws IOException

Specified by:

write in class Writer

Throws:

IOException

write

public void write(String str,
 int off,
 int len)
           throws IOException

Overrides:

write in class Writer

Throws:

IOException

append

public CharArrayBufferWriter append(CharSequence csq)
                             throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class Writer

Throws:

IOException

append

public CharArrayBufferWriter append(CharSequence csq,
 int start,
 int end)
                             throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class Writer

Throws:

IOException

append

public CharArrayBufferWriter append(char c)
                             throws IOException

Specified by:

append in interface Appendable

Overrides:

append in class Writer

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Specified by:

flush in class Writer

Throws:

IOException

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in class Writer

getLength

public long getLength()

Description copied from class: BufferWriter

Gets the number of characters in this buffer. Once closed, this length will not be modified.

Specified by:

getLength in class BufferWriter

toString

public String toString()

Description copied from class: BufferWriter

Gets a short message (like type and length).

Specified by:

toString in class BufferWriter

See Also:

• To get access to the buffered content.

getResult

public BufferResult getResult()
                       throws IllegalStateException

Description copied from class: BufferWriter

Gets the result from this buffer. The buffer must be closed.

Note: Although the BufferWriter are generally not thread-safe, the BufferResult is thread-safe. It is expected to commonly create a buffer on one thread, but the be able to safely share the result among many threads.

Specified by:

getResult in class BufferWriter

Throws:

IllegalStateException - if not closed