org.apache.commons.lang.builder
Class ToStringStyle

java.lang.Object
  |
  +--org.apache.commons.lang.builder.ToStringStyle

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

StandardToStringStyle, ToStringStyle.DefaultToStringStyle, ToStringStyle.MultiLineToStringStyle, ToStringStyle.NoFieldNameToStringStyle, ToStringStyle.SimpleToStringStyle

public abstract class ToStringStyle

extends Object

implements Serializable

ToStringStyle works with ToStringBuilder to create a toString. The main public interface is always via ToStringBuilder.

These classes are intended to be used as singletons. There is no need to instantiate a new style each time. A program will generally use one of the predefined constants on this class. Alternatively, the StandardToStringStyle class can be used to set the individual settings. Thus most styles can be achieved without subclassing.

If required, a subclass can override as many or as few of the methods as it requires.Each object type (from boolean to long to Object to int[]) has its own methods to output it. Most have two versions, detail and summary. For example, the detail version of the array based methods will output the whole array, whereas the summary method will just output the array length.

Version:

$Id: ToStringStyle.java,v 1.4.2.1 2002/11/22 23:20:57 bayard Exp $

Author:

Stephen Colebourne

See Also:

Serialized Form

Nested Class Summary

private static class	ToStringStyle.DefaultToStringStyle Default ToStringStyle.
private static class	ToStringStyle.MultiLineToStringStyle ToStringStyle that outputs on multiple lines.
private static class	ToStringStyle.NoFieldNameToStringStyle ToStringStyle that does not print out the field names.
private static class	ToStringStyle.SimpleToStringStyle ToStringStyle that does not print out the classname, identity hashcode, content start or field name.

Field Summary

private boolean	arrayContentDetail The detail for array content
private String	arrayEnd The array end '}'
private String	arraySeparator The array separator ','
private String	arrayStart The array start '{'
private String	contentEnd The content end ']'
private String	contentStart The content start '['
static ToStringStyle	DEFAULT_STYLE The default toString style.
private boolean	defaultFullDetail The value to use when fullDetail is null 'true'
private String	fieldNameValueSeparator The field name value separator '='
private String	fieldSeparator The field separator ','
static ToStringStyle	MULTI_LINE_STYLE The multi line toString style.
static ToStringStyle	NO_FIELD_NAMES_STYLE The no field names toString style.
private String	nullText The null text ''
static ToStringStyle	SIMPLE_STYLE The simple toString style.
private String	sizeEndText The summary size text start '>'
private String	sizeStartText The summary size text start '
private String	summaryObjectEndText The summary object text start '>'
private String	summaryObjectStartText The summary object text start '<'
private boolean	useClassName Whether to use the class name 'true'
private boolean	useFieldNames Whether to use the field names 'true'
private boolean	useIdentityHashCode Whether to use the identity hash code 'true'
private boolean	useShortClassName Whether to use short class names 'false'

Constructor Summary

protected

ToStringStyle() Constructor.

Method Summary

