com.force.db.i18n.util

Class DeferredStringBuilder

java.lang.Object

com.force.db.i18n.util.DeferredStringBuilder

All Implemented Interfaces:

Appendable, CharSequence

public final class DeferredStringBuilder
extends Object
implements Appendable, CharSequence

This class implements a StringBuilder that is incrementally copied from a source String. Actual creation the new buffer is deferred until a character differs from a character at the same position in the source String. This class is useful for reducing garbage creation when doing operations like escaping a String, when most Strings are not expected to contain any escapable characters. In that case, no additional memory is used (as the original String is not actually copied).

Author:

davem

Constructor Summary

Constructors

Constructor and Description
DeferredStringBuilder(CharSequence source)

Method Summary

Modifier and Type	Method and Description
DeferredStringBuilder	append(char c)
DeferredStringBuilder	append(CharSequence csq)
DeferredStringBuilder	append(CharSequence csq, int start, int end)
void	appendAsDifferent(char c)
void	appendAsDifferent(CharSequence csq) Call this if the first character of the sequence may be the same as the given sequence.
void	appendQuicklyForEscapingWithoutSkips(char c) Append the given char, under the condition that the character is directly copied from the parent.
void	appendQuicklyForEscapingWithoutSkips(int c) Version of appendQuicklyForEscapingWithoutSkips that avoids a downcast in most cases.
char	charAt(int index)
int	length()
CharSequence	subSequence(int start, int end)
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

DeferredStringBuilder

public DeferredStringBuilder(CharSequence source)

Method Detail

append

public DeferredStringBuilder append(char c)

Specified by:

append in interface Appendable

appendQuicklyForEscapingWithoutSkips

public void appendQuicklyForEscapingWithoutSkips(char c)

Append the given char, under the condition that the character is directly copied from the parent. This can only be done for performance reasons, - You must be in a charAt loop for the parent string - You *CAN NEVER SKIP A CHARACTER*. So you can't use it in StringTypedReader.

Parameters:

c - the character you're trying to add that came from the and your currently skipping

appendQuicklyForEscapingWithoutSkips

public void appendQuicklyForEscapingWithoutSkips(int c)

Version of appendQuicklyForEscapingWithoutSkips that avoids a downcast in most cases.

Parameters:

c -

append

public DeferredStringBuilder append(CharSequence csq)

Specified by:

append in interface Appendable

appendAsDifferent

public void appendAsDifferent(CharSequence csq)

Call this if the first character of the sequence may be the same as the given sequence. Mostly, this applies to & becoming &

appendAsDifferent

public void appendAsDifferent(char c)

append

public DeferredStringBuilder append(CharSequence csq,
                                    int start,
                                    int end)

Specified by:

append in interface Appendable

charAt

public char charAt(int index)

Specified by:

charAt in interface CharSequence

subSequence

public CharSequence subSequence(int start,
                                int end)

Specified by:

subSequence in interface CharSequence

toString

public String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class Object

length

public int length()

Specified by:

length in interface CharSequence