PrettyPrinter implementation that uses 2-space
indentation with platform-default linefeeds.
Usually this class is not instantiated directly, but instead
instantiated by JsonFactory or databind level mapper.
If you override this class, take note of Instantiatable,
as subclasses will still create an instance of DefaultPrettyPrinter.
This class is designed for the JSON data format. It works on other formats
with same logical model (such as binary CBOR and Smile formats),
but may not work as-is for other data formats, most notably XML.
It may be necessary to use format-specific PrettyPrinter
implementation specific to that format.
| Modifier and Type | Class and Description |
|---|---|
| public static class | DefaultPrettyPrinter.
This is a very simple indenter that only adds a single space for indentation. |
| public static interface | DefaultPrettyPrinter.
Interface that defines objects that can produce indentation used to separate object entries and array values. |
| public static class | DefaultPrettyPrinter.
Dummy implementation that adds no indentation whatsoever |
| Modifier and Type | Field and Description |
|---|---|
| protected final String | _arrayElementSeparator
Separator between Array elements, including possible before/after spaces. |
| protected final String | _arrayEmptySeparator
String to use in empty Array to separate start and end markers. |
| protected DefaultPrettyPrinter. | _arrayIndenter
By default, let's use only spaces to separate array values. |
| protected transient int | _nesting
Number of open levels of nesting. |
| protected final String | _objectEmptySeparator
String to use in empty Object to separate start and end markers. |
| protected final String | _objectEntrySeparator
Separator between Object property entries, including possible before/after spaces. |
| protected DefaultPrettyPrinter. | _objectIndenter
By default, let's use linefeed-adding indenter for separate object entries. |
| protected final String | _objectNameValueSeparator
Separator between Object property names and values, including possible before/after spaces. |
| protected final SerializableString | _rootValueSeparator
String printed between root-level values, if any. |
| protected final Separators | |
| private static final long |
| Access | Constructor and Description |
|---|---|
| public | |
| public | DefaultPrettyPrinter(Separators
Custom separator definition over defaults. separators)Default constructor for "vanilla" instance with default settings,
except for |
| public | |
| public | DefaultPrettyPrinter(DefaultPrettyPrinter
DefaultPrettyPrinter being copied base, Separators Separators to use instead of ones separators)base hadCopy constructor with override |
| Modifier and Type | Method and Description |
|---|---|
| protected DefaultPrettyPrinter | |
| public void | beforeArrayValues(JsonGenerator g)
Implements tools. Method called after array start marker has been output, and right before the first value is to be output. |
| public void | beforeObjectEntries(JsonGenerator g)
Implements tools. Method called after object start marker has been output, and right before the Name of the first property is to be output. |
| public DefaultPrettyPrinter | createInstance()
Implements tools. Method called to ensure that we have a non-blueprint object to use; it is either this object (if stateless), or a newly created object with separate state. |
| public void | |
| public void | |
| public DefaultPrettyPrinter | |
| public DefaultPrettyPrinter | |
| public DefaultPrettyPrinter | Returns: This pretty-printer instance (for call chaining)Separator definitions to use separators)Method for configuring separators for this pretty-printer to use |
| public void | writeArrayValueSeparator(JsonGenerator g)
Implements tools. Method called after an array value has been completely output, and before another value is to be output. |
| public void | writeEndArray(JsonGenerator g, int nrOfValues)
Implements tools. Method called after an Array value has been completely output (minus closing bracket). |
| public void | writeEndObject(JsonGenerator g, int nrOfEntries)
Implements tools. Method called after an Object value has been completely output (minus closing curly bracket). |
| public void | writeObjectEntrySeparator(JsonGenerator g)
Implements tools. Method called after an object entry (field:value) has been completely output, and before another value is to be output. |
| public void | writeObjectNameValueSeparator(JsonGenerator g)
Implements tools. Method called after the object property name has been output, but before the value is output. |
| public void | writeRootValueSeparator(JsonGenerator g)
Implements tools. Method called after a root-level value has been completely output, and before another value is to be output. |
| public void | writeStartArray(JsonGenerator g)
Implements tools. Method called when an Array value is to be output, before any member/child values are output. |
| public void | writeStartObject(JsonGenerator g)
Implements tools. Method called when an Object value is to be output, before any fields are output. |
| _arrayElementSeparator | back to summary |
|---|---|
| protected final String _arrayElementSeparator Separator between Array elements, including possible before/after spaces. | |
| _arrayEmptySeparator | back to summary |
|---|---|
| protected final String _arrayEmptySeparator String to use in empty Array to separate start and end markers.
Default is single space, resulting in output of | |
| _arrayIndenter | back to summary |
|---|---|
| protected DefaultPrettyPrinter. By default, let's use only spaces to separate array values. | |
| _nesting | back to summary |
|---|---|
| protected transient int _nesting Number of open levels of nesting. Used to determine amount of indentation to use. | |
| _objectEmptySeparator | back to summary |
|---|---|
| protected final String _objectEmptySeparator String to use in empty Object to separate start and end markers.
Default is single space, resulting in output of | |
| _objectEntrySeparator | back to summary |
|---|---|
| protected final String _objectEntrySeparator Separator between Object property entries, including possible before/after spaces. | |
| _objectIndenter | back to summary |
|---|---|
| protected DefaultPrettyPrinter. By default, let's use linefeed-adding indenter for separate object entries. We'll further configure indenter to use system-specific linefeeds, and 2 spaces per level (as opposed to, say, single tabs) | |
| _objectNameValueSeparator | back to summary |
|---|---|
| protected final String _objectNameValueSeparator Separator between Object property names and values, including possible before/after spaces. | |
| _rootValueSeparator | back to summary |
|---|---|
| protected final SerializableString _rootValueSeparator String printed between root-level values, if any. | |
| _separators | back to summary |
|---|---|
| protected final Separators _separators | |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID | |
| DefaultPrettyPrinter | back to summary |
|---|---|
| public DefaultPrettyPrinter() Default constructor for "vanilla" instance with default settings. | |
| DefaultPrettyPrinter | back to summary |
|---|---|
| public DefaultPrettyPrinter(Separators separators) Default constructor for "vanilla" instance with default settings,
except for
| |
| DefaultPrettyPrinter | back to summary |
|---|---|
| public DefaultPrettyPrinter(DefaultPrettyPrinter base) Copy constructor.
| |
| DefaultPrettyPrinter | back to summary |
|---|---|
| public DefaultPrettyPrinter(DefaultPrettyPrinter base, Separators separators) Copy constructor with override
| |
| _withSpaces | back to summary |
|---|---|
| protected DefaultPrettyPrinter _withSpaces(boolean state) | |
| beforeArrayValues | back to summary |
|---|---|
| public void beforeArrayValues(JsonGenerator g) throws JacksonException Implements tools. Doc from tools. Method called after array start marker has been output, and right before the first value is to be output. It is not called for arrays with no values. Default handling does not output anything, but pretty-printer is free to add any white space decoration.
| |
| beforeObjectEntries | back to summary |
|---|---|
| public void beforeObjectEntries(JsonGenerator g) throws JacksonException Implements tools. Doc from tools. Method called after object start marker has been output, and right before the Name of the first property is to be output. It is not called for objects without properties. Default handling does not output anything, but pretty-printer is free to add any white space decoration.
| |
| createInstance | back to summary |
|---|---|
| public DefaultPrettyPrinter createInstance() Implements tools. Doc from tools. Method called to ensure that we have a non-blueprint object to use; it is either this object (if stateless), or a newly created object with separate state.
| |
| indentArraysWith | back to summary |
|---|---|
| public void indentArraysWith(DefaultPrettyPrinter. | |
| indentObjectsWith | back to summary |
|---|---|
| public void indentObjectsWith(DefaultPrettyPrinter. | |
| withArrayIndenter | back to summary |
|---|---|
| public DefaultPrettyPrinter withArrayIndenter(DefaultPrettyPrinter. | |
| withObjectIndenter | back to summary |
|---|---|
| public DefaultPrettyPrinter withObjectIndenter(DefaultPrettyPrinter. | |
| withSeparators | back to summary |
|---|---|
| public DefaultPrettyPrinter withSeparators(Separators separators) Method for configuring separators for this pretty-printer to use
| |
| writeArrayValueSeparator | back to summary |
|---|---|
| public void writeArrayValueSeparator(JsonGenerator g) throws JacksonException Implements tools. Method called after an array value has been completely output, and before another value is to be output. Default handling (without pretty-printing) will output a single comma to separate the two. Pretty-printer is to output a comma as well, but can surround that with other (white-space) decoration.
| |
| writeEndArray | back to summary |
|---|---|
| public void writeEndArray(JsonGenerator g, int nrOfValues) throws JacksonException Implements tools. Doc from tools. Method called after an Array value has been completely output (minus closing bracket). Default handling (without pretty-printing) will output the closing bracket. Pretty-printer is to output a bracket as well, but can surround that with other (white-space) decoration.
| |
| writeEndObject | back to summary |
|---|---|
| public void writeEndObject(JsonGenerator g, int nrOfEntries) throws JacksonException Implements tools. Doc from tools. Method called after an Object value has been completely output (minus closing curly bracket). Default handling (without pretty-printing) will output the closing curly bracket. Pretty-printer is to output a curly bracket as well, but can surround that with other (white-space) decoration.
| |
| writeObjectEntrySeparator | back to summary |
|---|---|
| public void writeObjectEntrySeparator(JsonGenerator g) throws JacksonException Implements tools. Method called after an object entry (field:value) has been completely output, and before another value is to be output. Default handling (without pretty-printing) will output a single comma to separate the two. Pretty-printer is to output a comma as well, but can surround that with other (white-space) decoration.
| |
| writeObjectNameValueSeparator | back to summary |
|---|---|
| public void writeObjectNameValueSeparator(JsonGenerator g) throws JacksonException Implements tools. Method called after the object property name has been output, but before the value is output. Default handling (without pretty-printing) will output a single colon to separate the two. Pretty-printer is to output a colon as well, but can surround that with other (white-space) decoration.
| |
| writeRootValueSeparator | back to summary |
|---|---|
| public void writeRootValueSeparator(JsonGenerator g) throws JacksonException Implements tools. Doc from tools. Method called after a root-level value has been completely output, and before another value is to be output. Default handling (without pretty-printing) will output a space, to allow values to be parsed correctly. Pretty-printer is to output some other suitable and nice-looking separator (tab(s), space(s), linefeed(s) or any combination thereof).
| |
| writeStartArray | back to summary |
|---|---|
| public void writeStartArray(JsonGenerator g) throws JacksonException Implements tools. Doc from tools. Method called when an Array value is to be output, before any member/child values are output. Default handling (without pretty-printing) will output the opening bracket. Pretty-printer is to output a bracket as well, but can surround that with other (white-space) decoration.
| |
| writeStartObject | back to summary |
|---|---|
| public void writeStartObject(JsonGenerator g) throws JacksonException Implements tools. Doc from tools. Method called when an Object value is to be output, before any fields are output. Default handling (without pretty-printing) will output the opening curly bracket. Pretty-printer is to output a curly bracket as well, but can surround that with other (white-space) decoration.
| |
| Modifier and Type | Field and Description |
|---|---|
| private static final DefaultPrettyPrinter. |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public static DefaultPrettyPrinter. | |
| public boolean | |
| public void |
| _fixedInstance | back to summary |
|---|---|
| private static final DefaultPrettyPrinter. | |
| FixedSpaceIndenter | back to summary |
|---|---|
| public FixedSpaceIndenter() | |
| instance | back to summary |
|---|---|
| public static DefaultPrettyPrinter. Hides tools. | |
| isInline | back to summary |
|---|---|
| public boolean isInline() Overrides tools. Implements tools.
| |
| writeIndentation | back to summary |
|---|---|
| public void writeIndentation(JsonGenerator g, int level) throws JacksonException Overrides tools. Implements tools.
| |
| Modifier and Type | Method and Description |
|---|---|
| public boolean | |
| public void |
| isInline | back to summary |
|---|---|
public boolean isInline()
| |
| writeIndentation | back to summary |
|---|---|
| public void writeIndentation(JsonGenerator g, int level) throws JacksonException | |
| Modifier and Type | Field and Description |
|---|---|
| private static final DefaultPrettyPrinter. |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public static DefaultPrettyPrinter. | |
| public boolean | |
| public void | writeIndentation(JsonGenerator g, int level)
Implements tools.
|
| _nopInstance | back to summary |
|---|---|
| private static final DefaultPrettyPrinter. | |
| NopIndenter | back to summary |
|---|---|
| public NopIndenter() | |
| instance | back to summary |
|---|---|
| public static DefaultPrettyPrinter. | |
| isInline | back to summary |
|---|---|
| public boolean isInline() Implements tools.
| |
| writeIndentation | back to summary |
|---|---|
| public void writeIndentation(JsonGenerator g, int level) Implements tools.
| |