void	append(StringBuffer buffer, String fieldName, boolean value) Append to the toString a boolean value.
void	append(StringBuffer buffer, String fieldName, boolean[] array, Boolean fullDetail) Append to the toString a boolean array.
void	append(StringBuffer buffer, String fieldName, byte value) Append to the toString a byte value.
void	append(StringBuffer buffer, String fieldName, byte[] array, Boolean fullDetail) Append to the toString a byte array.
void	append(StringBuffer buffer, String fieldName, char value) Append to the toString a char value.
void	append(StringBuffer buffer, String fieldName, char[] array, Boolean fullDetail) Append to the toString a char array.
void	append(StringBuffer buffer, String fieldName, double value) Append to the toString a double value.
void	append(StringBuffer buffer, String fieldName, double[] array, Boolean fullDetail) Append to the toString a double array.
void	append(StringBuffer buffer, String fieldName, float value) Append to the toString a float value.
void	append(StringBuffer buffer, String fieldName, float[] array, Boolean fullDetail) Append to the toString a float array.
void	append(StringBuffer buffer, String fieldName, int value) Append to the toString an int value.
void	append(StringBuffer buffer, String fieldName, int[] array, Boolean fullDetail) Append to the toString an int array.
void	append(StringBuffer buffer, String fieldName, long value) Append to the toString a long value.
void	append(StringBuffer buffer, String fieldName, long[] array, Boolean fullDetail) Append to the toString a long array.
void	append(StringBuffer buffer, String fieldName, Object[] array, Boolean fullDetail) Append to the toString an Object array.
void	append(StringBuffer buffer, String fieldName, Object value, Boolean fullDetail) Append to the toString an Object value, printing the full toString of the object passed in.
void	append(StringBuffer buffer, String fieldName, short value) Append to the toString a short value.
void	append(StringBuffer buffer, String fieldName, short[] array, Boolean fullDetail) Append to the toString a short array.
protected void	appendClassName(StringBuffer buffer, Object object) Append the class name.
protected void	appendContentEnd(StringBuffer buffer) Append the content end to the buffer.
protected void	appendContentStart(StringBuffer buffer) Append the content start to the buffer.
protected void	appendDetail(StringBuffer buffer, String fieldName, boolean value) Append to the toString a boolean value.
protected void	appendDetail(StringBuffer buffer, String fieldName, boolean[] array) Append to the toString the detail of a boolean array.
protected void	appendDetail(StringBuffer buffer, String fieldName, byte value) Append to the toString a byte value.
protected void	appendDetail(StringBuffer buffer, String fieldName, byte[] array) Append to the toString the detail of a byte array.
protected void	appendDetail(StringBuffer buffer, String fieldName, char value) Append to the toString a char value.
protected void	appendDetail(StringBuffer buffer, String fieldName, char[] array) Append to the toString the detail of a char array.
protected void	appendDetail(StringBuffer buffer, String fieldName, Collection coll) Append to the toString a Collection.
protected void	appendDetail(StringBuffer buffer, String fieldName, double value) Append to the toString a double value.
protected void	appendDetail(StringBuffer buffer, String fieldName, double[] array) Append to the toString the detail of a double array.
protected void	appendDetail(StringBuffer buffer, String fieldName, float value) Append to the toString a float value.
protected void	appendDetail(StringBuffer buffer, String fieldName, float[] array) Append to the toString the detail of a float array.
protected void	appendDetail(StringBuffer buffer, String fieldName, int value) Append to the toString an int value.
protected void	appendDetail(StringBuffer buffer, String fieldName, int[] array) Append to the toString the detail of an int array.
protected void	appendDetail(StringBuffer buffer, String fieldName, long value) Append to the toString a long value.
protected void	appendDetail(StringBuffer buffer, String fieldName, long[] array) Append to the toString the detail of a long array.
protected void	appendDetail(StringBuffer buffer, String fieldName, Map map) Append to the toString a Map.
protected void	appendDetail(StringBuffer buffer, String fieldName, Object value) Append to the toString an Object value, printing the full detail of the object.
protected void	appendDetail(StringBuffer buffer, String fieldName, Object[] array) Append to the toString the detail of an Object array.
protected void	appendDetail(StringBuffer buffer, String fieldName, short value) Append to the toString a short value.
protected void	appendDetail(StringBuffer buffer, String fieldName, short[] array) Append to the toString the detail of a short array.
void	appendEnd(StringBuffer buffer, Object object) Append the end of data indicator.
protected void	appendFieldEnd(StringBuffer buffer, String fieldName) Append the field end to the buffer.
protected void	appendFieldSeparator(StringBuffer buffer) Append the field separator to the buffer.
protected void	appendFieldStart(StringBuffer buffer, String fieldName) Append the field start to the buffer.
protected void	appendIdentityHashCode(StringBuffer buffer, Object object) Append the IdentityHashCode.
protected void	appendInternal(StringBuffer buffer, String fieldName, Object value, boolean detail) Append to the toString an Object, correctly interpretting its type.
protected void	appendNullText(StringBuffer buffer, String fieldName) Append an indicator for null to the buffer.
void	appendStart(StringBuffer buffer, Object object) Append the start of data indicator.
protected void	appendSummary(StringBuffer buffer, String fieldName, boolean[] array) Append to the toString a summary of a boolean array.
protected void	appendSummary(StringBuffer buffer, String fieldName, byte[] array) Append to the toString a summary of a byte array.
protected void	appendSummary(StringBuffer buffer, String fieldName, char[] array) Append to the toString a summary of a char array.
protected void	appendSummary(StringBuffer buffer, String fieldName, double[] array) Append to the toString a summary of a double array.
protected void	appendSummary(StringBuffer buffer, String fieldName, float[] array) Append to the toString a summary of a float array.
protected void	appendSummary(StringBuffer buffer, String fieldName, int[] array) Append to the toString a summary of an int array.
protected void	appendSummary(StringBuffer buffer, String fieldName, long[] array) Append to the toString a summary of a long array.
protected void	appendSummary(StringBuffer buffer, String fieldName, Object value) Append to the toString an Object value, printing a summary of the object.
protected void	appendSummary(StringBuffer buffer, String fieldName, Object[] array) Append to the toString a summary of an Object array.
protected void	appendSummary(StringBuffer buffer, String fieldName, short[] array) Append to the toString a summary of a short array.
protected void	appendSummarySize(StringBuffer buffer, String fieldName, int size) Append to the toString a size summary.
protected String	getArrayEnd() Gets the array end text.
protected String	getArraySeparator() Gets the array separator text.
protected String	getArrayStart() Gets the array start text.
protected String	getContentEnd() Gets the content end text.
protected String	getContentStart() Gets the content start text.
protected String	getFieldNameValueSeparator() Gets the field name value separator text.
protected String	getFieldSeparator() Gets the field separator text.
protected String	getNullText() Gets the text to output when null found.
protected String	getShortClassName(Class cls) Gets the short class name for a class.
protected String	getSizeEndText() Gets the text to output when a Collection, Map or Array size is output.
protected String	getSizeStartText() Gets the text to output when a Collection, Map or Array size is output.
protected String	getSummaryObjectEndText() Gets the text to output when an Object is output in summary mode.
protected String	getSummaryObjectStartText() Gets the text to output when an Object is output in summary mode.
protected boolean	isArrayContentDetail() Gets whether to output array content detail.
protected boolean	isDefaultFullDetail() Gets whether to use full detail when the caller doesn't specify.
protected boolean	isFullDetail(Boolean fullDetailRequest) Is this field to be output in full detail.
protected boolean	isShortClassName() Gets whether to output short or long class names.
protected boolean	isUseClassName() Gets whether to use the class name.
protected boolean	isUseFieldNames() Gets whether to use the field names passed in.
protected boolean	isUseIdentityHashCode() Gets whether to use the identity hash code.
protected void	setArrayContentDetail(boolean arrayContentDetail) Sets whether to output array content detail.
protected void	setArrayEnd(String arrayEnd) Sets the array end text.
protected void	setArraySeparator(String arraySeparator) Sets the array separator text.
protected void	setArrayStart(String arrayStart) Sets the array start text.
protected void	setContentEnd(String contentEnd) Sets the content end text.
protected void	setContentStart(String contentStart) Sets the content start text.
protected void	setDefaultFullDetail(boolean defaultFullDetail) Sets whether to use full detail when the caller doesn't specify.
protected void	setFieldNameValueSeparator(String fieldNameValueSeparator) Sets the field name value separator text.
protected void	setFieldSeparator(String fieldSeparator) Sets the field separator text.
protected void	setNullText(String nullText) Sets the text to output when null found.
protected void	setShortClassName(boolean shortClassName) Sets whether to output short or long class names.
protected void	setSizeEndText(String sizeEndText) Sets the text to output when a Collection, Map or Array size is output.
protected void	setSizeStartText(String sizeStartText) Sets the text to output when a Collection, Map or Array size is output.
protected void	setSummaryObjectEndText(String summaryObjectEndText) Sets the text to output when an Object is output in summary mode.
protected void	setSummaryObjectStartText(String summaryObjectStartText) Sets the text to output when an Object is output in summary mode.
protected void	setUseClassName(boolean useClassName) Sets whether to use the class name.
protected void	setUseFieldNames(boolean useFieldNames) Sets whether to use the field names passed in.
protected void	setUseIdentityHashCode(boolean useIdentityHashCode) Sets whether to use the identity hash code.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_STYLE

