org.eclipse.xtext.xbase.lib.util

Class ToStringBuilder

java.lang.Object

org.eclipse.xtext.xbase.lib.util.ToStringBuilder

@Beta
@GwtCompatible
public final class ToStringBuilder
extends Object

Helps with the construction of good Object.toString() representations.

You can customize the output using the builder-style methods singleLine() skipNulls() and hideFieldNames().

You can either directly list fields to include via add(String, Object) and add(Object) or you can let the builder do it automatically using reflection, either including the fields declared in this class or including all superclasses.

The builder will automatically handle cycles in the object tree. It also pretty prints arrays and Iterables.

This class is not thread safe.

Since:

2.7

Constructor Summary

Constructors

Constructor and Description
ToStringBuilder(Object instance) Creates a new ToStringBuilder for the given object.

Method Summary

Methods

Modifier and Type	Method and Description
ToStringBuilder	add(Object value)
ToStringBuilder	add(String fieldName, Object value)
ToStringBuilder	addAllFields() Adds all fields declared in the object's class and its superclasses to the output.
ToStringBuilder	addDeclaredFields() Adds all fields declared directly in the object's class to the output
ToStringBuilder	addField(String fieldName)
ToStringBuilder	hideFieldNames() Field names will not be included in the output.
ToStringBuilder	singleLine() Fields are printed on a single line, separated by commas instead of newlines
ToStringBuilder	skipNulls() Fields with null values will be excluded from the output
String	toString()
ToStringBuilder	verbatimValues() By default, Iterables, Arrays and multiline Strings are pretty-printed.

Methods inherited from class java.lang.Object

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

Constructor Detail

ToStringBuilder

public ToStringBuilder(Object instance)

Creates a new ToStringBuilder for the given object. If you don't use reflection, then this instance is only used for obtaining its classes' simplename.

Parameters:

instance - the object to convert to a String

Method Detail

singleLine

public ToStringBuilder singleLine()

Fields are printed on a single line, separated by commas instead of newlines

Returns:

this

skipNulls

public ToStringBuilder skipNulls()

Fields with null values will be excluded from the output

Returns:

this

hideFieldNames

public ToStringBuilder hideFieldNames()

Field names will not be included in the output. Useful for small classes.

Returns:

this

verbatimValues

public ToStringBuilder verbatimValues()

By default, Iterables, Arrays and multiline Strings are pretty-printed. Switching to their normal representation makes the toString method significantly faster.

Returns:

this

Since:

2.9

addDeclaredFields

@GwtIncompatible(value="Class.getDeclaredFields")
public ToStringBuilder addDeclaredFields()

Adds all fields declared directly in the object's class to the output

Returns:

this

addAllFields

@GwtIncompatible(value="Class.getDeclaredFields")
public ToStringBuilder addAllFields()

Adds all fields declared in the object's class and its superclasses to the output.

Returns:

this

addField

@GwtIncompatible(value="Class.getDeclaredField(String)")
public ToStringBuilder addField(String fieldName)

Parameters:

fieldName - the name of the field to add to the output using reflection

Returns:

this

add

public ToStringBuilder add(String fieldName,
                  Object value)

Parameters:

value - the value to add to the output

fieldName - the fiel name to list the value under

Returns:

this

add

public ToStringBuilder add(Object value)

Parameters:

value - the value to add to the output without a field name

Returns:

this

toString

public String toString()

Overrides:

toString in class Object

Returns:

the String representation of the processed object