/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.commons.lang3.builder;

Works with ToStringBuilder to create a toString.

This class is intended to be used as a singleton. There is no need to instantiate a new style each time. Simply instantiate the class once, customize the values as required, and store the result in a public static final variable for the rest of the program to access.

Since:1.0
/** * <p>Works with {@link ToStringBuilder} to create a <code>toString</code>.</p> * * <p>This class is intended to be used as a singleton. * There is no need to instantiate a new style each time. * Simply instantiate the class once, customize the values as required, and * store the result in a public static final variable for the rest of the * program to access.</p> * * @since 1.0 */
public class StandardToStringStyle extends ToStringStyle {
Required for serialization support.
See Also:
  • Serializable
/** * Required for serialization support. * * @see java.io.Serializable */
private static final long serialVersionUID = 1L;

Constructor.

/** * <p>Constructor.</p> */
public StandardToStringStyle() { super(); } //---------------------------------------------------------------------

Gets whether to use the class name.

Returns:the current useClassName flag
/** * <p>Gets whether to use the class name.</p> * * @return the current useClassName flag */
@Override public boolean isUseClassName() { // NOPMD as this is implementing the abstract class return super.isUseClassName(); }

Sets whether to use the class name.

Params:
  • useClassName – the new useClassName flag
/** * <p>Sets whether to use the class name.</p> * * @param useClassName the new useClassName flag */
@Override public void setUseClassName(final boolean useClassName) { // NOPMD as this is implementing the abstract class super.setUseClassName(useClassName); } //---------------------------------------------------------------------

Gets whether to output short or long class names.

Returns:the current useShortClassName flag
Since:2.0
/** * <p>Gets whether to output short or long class names.</p> * * @return the current useShortClassName flag * @since 2.0 */
@Override public boolean isUseShortClassName() { // NOPMD as this is implementing the abstract class return super.isUseShortClassName(); }

Sets whether to output short or long class names.

Params:
  • useShortClassName – the new useShortClassName flag
Since:2.0
/** * <p>Sets whether to output short or long class names.</p> * * @param useShortClassName the new useShortClassName flag * @since 2.0 */
@Override public void setUseShortClassName(final boolean useShortClassName) { // NOPMD as this is implementing the abstract class super.setUseShortClassName(useShortClassName); } //---------------------------------------------------------------------

Gets whether to use the identity hash code.

Returns:the current useIdentityHashCode flag
/** * <p>Gets whether to use the identity hash code.</p> * @return the current useIdentityHashCode flag */
@Override public boolean isUseIdentityHashCode() { // NOPMD as this is implementing the abstract class return super.isUseIdentityHashCode(); }

Sets whether to use the identity hash code.

Params:
  • useIdentityHashCode – the new useIdentityHashCode flag
/** * <p>Sets whether to use the identity hash code.</p> * * @param useIdentityHashCode the new useIdentityHashCode flag */
@Override public void setUseIdentityHashCode(final boolean useIdentityHashCode) { // NOPMD as this is implementing the abstract class super.setUseIdentityHashCode(useIdentityHashCode); } //---------------------------------------------------------------------

Gets whether to use the field names passed in.

Returns:the current useFieldNames flag
/** * <p>Gets whether to use the field names passed in.</p> * * @return the current useFieldNames flag */
@Override public boolean isUseFieldNames() { // NOPMD as this is implementing the abstract class return super.isUseFieldNames(); }

Sets whether to use the field names passed in.

Params:
  • useFieldNames – the new useFieldNames flag
/** * <p>Sets whether to use the field names passed in.</p> * * @param useFieldNames the new useFieldNames flag */
@Override public void setUseFieldNames(final boolean useFieldNames) { // NOPMD as this is implementing the abstract class super.setUseFieldNames(useFieldNames); } //---------------------------------------------------------------------

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

Returns:the current defaultFullDetail flag
/** * <p>Gets whether to use full detail when the caller doesn't * specify.</p> * * @return the current defaultFullDetail flag */
@Override public boolean isDefaultFullDetail() { // NOPMD as this is implementing the abstract class return super.isDefaultFullDetail(); }

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

Params:
  • defaultFullDetail – the new defaultFullDetail flag
/** * <p>Sets whether to use full detail when the caller doesn't * specify.</p> * * @param defaultFullDetail the new defaultFullDetail flag */
@Override public void setDefaultFullDetail(final boolean defaultFullDetail) { // NOPMD as this is implementing the abstract class super.setDefaultFullDetail(defaultFullDetail); } //---------------------------------------------------------------------

Gets whether to output array content detail.

Returns:the current array content detail setting
/** * <p>Gets whether to output array content detail.</p> * * @return the current array content detail setting */
@Override public boolean isArrayContentDetail() { // NOPMD as this is implementing the abstract class return super.isArrayContentDetail(); }

Sets whether to output array content detail.

Params:
  • arrayContentDetail – the new arrayContentDetail flag
/** * <p>Sets whether to output array content detail.</p> * * @param arrayContentDetail the new arrayContentDetail flag */
@Override public void setArrayContentDetail(final boolean arrayContentDetail) { // NOPMD as this is implementing the abstract class super.setArrayContentDetail(arrayContentDetail); } //---------------------------------------------------------------------

Gets the array start text.

Returns:the current array start text
/** * <p>Gets the array start text.</p> * * @return the current array start text */
@Override public String getArrayStart() { // NOPMD as this is implementing the abstract class return super.getArrayStart(); }

Sets the array start text.

null is accepted, but will be converted to an empty String.

Params:
  • arrayStart – the new array start text
/** * <p>Sets the array start text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param arrayStart the new array start text */
@Override public void setArrayStart(final String arrayStart) { // NOPMD as this is implementing the abstract class super.setArrayStart(arrayStart); } //---------------------------------------------------------------------

Gets the array end text.

Returns:the current array end text
/** * <p>Gets the array end text.</p> * * @return the current array end text */
@Override public String getArrayEnd() { // NOPMD as this is implementing the abstract class return super.getArrayEnd(); }

Sets the array end text.

null is accepted, but will be converted to an empty String.

Params:
  • arrayEnd – the new array end text
/** * <p>Sets the array end text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param arrayEnd the new array end text */
@Override public void setArrayEnd(final String arrayEnd) { // NOPMD as this is implementing the abstract class super.setArrayEnd(arrayEnd); } //---------------------------------------------------------------------

Gets the array separator text.

Returns:the current array separator text
/** * <p>Gets the array separator text.</p> * * @return the current array separator text */
@Override public String getArraySeparator() { // NOPMD as this is implementing the abstract class return super.getArraySeparator(); }

Sets the array separator text.

null is accepted, but will be converted to an empty String.

Params:
  • arraySeparator – the new array separator text
/** * <p>Sets the array separator text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param arraySeparator the new array separator text */
@Override public void setArraySeparator(final String arraySeparator) { // NOPMD as this is implementing the abstract class super.setArraySeparator(arraySeparator); } //---------------------------------------------------------------------

Gets the content start text.

Returns:the current content start text
/** * <p>Gets the content start text.</p> * * @return the current content start text */
@Override public String getContentStart() { // NOPMD as this is implementing the abstract class return super.getContentStart(); }

Sets the content start text.

null is accepted, but will be converted to an empty String.

Params:
  • contentStart – the new content start text
/** * <p>Sets the content start text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param contentStart the new content start text */
@Override public void setContentStart(final String contentStart) { // NOPMD as this is implementing the abstract class super.setContentStart(contentStart); } //---------------------------------------------------------------------

Gets the content end text.

Returns:the current content end text
/** * <p>Gets the content end text.</p> * * @return the current content end text */
@Override public String getContentEnd() { // NOPMD as this is implementing the abstract class return super.getContentEnd(); }

Sets the content end text.

null is accepted, but will be converted to an empty String.

Params:
  • contentEnd – the new content end text
/** * <p>Sets the content end text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param contentEnd the new content end text */
@Override public void setContentEnd(final String contentEnd) { // NOPMD as this is implementing the abstract class super.setContentEnd(contentEnd); } //---------------------------------------------------------------------

Gets the field name value separator text.

Returns:the current field name value separator text
/** * <p>Gets the field name value separator text.</p> * * @return the current field name value separator text */
@Override public String getFieldNameValueSeparator() { // NOPMD as this is implementing the abstract class return super.getFieldNameValueSeparator(); }

Sets the field name value separator text.

null is accepted, but will be converted to an empty String.

Params:
  • fieldNameValueSeparator – the new field name value separator text
/** * <p>Sets the field name value separator text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param fieldNameValueSeparator the new field name value separator text */
@Override public void setFieldNameValueSeparator(final String fieldNameValueSeparator) { // NOPMD as this is implementing the abstract class super.setFieldNameValueSeparator(fieldNameValueSeparator); } //---------------------------------------------------------------------

Gets the field separator text.

Returns:the current field separator text
/** * <p>Gets the field separator text.</p> * * @return the current field separator text */
@Override public String getFieldSeparator() { // NOPMD as this is implementing the abstract class return super.getFieldSeparator(); }

Sets the field separator text.

null is accepted, but will be converted to an empty String.

Params:
  • fieldSeparator – the new field separator text
/** * <p>Sets the field separator text.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param fieldSeparator the new field separator text */
@Override public void setFieldSeparator(final String fieldSeparator) { // NOPMD as this is implementing the abstract class super.setFieldSeparator(fieldSeparator); } //---------------------------------------------------------------------

Gets whether the field separator should be added at the start of each buffer.

Returns:the fieldSeparatorAtStart flag
Since:2.0
/** * <p>Gets whether the field separator should be added at the start * of each buffer.</p> * * @return the fieldSeparatorAtStart flag * @since 2.0 */
@Override public boolean isFieldSeparatorAtStart() { // NOPMD as this is implementing the abstract class return super.isFieldSeparatorAtStart(); }

Sets whether the field separator should be added at the start of each buffer.

Params:
  • fieldSeparatorAtStart – the fieldSeparatorAtStart flag
Since:2.0
/** * <p>Sets whether the field separator should be added at the start * of each buffer.</p> * * @param fieldSeparatorAtStart the fieldSeparatorAtStart flag * @since 2.0 */
@Override public void setFieldSeparatorAtStart(final boolean fieldSeparatorAtStart) { // NOPMD as this is implementing the abstract class super.setFieldSeparatorAtStart(fieldSeparatorAtStart); } //---------------------------------------------------------------------

Gets whether the field separator should be added at the end of each buffer.

Returns:fieldSeparatorAtEnd flag
Since:2.0
/** * <p>Gets whether the field separator should be added at the end * of each buffer.</p> * * @return fieldSeparatorAtEnd flag * @since 2.0 */
@Override public boolean isFieldSeparatorAtEnd() { // NOPMD as this is implementing the abstract class return super.isFieldSeparatorAtEnd(); }

Sets whether the field separator should be added at the end of each buffer.

Params:
  • fieldSeparatorAtEnd – the fieldSeparatorAtEnd flag
Since:2.0
/** * <p>Sets whether the field separator should be added at the end * of each buffer.</p> * * @param fieldSeparatorAtEnd the fieldSeparatorAtEnd flag * @since 2.0 */
@Override public void setFieldSeparatorAtEnd(final boolean fieldSeparatorAtEnd) { // NOPMD as this is implementing the abstract class super.setFieldSeparatorAtEnd(fieldSeparatorAtEnd); } //---------------------------------------------------------------------

Gets the text to output when null found.

Returns:the current text to output when null found
/** * <p>Gets the text to output when <code>null</code> found.</p> * * @return the current text to output when <code>null</code> found */
@Override public String getNullText() { // NOPMD as this is implementing the abstract class return super.getNullText(); }

Sets the text to output when null found.

null is accepted, but will be converted to an empty String.

Params:
  • nullText – the new text to output when null found
/** * <p>Sets the text to output when <code>null</code> found.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param nullText the new text to output when <code>null</code> found */
@Override public void setNullText(final String nullText) { // NOPMD as this is implementing the abstract class super.setNullText(nullText); } //---------------------------------------------------------------------

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
/** * <p>Gets the text to output when a <code>Collection</code>, * <code>Map</code> or <code>Array</code> size is output.</p> * * <p>This is output before the size value.</p> * * @return the current start of size text */
@Override public String getSizeStartText() { // NOPMD as this is implementing the abstract class return super.getSizeStartText(); }

Sets the start 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 an empty String.

Params:
  • sizeStartText – the new start of size text
/** * <p>Sets the start text to output when a <code>Collection</code>, * <code>Map</code> or <code>Array</code> size is output.</p> * * <p>This is output before the size value.</p> * * <p><code>null</code> is accepted, but will be converted to * an empty String.</p> * * @param sizeStartText the new start of size text */
@Override public void setSizeStartText(final String sizeStartText) { // NOPMD as this is implementing the abstract class super.setSizeStartText(sizeStartText); } //---------------------------------------------------------------------

Gets the end 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
/** * <p>Gets the end text to output when a <code>Collection</code>, * <code>Map</code> or <code>Array</code> size is output.</p> * * <p>This is output after the size value.</p> * * @return the current end of size text */
@Override public String getSizeEndText() { // NOPMD as this is implementing the abstract class return super.getSizeEndText(); }

Sets the end 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 an empty String.

Params:
  • sizeEndText – the new end of size text
/** * <p>Sets the end text to output when a <code>Collection</code>, * <code>Map</code> or <code>Array</code> size is output.</p> * * <p>This is output after the size value.</p> * * <p><code>null</code> is accepted, but will be converted * to an empty String.</p> * * @param sizeEndText the new end of size text */
@Override public void setSizeEndText(final String sizeEndText) { // NOPMD as this is implementing the abstract class super.setSizeEndText(sizeEndText); } //---------------------------------------------------------------------

Gets the start 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
/** * <p>Gets the start text to output when an <code>Object</code> is * output in summary mode.</p> * * <P>This is output before the size value.</p> * * @return the current start of summary text */
@Override public String getSummaryObjectStartText() { // NOPMD as this is implementing the abstract class return super.getSummaryObjectStartText(); }

Sets the start 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 an empty String.

Params:
  • summaryObjectStartText – the new start of summary text
/** * <p>Sets the start text to output when an <code>Object</code> is * output in summary mode.</p> * * <p>This is output before the size value.</p> * * <p><code>null</code> is accepted, but will be converted to * an empty String.</p> * * @param summaryObjectStartText the new start of summary text */
@Override public void setSummaryObjectStartText(final String summaryObjectStartText) { // NOPMD as this is implementing the abstract class super.setSummaryObjectStartText(summaryObjectStartText); } //---------------------------------------------------------------------

Gets the end 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
/** * <p>Gets the end text to output when an <code>Object</code> is * output in summary mode.</p> * * <p>This is output after the size value.</p> * * @return the current end of summary text */
@Override public String getSummaryObjectEndText() { // NOPMD as this is implementing the abstract class return super.getSummaryObjectEndText(); }

Sets the end 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 an empty String.

Params:
  • summaryObjectEndText – the new end of summary text
/** * <p>Sets the end text to output when an <code>Object</code> is * output in summary mode.</p> * * <p>This is output after the size value.</p> * * <p><code>null</code> is accepted, but will be converted to * an empty String.</p> * * @param summaryObjectEndText the new end of summary text */
@Override public void setSummaryObjectEndText(final String summaryObjectEndText) { // NOPMD as this is implementing the abstract class super.setSummaryObjectEndText(summaryObjectEndText); } //--------------------------------------------------------------------- }