public static final ToStringStyle DEFAULT_STYLE

The default toString style.

MULTI_LINE_STYLE

public static final ToStringStyle MULTI_LINE_STYLE

The multi line toString style.

NO_FIELD_NAMES_STYLE

public static final ToStringStyle NO_FIELD_NAMES_STYLE

The no field names toString style.

SIMPLE_STYLE

public static final ToStringStyle SIMPLE_STYLE

The simple toString style.

useFieldNames

private boolean useFieldNames

Whether to use the field names 'true'

useClassName

private boolean useClassName

Whether to use the class name 'true'

useShortClassName

private boolean useShortClassName

Whether to use short class names 'false'

useIdentityHashCode

private boolean useIdentityHashCode

Whether to use the identity hash code 'true'

contentStart

private String contentStart

The content start '['

contentEnd

private String contentEnd

The content end ']'

fieldNameValueSeparator

private String fieldNameValueSeparator

The field name value separator '='

fieldSeparator

private String fieldSeparator

The field separator ','

arrayStart

private String arrayStart

The array start '{'

arraySeparator

private String arraySeparator

The array separator ','

arrayContentDetail

private boolean arrayContentDetail

The detail for array content

arrayEnd

private String arrayEnd

The array end '}'

defaultFullDetail

private boolean defaultFullDetail

