de.ipcon.tools

Class StringBuilderPool

java.lang.Object

de.ipcon.tools.StringBuilderPool

public final class StringBuilderPool
extends java.lang.Object

class that helps to optimize usage of StringBuilder objects, by either re-using or creating a new instance on getInstance(), and emptying and keeping a previously used instance on StringBuilderPool#finalToString(), assuming that the StringBuilderPool can fit more StringBuilder instances.

Constructor Summary

Constructors

Constructor and Description
StringBuilderPool()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	finalToString(java.lang.StringBuilder b) Builds a string, resets (empties) the StringBuilder used and returns it to the pool.
static java.lang.StringBuilder	getInstance() Call this method to create-or-reuse a string builder instance.
static java.lang.StringBuilder	getInstance(java.lang.String s) Call this method to create-or-reuse an empty string builder instance, and immediately append the given string for convenience.
static void	release(java.lang.StringBuilder b)

Methods inherited from class java.lang.Object

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

Constructor Detail

StringBuilderPool

public StringBuilderPool()

Method Detail

getInstance

public static final java.lang.StringBuilder getInstance()

Call this method to create-or-reuse a string builder instance. Remember to call finalToString(StringBuilder) to free the resource again after you are done using it.

Returns:

an empty string builder instance

See Also:

StringBuilderPool#getInstance(String)}

getInstance

public static final java.lang.StringBuilder getInstance(java.lang.String s)

Call this method to create-or-reuse an empty string builder instance, and immediately append the given string for convenience. Remember to call finalToString(StringBuilder) to free the resource again after you are done using it.

Returns:

a string builder instance with the given string set.

See Also:

StringBuilderPool#getInstance()}

release

public static final void release(java.lang.StringBuilder b)

finalToString

public static final java.lang.String finalToString(java.lang.StringBuilder b)

Builds a string, resets (empties) the StringBuilder used and returns it to the pool.

Parameters:

b - the StringBuilder to finalize.

Returns:

the finalized string from the StringBuilder, or, if null was passed, a string saying "null".