Top Description Fields Methods
tools.jackson.core

public Interface PrettyPrinter

Known Direct Implementers
tools.jackson.core.util.DefaultPrettyPrinter, tools.jackson.core.util.MinimalPrettyPrinter
Imports
tools.jackson.core.exc.JacksonIOException, .StreamWriteException, tools.jackson.core.io.SerializedString, tools.jackson.core.util.Separators
Interface for objects that implement pretty printer functionality, such as indentation. Pretty printers are used to add white space in output JSON content, to make results more human readable. Usually this means things like adding linefeeds and indentation.

Note

stateful implementations MUST implement tools.jackson.core.util.Instantiatable interface, to allow for constructing per-generation instances and avoid state corruption. Stateless implementations need not do this; but those are less common.

Field Summary

Modifier and TypeField and Description
public static final SerializedString
DEFAULT_ROOT_VALUE_SEPARATOR

Default String used for separating root values is single space.

public static final Separators
DEFAULT_SEPARATORS

Method Summary

Modifier and TypeMethod and Description
public void
beforeArrayValues(JsonGenerator
Generator used for output
g)

Method called after array start marker has been output, and right before the first value is to be output.

public void
beforeObjectEntries(JsonGenerator
Generator used for output
g)

Method called after object start marker has been output, and right before the Name of the first property is to be output.

public void
writeArrayValueSeparator(JsonGenerator
Generator used for output
g)

Method called after an array value has been completely output, and before another value is to be output.

public void
writeEndArray(JsonGenerator
Generator used for output
g, int
Number of direct members of the array that have been output
nrOfValues)

Method called after an Array value has been completely output (minus closing bracket).

public void
writeEndObject(JsonGenerator
Generator used for output
g, int
Number of direct members of the Object that have been output
nrOfEntries)

Method called after an Object value has been completely output (minus closing curly bracket).

public void
writeObjectEntrySeparator(JsonGenerator
Generator used for output
g)

Method called after an Object entry (field:value) has been completely output, and before another value is to be output.

public void
writeObjectNameValueSeparator(JsonGenerator
Generator used for output
g)

Method called after an Object property name has been output, but before the value is output.

public void
writeRootValueSeparator(JsonGenerator
Generator used for output
g)

Method called after a root-level value has been completely output, and before another value is to be output.

public void
writeStartArray(JsonGenerator
Generator used for output
g)

Method called when an Array value is to be output, before any member/child values are output.

public void
writeStartObject(JsonGenerator
Generator used for output
g)

Method called when an Object value is to be output, before any fields are output.

Field Detail

DEFAULT_ROOT_VALUE_SEPARATORback to summary
public static final SerializedString DEFAULT_ROOT_VALUE_SEPARATOR

Default String used for separating root values is single space.

DEFAULT_SEPARATORSback to summary
public static final Separators DEFAULT_SEPARATORS

Method Detail

beforeArrayValuesback to summary
public void beforeArrayValues(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
beforeObjectEntriesback to summary
public void beforeObjectEntries(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeArrayValueSeparatorback to summary
public void writeArrayValueSeparator(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeEndArrayback to summary
public void writeEndArray(JsonGenerator g, int nrOfValues) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

nrOfValues:int

Number of direct members of the array that have been output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeEndObjectback to summary
public void writeEndObject(JsonGenerator g, int nrOfEntries) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

nrOfEntries:int

Number of direct members of the Object that have been output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeObjectEntrySeparatorback to summary
public void writeObjectEntrySeparator(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeObjectNameValueSeparatorback to summary
public void writeObjectNameValueSeparator(JsonGenerator g) throws JacksonException

Method called after an 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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeRootValueSeparatorback to summary
public void writeRootValueSeparator(JsonGenerator g) throws JacksonException

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).

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeStartArrayback to summary
public void writeStartArray(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream
writeStartObjectback to summary
public void writeStartObject(JsonGenerator g) throws JacksonException

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.

Parameters
g:JsonGenerator

Generator used for output

Exceptions
JacksonIOException:
if there is an underlying I/O problem
StreamWriteException:
for problems in encoding token stream