org.xins.common.io

Class FastStringWriter

java.lang.Object

java.io.Writer

org.xins.common.io.FastStringWriter

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

Deprecated.

since XINS 2.0, use java.io.StringWriter

public class FastStringWriter
extends Writer

A non-synchronized equivalent of StringWriter. This class implements a character stream that collects its output in a fast, unsynchronized string buffer, which can then be used to construct a string.

Instances of this class are not thread-safe.

Since:

XINS 1.0.0

Version:

$Revision: 1.26 $ $Date: 2010/09/29 17:21:48 $

Author:

Ernst de Haan

Field Summary

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor and Description
FastStringWriter() Deprecated. Creates a new FastStringWriter using a default initial internal buffer size.
FastStringWriter(int initialSize) Deprecated. Creates a new FastStringWriter using a specified initial string buffer size.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Deprecated. Closes this writer.
void	flush() Deprecated. Flushes this writer.
FastStringBuffer	getBuffer() Deprecated. Returns the underlying string buffer itself.
String	toString() Deprecated. Returns the current value of the underlying buffer as a string.
void	write(char[] cbuf) Deprecated. Writes an array of characters.
void	write(char[] cbuf, int off, int len) Deprecated. Writes a portion of an array of characters.
void	write(int c) Deprecated. Writes a single character.
void	write(String str) Deprecated. Writes a character string.
void	write(String str, int off, int len) Deprecated. Writes a portion of a character string.

Methods inherited from class java.io.Writer

append, append, append

Methods inherited from class java.lang.Object

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

Constructor Detail

FastStringWriter

public FastStringWriter()

Deprecated.

Creates a new FastStringWriter using a default initial internal buffer size.

FastStringWriter

public FastStringWriter(int initialSize)
                 throws IllegalArgumentException

Deprecated.

Creates a new FastStringWriter using a specified initial string buffer size.

Parameters:

initialSize - the initial size of the buffer, must be >= 0.

Throws:

IllegalArgumentException - if initialSize < 0.

Method Detail

write

public void write(int c)
           throws IOException

Deprecated.

Writes a single character.

Overrides:

write in class Writer

Parameters:

c - the character to write.

Throws:

IOException - if this writer has been closed (see close()).

write

public void write(char[] cbuf)
           throws IOException,
                  IllegalArgumentException

Deprecated.

Writes an array of characters.

Overrides:

write in class Writer

Parameters:

cbuf - the array of characters to write, cannot be null.

Throws:

IOException - if this writer has been closed (see close()).

IllegalArgumentException - if cbuf == null.

write

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

Deprecated.

Writes a portion of an array of characters.

Specified by:

write in class Writer

Parameters:

cbuf - the array of characters to write a portion of, cannot be null.

off - offset from which to start writing characters, must be >= 0 and < sbuf.length.

len - the number of characters to write.

Throws:

IOException - if this writer has been closed (see close()).

IllegalArgumentException - if cbuf == null.

IndexOutOfBoundsException - if the offset and/or the length is invalid.

write

public void write(String str)
           throws IOException,
                  IllegalArgumentException

Deprecated.

Writes a character string.

Overrides:

write in class Writer

Parameters:

str - the character string to write, cannot be null.

Throws:

IOException - if this writer has been closed (see close()).

IllegalArgumentException - if str == null.

write

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

Deprecated.

Writes a portion of a character string.

Overrides:

write in class Writer

Parameters:

str - the character string to write a portion of, cannot be null.

off - offset from which to start writing characters, must be >= 0 and < str.length().

len - the number of characters to write.

Throws:

IOException - if this writer has been closed (see close()).

IllegalArgumentException - if str == null.

IndexOutOfBoundsException - if the offset and/or the length is invalid.

flush

public void flush()
           throws IOException

Deprecated.

Flushes this writer.

The implementation of this method does not nothing except checking that this writer is not yet closed.

Specified by:

flush in interface Flushable

Specified by:

flush in class Writer

Throws:

IOException - if this writer has been closed (see close()).

close

public void close()

Deprecated.

Closes this writer. If this writer was already closed, then nothing happens. After calling this method, the write and flush methods will throw an IOException if called.

Calling this method on a FastStringWriter after use is really optional.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in class Writer

toString

public String toString()

Deprecated.

Returns the current value of the underlying buffer as a string.

Overrides:

toString in class Object

Returns:

the current string, not null.

getBuffer

public FastStringBuffer getBuffer()

Deprecated.

Returns the underlying string buffer itself.

Returns:

the underlying string buffer, not null.