Module org.jooq
Package org.jooq

Class JSONFormat

java.lang.Object
org.jooq.JSONFormat
public final class JSONFormat extends Object
A JSON formatting type, which can be used to configure JSON imports / exports.

The default format is the following, using header() equal to true and applying JSONFormat.RecordFormat.ARRAY: 


 {"fields":[{"name":"field-1","type":"type-1"},
            {"name":"field-2","type":"type-2"},
             ...,
            {"name":"field-n","type":"type-n"}],
 "records":[[value-1-1,value-1-2,...,value-1-n],
            [value-2-1,value-2-2,...,value-2-n]]}

If header() is set to false, then the result is simply the records array, either using JSONFormat.RecordFormat.ARRAY: 


 [[value-1-1,value-1-2,...,value-1-n],
  [value-2-1,value-2-2,...,value-2-n]]

or, using JSONFormat.RecordFormat.OBJECT: 


 [{"field-1": value-1-1, "field-2": value-1-2,..., "field-n": value-1-n},
  {"field-1": value-2-1, "field-2": value-2-2,..., "field-n": value-2-n}]

The type is immutable, meaning calls to setters like header(boolean) do not modify the original reference, but return a new one instead.

Author:
Lukas Eder

  • Field Details

    • DEFAULT_FOR_RESULTS

      public static final JSONFormat DEFAULT_FOR_RESULTS

    • DEFAULT_FOR_RECORDS

      public static final JSONFormat DEFAULT_FOR_RECORDS

  • Constructor Details

    • JSONFormat

      public JSONFormat()

  • Method Details

    • mutable

      public final boolean mutable()
      Whether this configuration object is mutable.

    • mutable

      @NotNull public final @NotNull JSONFormat mutable(boolean newMutable)
      The new value for the mutable flag, defaulting to false.

    • redacted

      @NotNull @Pro public final @NotNull JSONFormat redacted(String newRedacted)
      The string value to show for redacted content.

    • redacted

      @Pro public final String redacted()
      The string value to show for redacted content.

    • format

      @NotNull public final @NotNull JSONFormat format(boolean newFormat)
      The new value for the formatting flag, defaulting to false.

    • format

      public final boolean format()
      The formatting flag.

    • newline

      @NotNull public final @NotNull JSONFormat newline(String newNewline)
      The new newline character, defaulting to \n.

    • newline

      @NotNull public final @NotNull String newline()
      The formatting flag.

    • globalIndent

      @NotNull public final @NotNull JSONFormat globalIndent(int newGlobalIndent)
      The new global indentation size applied on all levels, defaulting to 0.

    • globalIndent

      public final int globalIndent()
      The global indentation applied on all levels.

    • indent

      @NotNull public final @NotNull JSONFormat indent(int newIndent)
      The new indentation size per level value, defaulting to 2.

    • indent

      public final int indent()
      The indentation size per level.

    • indentString

      @NotNull public final @NotNull String indentString(int level)
      Convenience method to get an indentation string at a given level.

    • header

      @NotNull public final @NotNull JSONFormat header(boolean newHeader)
      Whether to emit a header row with column names, defaulting to true.

    • header

      public final boolean header()
      Whether to emit a header row with column names, defaulting to true.

    • valueFormat

      @NotNull public final @NotNull JSONFormat valueFormat(JSONFormat.ValueFormat newValueFormat)
      The value format to be applied, defaulting to JSONFormat.ValueFormat.TO_TYPE.

    • valueFormat

      @NotNull public final @NotNull JSONFormat.ValueFormat valueFormat()
      The value format to be applied, defaulting to JSONFormat.ValueFormat.TO_TYPE.

    • recordFormat

      @NotNull public final @NotNull JSONFormat recordFormat(JSONFormat.RecordFormat newRecordFormat)
      The record format to be applied, defaulting to JSONFormat.RecordFormat.ARRAY.

    • recordFormat

      @NotNull public final @NotNull JSONFormat.RecordFormat recordFormat()
      The record format to be applied, defaulting to JSONFormat.RecordFormat.ARRAY.

    • objectNulls

      @NotNull public final @NotNull JSONFormat objectNulls(JSONFormat.NullFormat newObjectNulls)
      The null format to be applied to objects, defaulting to JSONFormat.NullFormat.NULL_ON_NULL.

    • objectNulls

      @NotNull public final @NotNull JSONFormat.NullFormat objectNulls()
      The null format to be applied to objects, defaulting to JSONFormat.NullFormat.NULL_ON_NULL.

    • arrayNulls

      @NotNull public final @NotNull JSONFormat arrayNulls(JSONFormat.NullFormat newArrayNulls)
      The null format to be applied to arrays, defaulting to JSONFormat.NullFormat.NULL_ON_NULL.

    • arrayNulls

      @NotNull public final @NotNull JSONFormat.NullFormat arrayNulls()
      The null format to be applied to arrays, defaulting to JSONFormat.NullFormat.NULL_ON_NULL.

    • wrapSingleColumnRecords

      @NotNull public final @NotNull JSONFormat wrapSingleColumnRecords(boolean newWrapSingleColumnRecords)
      Whether to wrap single column records in the recordFormat().

    • wrapSingleColumnRecords

      public final boolean wrapSingleColumnRecords()
      Whether to wrap single column records in the recordFormat().

    • quoteNested

      @NotNull public final @NotNull JSONFormat quoteNested(boolean newQuoteNested)
      Whether nested JSON or JSONB content should be quoted like a string, or nested into JSON formatted output.

    • quoteNested

      public final boolean quoteNested()
      Whether nested JSON or JSONB content should be quoted like a string, or nested into JSON formatted output.

    • nanAsString

      @NotNull public final @NotNull JSONFormat nanAsString(boolean newNanAsString)
      Whether Double.NaN and Float.NaN values should be formatted as "NaN" strings. The default is to format them as null, as JSON doesn't support NaN values.

    • nanAsString

      public final boolean nanAsString()
      Whether Double.NaN and Float.NaN values should be formatted as "NaN" strings. The default is to format them as null, as JSON doesn't support NaN values.

    • infinityAsString

      @NotNull public final @NotNull JSONFormat infinityAsString(boolean newInfinityAsString)
      Whether Double.POSITIVE_INFINITY, Double.NEGATIVE_INFINITY, Float.POSITIVE_INFINITY, and Float.NEGATIVE_INFINITY values should be formatted as "Infinity" or "-Infinity" strings. The default is to format them as null, as JSON doesn't support Infinity values.

    • infinityAsString

      public final boolean infinityAsString()
      Whether Double.POSITIVE_INFINITY, Double.NEGATIVE_INFINITY, Float.POSITIVE_INFINITY, and Float.NEGATIVE_INFINITY values should be formatted as "Infinity" or "-Infinity" strings. The default is to format them as null, as JSON doesn't support Infinity values.

    • binaryFormat

      @NotNull public final @NotNull JSONFormat binaryFormat(JSONFormat.BinaryFormat newBinaryFormat)
      The JSONFormat.BinaryFormat to use when formatting binary data.

    • binaryFormat

      public final JSONFormat.BinaryFormat binaryFormat()
      The JSONFormat.BinaryFormat to use when formatting binary data.