The value to use when fullDetail is null 'true'

nullText

private String nullText

The null text ''

sizeStartText

private String sizeStartText

The summary size text start '

sizeEndText

private String sizeEndText

The summary size text start '>'

summaryObjectStartText

private String summaryObjectStartText

The summary object text start '<'

summaryObjectEndText

private String summaryObjectEndText

The summary object text start '>'

Constructor Detail

ToStringStyle

protected ToStringStyle()

Constructor.

Method Detail

appendStart

public void appendStart(StringBuffer buffer,
                        Object object)

Append the start of data indicator.

Parameters:

buffer - the StringBuffer to populate

object - the object to build a toString for, must not be null

appendEnd

public void appendEnd(StringBuffer buffer,
                      Object object)

Append the end of data indicator.

Parameters:

buffer - the StringBuffer to populate

object - the object to build a toString for, must not be null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   Object value,
                   Boolean fullDetail)

Append to the toString an Object value, printing the full toString of the object passed in.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendInternal

protected void appendInternal(StringBuffer buffer,
                              String fieldName,
                              Object value,
                              boolean detail)

Append to the toString an Object, correctly interpretting its type.

This method performs the main lookup by Class type to correctly route arrays, collections, maps and objects to the appropriate method. Either detail or summary views can be specified.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString, not null

detail - output detail or not

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            Object value)

Append to the toString an Object value, printing the full detail of the object.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString, not null

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            Collection coll)

Append to the toString a Collection.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

coll - the collection to add to the toString, not null

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            Map map)

Append to the toString a Map.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

map - the maps to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             Object value)

Append to the toString an Object value, printing a summary of the object.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   long value)

Append to the toString a long value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            long value)

Append to the toString a long value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   int value)

Append to the toString an int value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            int value)

Append to the toString an int value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   short value)

Append to the toString a short value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            short value)

Append to the toString a short value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   byte value)

Append to the toString a byte value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            byte value)

Append to the toString a byte value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   char value)

Append to the toString a char value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            char value)

Append to the toString a char value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   double value)

Append to the toString a double value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            double value)

Append to the toString a double value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   float value)

Append to the toString a float value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            float value)

Append to the toString a float value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   boolean value)

Append to the toString a boolean value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

value - the value to add to the toString

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            boolean value)

Append to the toString a boolean value.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

value - the value to add to the toString

append

public void append(StringBuffer buffer,
                   String fieldName,
                   Object[] array,
                   Boolean fullDetail)

Append to the toString an Object array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            Object[] array)

Append to the toString the detail of an Object array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             Object[] array)

Append to the toString a summary of an Object array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   long[] array,
                   Boolean fullDetail)

Append to the toString a long array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            long[] array)

Append to the toString the detail of a long array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             long[] array)

Append to the toString a summary of a long array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   int[] array,
                   Boolean fullDetail)

Append to the toString an int array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            int[] array)

Append to the toString the detail of an int array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             int[] array)

Append to the toString a summary of an int array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   short[] array,
                   Boolean fullDetail)

Append to the toString a short array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            short[] array)

Append to the toString the detail of a short array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             short[] array)

Append to the toString a summary of a short array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   byte[] array,
                   Boolean fullDetail)

Append to the toString a byte array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            byte[] array)

Append to the toString the detail of a byte array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             byte[] array)

Append to the toString a summary of a byte array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   char[] array,
                   Boolean fullDetail)

Append to the toString a char array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            char[] array)

Append to the toString the detail of a char array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             char[] array)

Append to the toString a summary of a char array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   double[] array,
                   Boolean fullDetail)

Append to the toString a double array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            double[] array)

Append to the toString the detail of a double array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             double[] array)

Append to the toString a summary of a double array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   float[] array,
                   Boolean fullDetail)

Append to the toString a float array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            float[] array)

Append to the toString the detail of a float array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             float[] array)

Append to the toString a summary of a float array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

append

