public class ToStringBuilder extends Object implements Builder<String>
Object.toString()方法
这个类支持为任何类或对象构建良好且一致的toString()这个类的目的是通过
To use this class write code as follows:
public class Person {
String name;
int age;
boolean smoker;
...
public String toString() {
return new ToStringBuilder(this).
append("name", name).
append("age", age).
append("smoker", smoker).
toString();
}
}
| Constructor and Description |
|---|
ToStringBuilder(Object object) |
ToStringBuilder(Object object,
ToStringStyle style) |
ToStringBuilder(Object object,
ToStringStyle style,
StringBuffer buffer) |
| Modifier and Type | Method and Description |
|---|---|
ToStringBuilder |
append(boolean value)
Append to the
toString a boolean
value. |
ToStringBuilder |
append(boolean[] array)
Append to the
toString a boolean
array. |
ToStringBuilder |
append(byte value)
Append to the
toString a byte
value. |
ToStringBuilder |
append(byte[] array)
Append to the
toString a byte
array. |
ToStringBuilder |
append(char value)
Append to the
toString a char
value. |
ToStringBuilder |
append(char[] array)
Append to the
toString a char
array. |
ToStringBuilder |
append(double value)
Append to the
toString a double
value. |
ToStringBuilder |
append(double[] array)
Append to the
toString a double
array. |
ToStringBuilder |
append(float value)
Append to the
toString a float
value. |
ToStringBuilder |
append(float[] array)
Append to the
toString a float
array. |
ToStringBuilder |
append(int value)
Append to the
toString an int
value. |
ToStringBuilder |
append(int[] array)
Append to the
toString an int
array. |
ToStringBuilder |
append(long value)
Append to the
toString a long
value. |
ToStringBuilder |
append(long[] array)
Append to the
toString a long
array. |
ToStringBuilder |
append(Object obj)
Append to the
toString an Object
value. |
ToStringBuilder |
append(Object[] array)
Append to the
toString an Object
array. |
ToStringBuilder |
append(short value)
Append to the
toString a short
value. |
ToStringBuilder |
append(short[] array)
Append to the
toString a short
array. |
ToStringBuilder |
append(String fieldName,
boolean value)
Append to the
toString a boolean
value. |
ToStringBuilder |
append(String fieldName,
boolean[] array)
Append to the
toString a boolean
array. |
ToStringBuilder |
append(String fieldName,
boolean[] array,
boolean fullDetail)
Append to the
toString a boolean
array. |
ToStringBuilder |
append(String fieldName,
byte value)
Append to the
toString an byte
value. |
ToStringBuilder |
append(String fieldName,
byte[] array)
Append to the
toString a byte array. |
ToStringBuilder |
append(String fieldName,
byte[] array,
boolean fullDetail)
Append to the
toString a byte
array. |
ToStringBuilder |
append(String fieldName,
char value)
Append to the
toString a char
value. |
ToStringBuilder |
append(String fieldName,
char[] array)
Append to the
toString a char
array. |
ToStringBuilder |
append(String fieldName,
char[] array,
boolean fullDetail)
Append to the
toString a char
array. |
ToStringBuilder |
append(String fieldName,
double value)
Append to the
toString a double
value. |
ToStringBuilder |
append(String fieldName,
double[] array)
Append to the
toString a double
array. |
ToStringBuilder |
append(String fieldName,
double[] array,
boolean fullDetail)
Append to the
toString a double
array. |
ToStringBuilder |
append(String fieldName,
float value)
Append to the
toString an float
value. |
ToStringBuilder |
append(String fieldName,
float[] array)
Append to the
toString a float
array. |
ToStringBuilder |
append(String fieldName,
float[] array,
boolean fullDetail)
Append to the
toString a float
array. |
ToStringBuilder |
append(String fieldName,
int value)
Append to the
toString an int
value. |
ToStringBuilder |
append(String fieldName,
int[] array)
Append to the
toString an int
array. |
ToStringBuilder |
append(String fieldName,
int[] array,
boolean fullDetail)
Append to the
toString an int
array. |
ToStringBuilder |
append(String fieldName,
long value)
Append to the
toString a long
value. |
ToStringBuilder |
append(String fieldName,
long[] array)
Append to the
toString a long
array. |
ToStringBuilder |
append(String fieldName,
long[] array,
boolean fullDetail)
Append to the
toString a long
array. |
ToStringBuilder |
append(String fieldName,
Object obj)
Append to the
toString an Object
value. |
ToStringBuilder |
append(String fieldName,
Object[] array)
Append to the
toString an Object
array. |
ToStringBuilder |
append(String fieldName,
Object[] array,
boolean fullDetail)
Append to the
toString an Object
array. |
ToStringBuilder |
append(String fieldName,
Object obj,
boolean fullDetail)
Append to the
toString an Object
value. |
ToStringBuilder |
append(String fieldName,
short value)
Append to the
toString an short
value. |
ToStringBuilder |
append(String fieldName,
short[] array)
Append to the
toString a short
array. |
ToStringBuilder |
append(String fieldName,
short[] array,
boolean fullDetail)
Append to the
toString a short
array. |
ToStringBuilder |
appendAsObjectToString(Object srcObject)
Appends with the same format as the default
Object toString()
method. |
ToStringBuilder |
appendSuper(String superToString)
Append the
toString from the superclass. |
ToStringBuilder |
appendToString(String toString)
Append the
toString from another object. |
String |
build()
Returns the String that was build as an object representation.
|
static ToStringStyle |
getDefaultStyle()
Gets the default
ToStringStyle to use. |
Object |
getObject()
Returns the
Object being output. |
StringBuffer |
getStringBuffer()
Gets the
StringBuffer being populated. |
ToStringStyle |
getStyle()
Gets the
ToStringStyle being used. |
static String |
reflectionToString(Object object)
Uses
ReflectionToStringBuilder to generate a
toString for the specified object. |
static String |
reflectionToString(Object object,
ToStringStyle style)
Uses
ReflectionToStringBuilder to generate a
toString for the specified object. |
static String |
reflectionToString(Object object,
ToStringStyle style,
boolean outputTransients)
Uses
ReflectionToStringBuilder to generate a
toString for the specified object. |
static <T> String |
reflectionToString(T object,
ToStringStyle style,
boolean outputTransients,
Class<? super T> reflectUpToClass)
Uses
ReflectionToStringBuilder to generate a
toString for the specified object. |
static void |
setDefaultStyle(ToStringStyle style)
Sets the default
ToStringStyle to use. |
String |
toString()
Returns the built
toString. |
public ToStringBuilder(Object object)
public ToStringBuilder(Object object, ToStringStyle style)
public ToStringBuilder(Object object, ToStringStyle style, StringBuffer buffer)
public static ToStringStyle getDefaultStyle()
Gets the default ToStringStyle to use.
This method gets a singleton default value, typically for the whole JVM.
Changing this default should generally only be done during application startup.
It is recommended to pass a ToStringStyle to the constructor instead
of using this global default.
This method can be used from multiple threads.
Internally, a volatile variable is used to provide the guarantee
that the latest value set using setDefaultStyle(org.aoju.bus.core.builder.ToStringStyle) is the value returned.
It is strongly recommended that the default style is only changed during application startup.
One reason for changing the default could be to have a verbose style during development and a compact style in production.
ToStringStyle, never nullpublic static void setDefaultStyle(ToStringStyle style)
Sets the default ToStringStyle to use.
This method sets a singleton default value, typically for the whole JVM.
Changing this default should generally only be done during application startup.
It is recommended to pass a ToStringStyle to the constructor instead
of changing this global default.
This method is not intended for use from multiple threads.
Internally, a volatile variable is used to provide the guarantee
that the latest value set is the value returned from getDefaultStyle().
style - the default ToStringStyleIllegalArgumentException - if the style is nullpublic static String reflectionToString(Object object)
Uses ReflectionToStringBuilder to generate a
toString for the specified object.
object - the Object to be outputReflectionToStringBuilder.toString(Object)public static String reflectionToString(Object object, ToStringStyle style)
Uses ReflectionToStringBuilder to generate a
toString for the specified object.
object - the Object to be outputstyle - the style of the toString to create, may be nullReflectionToStringBuilder.toString(Object, ToStringStyle)public static String reflectionToString(Object object, ToStringStyle style, boolean outputTransients)
Uses ReflectionToStringBuilder to generate a
toString for the specified object.
object - the Object to be outputstyle - the style of the toString to create, may be nulloutputTransients - whether to include transient fieldsReflectionToStringBuilder.toString(Object, ToStringStyle, boolean)public static <T> String reflectionToString(T object, ToStringStyle style, boolean outputTransients, Class<? super T> reflectUpToClass)
Uses ReflectionToStringBuilder to generate a
toString for the specified object.
T - the type of the objectobject - the Object to be outputstyle - the style of the toString to create, may be nulloutputTransients - whether to include transient fieldsreflectUpToClass - the superclass to reflect up to (inclusive), may be nullReflectionToStringBuilder.toString(Object, ToStringStyle, boolean, boolean, Class)public ToStringBuilder append(boolean value)
Append to the toString a boolean
value.
value - the value to add to the toStringpublic ToStringBuilder append(boolean[] array)
Append to the toString a boolean
array.
array - the array to add to the toStringpublic ToStringBuilder append(byte value)
Append to the toString a byte
value.
value - the value to add to the toStringpublic ToStringBuilder append(byte[] array)
Append to the toString a byte
array.
array - the array to add to the toStringpublic ToStringBuilder append(char value)
Append to the toString a char
value.
value - the value to add to the toStringpublic ToStringBuilder append(char[] array)
Append to the toString a char
array.
array - the array to add to the toStringpublic ToStringBuilder append(double value)
Append to the toString a double
value.
value - the value to add to the toStringpublic ToStringBuilder append(double[] array)
Append to the toString a double
array.
array - the array to add to the toStringpublic ToStringBuilder append(float value)
Append to the toString a float
value.
value - the value to add to the toStringpublic ToStringBuilder append(float[] array)
Append to the toString a float
array.
array - the array to add to the toStringpublic ToStringBuilder append(int value)
Append to the toString an int
value.
value - the value to add to the toStringpublic ToStringBuilder append(int[] array)
Append to the toString an int
array.
array - the array to add to the toStringpublic ToStringBuilder append(long value)
Append to the toString a long
value.
value - the value to add to the toStringpublic ToStringBuilder append(long[] array)
Append to the toString a long
array.
array - the array to add to the toStringpublic ToStringBuilder append(Object obj)
Append to the toString an Object
value.
obj - the value to add to the toStringpublic ToStringBuilder append(Object[] array)
Append to the toString an Object
array.
array - the array to add to the toStringpublic ToStringBuilder append(short value)
Append to the toString a short
value.
value - the value to add to the toStringpublic ToStringBuilder append(short[] array)
Append to the toString a short
array.
array - the array to add to the toStringpublic ToStringBuilder append(String fieldName, boolean value)
Append to the toString a boolean
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, boolean[] array)
Append to the toString a boolean
array.
fieldName - the field namearray - the array to add to the hashCodepublic ToStringBuilder append(String fieldName, boolean[] array, boolean fullDetail)
Append to the toString a boolean
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, byte value)
Append to the toString an byte
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, byte[] array)
Append to the toString a byte array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, byte[] array, boolean fullDetail)
Append to the toString a byte
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, char value)
Append to the toString a char
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, char[] array)
Append to the toString a char
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, char[] array, boolean fullDetail)
Append to the toString a char
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, double value)
Append to the toString a double
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, double[] array)
Append to the toString a double
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, double[] array, boolean fullDetail)
Append to the toString a double
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, float value)
Append to the toString an float
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, float[] array)
Append to the toString a float
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, float[] array, boolean fullDetail)
Append to the toString a float
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, int value)
Append to the toString an int
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, int[] array)
Append to the toString an int
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, int[] array, boolean fullDetail)
Append to the toString an int
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, long value)
Append to the toString a long
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, long[] array)
Append to the toString a long
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, long[] array, boolean fullDetail)
Append to the toString a long
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, Object obj)
Append to the toString an Object
value.
fieldName - the field nameobj - the value to add to the toStringpublic ToStringBuilder append(String fieldName, Object obj, boolean fullDetail)
Append to the toString an Object
value.
fieldName - the field nameobj - the value to add to the toStringfullDetail - true for detail,
false for summary infopublic ToStringBuilder append(String fieldName, Object[] array)
Append to the toString an Object
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, Object[] array, boolean fullDetail)
Append to the toString an Object
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder append(String fieldName, short value)
Append to the toString an short
value.
fieldName - the field namevalue - the value to add to the toStringpublic ToStringBuilder append(String fieldName, short[] array)
Append to the toString a short
array.
fieldName - the field namearray - the array to add to the toStringpublic ToStringBuilder append(String fieldName, short[] array, boolean fullDetail)
Append to the toString a short
array.
A boolean parameter controls the level of detail to show.
Setting true will output the array in full. Setting
false will output a summary, typically the size of
the array.
fieldName - the field namearray - the array to add to the toStringfullDetail - true for detail, false
for summary infopublic ToStringBuilder appendAsObjectToString(Object srcObject)
Appends with the same format as the default Object toString()
method. Appends the class name followed by
System.identityHashCode(Object).
srcObject - the Object whose class name and id to outputpublic ToStringBuilder appendSuper(String superToString)
Append the toString from the superclass.
This method assumes that the superclass uses the same ToStringStyle
as this one.
If superToString is null, no change is made.
superToString - the result of super.toString()public ToStringBuilder appendToString(String toString)
Append the toString from another object.
This method is useful where a class delegates most of the implementation of
its properties to another class. You can then call toString() on
the other class and pass the result into this method.
private AnotherObject delegate;
private String fieldInThisClass;
public String toString() {
return new ToStringBuilder(this).
appendToString(delegate.toString()).
append(fieldInThisClass).
toString();
}
This method assumes that the other object uses the same ToStringStyle
as this one.
If the toString is null, no change is made.
toString - the result of toString() on another objectpublic Object getObject()
Returns the Object being output.
public StringBuffer getStringBuffer()
Gets the StringBuffer being populated.
StringBuffer being populatedpublic ToStringStyle getStyle()
Gets the ToStringStyle being used.
ToStringStyle being usedpublic String toString()
Returns the built toString.
This method appends the end of data indicator, and can only be called once.
Use getStringBuffer() to get the current string state.
If the object is null, return the style's nullText
public String build()
toString() implementation.build in interface Builder<String>toStringtoString()Copyright © 2019. All rights reserved.