com.aoindustries.io

Interface Writable

All Known Implementing Classes:

AoCharArrayWriter

public interface Writable

Something that may be written to a Writer output instead of being converted toString and then having the String written.

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method and Description
long	getLength() Gets the number of characters represented by this Writable.
boolean	isFastToString() Checks if the writable will be able to be converted toString in an extremely efficient manner.
String	toString() Anything writable must have a toString consistent with what would be written by the writeTo methods.
void	writeTo(Encoder encoder, Writer out) Writes a streamed version of the object's String representation using the given encoder.
void	writeTo(Encoder encoder, Writer out, long off, long len) Writes a streamed version of the object's String representation using the given encoder.
void	writeTo(Writer out) Writes a streamed version of the object's String representation.
void	writeTo(Writer out, long off, long len) Writes a streamed version of the object's String representation.

Method Detail

getLength

long getLength()
        throws IOException

Gets the number of characters represented by this Writable.

Throws:

IOException

isFastToString

boolean isFastToString()

Checks if the writable will be able to be converted toString in an extremely efficient manner. This means without allocating any new buffer space or string copies. Callers should prefer toString over writeTo when isFastToString returns true.

Note: As of Java 1.7.0_06, String.substring(int, int) and related operations now copy underlying buffers.

toString

String toString()

Anything writable must have a toString consistent with what would be written by the writeTo methods. For larger amounts of data, it is likely much more efficient to call the most appropriate writeTo method.

Overrides:

toString in class Object

writeTo

void writeTo(Writer out)
      throws IOException

Writes a streamed version of the object's String representation. What is written must be the same as if out.write(this.toString()) were called, but may be a much more efficient implementation.

Throws:

IOException

writeTo

void writeTo(Writer out,
             long off,
             long len)
      throws IOException

Writes a streamed version of the object's String representation. What is written must be the same as if out.write(this.toString(), off, len) were called, but may be a much more efficient implementation.

Throws:

IOException

writeTo

void writeTo(Encoder encoder,
             Writer out)
      throws IOException

Writes a streamed version of the object's String representation using the given encoder. What is written must be the same as if encoder.write(this.toString(), out) were called, but may be a much more efficient implementation.

Parameters:

encoder - if null, no encoding is performed and will be the same as a call to writeTo(java.io.Writer)

Throws:

IOException

writeTo

void writeTo(Encoder encoder,
             Writer out,
             long off,
             long len)
      throws IOException

Writes a streamed version of the object's String representation using the given encoder. What is written must be the same as if encoder.write(this.toString(), off, len, out) were called, but may be a much more efficient implementation.

Parameters:

encoder - if null, no encoding is performed and will be the same as a call to writeTo(java.io.Writer, long, long)

Throws:

IOException