public void append(StringBuffer buffer,
                   String fieldName,
                   boolean[] array,
                   Boolean fullDetail)

Append to the toString a boolean array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

array - the array to add to the toString

fullDetail - true for detail, false for summary info, null for style decides

appendDetail

protected void appendDetail(StringBuffer buffer,
                            String fieldName,
                            boolean[] array)

Append to the toString the detail of a boolean array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendSummary

protected void appendSummary(StringBuffer buffer,
                             String fieldName,
                             boolean[] array)

Append to the toString a summary of a boolean array.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

array - the array to add to the toString, not null

appendClassName

protected void appendClassName(StringBuffer buffer,
                               Object object)

Append the class name.

Parameters:

buffer - the StringBuffer to populate

object - the object whose name to output

appendIdentityHashCode

protected void appendIdentityHashCode(StringBuffer buffer,
                                      Object object)

Append the IdentityHashCode.

Parameters:

buffer - the StringBuffer to populate

object - the object whose id to output

appendContentStart

protected void appendContentStart(StringBuffer buffer)

Append the content start to the buffer.

Parameters:

buffer - the StringBuffer to populate

appendContentEnd

protected void appendContentEnd(StringBuffer buffer)

Append the content end to the buffer.

Parameters:

buffer - the StringBuffer to populate

appendNullText

protected void appendNullText(StringBuffer buffer,
                              String fieldName)

Append an indicator for null to the buffer. Default output is ''.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

appendFieldSeparator

protected void appendFieldSeparator(StringBuffer buffer)

Append the field separator to the buffer.

Parameters:

buffer - the StringBuffer to populate

appendFieldStart

protected void appendFieldStart(StringBuffer buffer,
                                String fieldName)

Append the field start to the buffer.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name

appendFieldEnd

protected void appendFieldEnd(StringBuffer buffer,
                              String fieldName)

Append the field end to the buffer.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

appendSummarySize

protected void appendSummarySize(StringBuffer buffer,
                                 String fieldName,
                                 int size)

Append to the toString a size summary.

The size summary is used to summarize the contents of collections, maps and arrays. The text output is a prefix, the size (passed in) and a suffix. The default format is '<size=n>'.

Parameters:

buffer - the StringBuffer to populate

fieldName - the field name, typically not used as already appended

size - the size to append

isFullDetail

protected boolean isFullDetail(Boolean fullDetailRequest)

Is this field to be output in full detail.

This method converts a detail request into a detail level. The calling code may request full detail (true), but a subclass might ignore that and always return false. The calling code may pass in null indicating that it doesn't care about the detail level. In this case the default detail level is used.

Parameters:

fullDetailRequest - the detail level requested

Returns:

whether full detail is to be shown

getShortClassName

protected String getShortClassName(Class cls)

Gets the short class name for a class.

The short class name is the name excluding the package name.

Parameters:

cls - the class to get the short name of

Returns:

the short name

isUseClassName

protected boolean isUseClassName()

Gets whether to use the class name.

Returns:

the current useClassName flag

setUseClassName

protected void setUseClassName(boolean useClassName)

Sets whether to use the class name.

Parameters:

useClassName - the new useClassName flag

isShortClassName

protected boolean isShortClassName()

Gets whether to output short or long class names.

Returns:

the current shortClassName flag

setShortClassName

protected void setShortClassName(boolean shortClassName)

Sets whether to output short or long class names.

Parameters:

shortClassName - the new shortClassName flag

isUseIdentityHashCode

protected boolean isUseIdentityHashCode()

Gets whether to use the identity hash code.

Returns:

the current useIdentityHashCode flag

setUseIdentityHashCode

protected void setUseIdentityHashCode(boolean useIdentityHashCode)

Sets whether to use the identity hash code.

Parameters:

useIdentityHashCode - the new useIdentityHashCode flag

isUseFieldNames

protected boolean isUseFieldNames()

Gets whether to use the field names passed in.

Returns:

the current useFieldNames flag

setUseFieldNames

protected void setUseFieldNames(boolean useFieldNames)

Sets whether to use the field names passed in.

Parameters:

useFieldNames - the new useFieldNames flag

isDefaultFullDetail

protected boolean isDefaultFullDetail()

Gets whether to use full detail when the caller doesn't specify.

Returns:

the current defaultFullDetail flag

setDefaultFullDetail

protected void setDefaultFullDetail(boolean defaultFullDetail)

Sets whether to use full detail when the caller doesn't specify.

Parameters:

defaultFullDetail - the new defaultFullDetail flag

isArrayContentDetail

protected boolean isArrayContentDetail()

Gets whether to output array content detail.

Returns:

the current array content detail setting

setArrayContentDetail

protected void setArrayContentDetail(boolean arrayContentDetail)

Sets whether to output array content detail.

Parameters:

arrayContentDetail - the new arrayContentDetail flag

getArrayStart

protected String getArrayStart()

Gets the array start text.

Returns:

the current array start text

setArrayStart

protected void setArrayStart(String arrayStart)

Sets the array start text. Null is accepted, but will be converted to a blank string.

Parameters:

arrayStart - the new array start text

getArrayEnd

protected String getArrayEnd()

Gets the array end text.

Returns:

the current array end text

setArrayEnd

protected void setArrayEnd(String arrayEnd)

Sets the array end text. Null is accepted, but will be converted to a blank string.

Parameters:

arrayEnd - the new array end text

getArraySeparator

protected String getArraySeparator()

Gets the array separator text.

Returns:

the current array separator text

setArraySeparator

protected void setArraySeparator(String arraySeparator)

Sets the array separator text. Null is accepted, but will be converted to a blank string.

Parameters:

arraySeparator - the new array separator text

getContentStart

protected String getContentStart()

Gets the content start text.

Returns:

the current content start text

setContentStart

protected void setContentStart(String contentStart)

Sets the content start text. Null is accepted, but will be converted to a blank string.

Parameters:

contentStart - the new content start text

getContentEnd

protected String getContentEnd()

Gets the content end text.

Returns:

the current content end text

setContentEnd

protected void setContentEnd(String contentEnd)

Sets the content end text. Null is accepted, but will be converted to a blank string.

Parameters:

contentEnd - the new content end text

getFieldNameValueSeparator

protected String getFieldNameValueSeparator()

Gets the field name value separator text.

Returns:

the current field name value separator text

setFieldNameValueSeparator

protected void setFieldNameValueSeparator(String fieldNameValueSeparator)

Sets the field name value separator text. Null is accepted, but will be converted to a blank string.

Parameters:

fieldNameValueSeparator - the new field name value separator text

getFieldSeparator

protected String getFieldSeparator()

Gets the field separator text.

Returns:

the current field separator text

setFieldSeparator

protected void setFieldSeparator(String fieldSeparator)

Sets the field separator text. Null is accepted, but will be converted to a blank string.

Parameters:

fieldSeparator - the new field separator text

getNullText

protected String getNullText()

Gets the text to output when null found.

Returns:

the current text to output when null found

setNullText

protected void setNullText(String nullText)

Sets the text to output when null found. Null is accepted, but will be converted to a blank string.

Parameters:

nullText - the new text to output when null found

getSizeStartText

protected String getSizeStartText()

Gets the text to output when a Collection, Map or Array size is output. This is output before the size value.

Returns:

the current start of size text

setSizeStartText

protected void setSizeStartText(String sizeStartText)

Sets the text to output when a Collection, Map or Array size is output. This is output before the size value. Null is accepted, but will be converted to a blank string.

Parameters:

sizeStartText - the new start of size text

getSizeEndText

protected String getSizeEndText()

Gets the text to output when a Collection, Map or Array size is output. This is output after the size value.

Returns:

the current end of size text

setSizeEndText

protected void setSizeEndText(String sizeEndText)

Sets the text to output when a Collection, Map or Array size is output. This is output after the size value. Null is accepted, but will be converted to a blank string.

Parameters:

sizeEndText - the new end of size text

getSummaryObjectStartText

protected String getSummaryObjectStartText()

Gets the text to output when an Object is output in summary mode. This is output before the size value.

Returns:

the current start of summary text

setSummaryObjectStartText

protected void setSummaryObjectStartText(String summaryObjectStartText)

Sets the text to output when an Object is output in summary mode. This is output before the size value. Null is accepted, but will be converted to a blank string.

Parameters:

summaryObjectStartText - the new start of summary text

getSummaryObjectEndText

protected String getSummaryObjectEndText()

Gets the text to output when an Object is output in summary mode. This is output after the size value.

Returns:

the current end of summary text

setSummaryObjectEndText

protected void setSummaryObjectEndText(String summaryObjectEndText)

Sets the text to output when an Object is output in summary mode. This is output after the size value. Null is accepted, but will be converted to a blank string.

Parameters:

summaryObjectEndText - the new end of summary text