Jackson 3.0.1 · tools.jackson.dataformat.toml.TomlGenerator

Modifier and Type	Field and Description
protected final StringBuilder	_basePath
protected final Writer	_out Underlying `Writer` used for output.
protected char[]	_outputBuffer Intermediate buffer in which contents are buffered before being written using `_out`.
protected final int	_outputEnd Offset to index after the last valid index in `_outputBuffer`.
protected int	_outputTail Pointer to the next available location in `_outputBuffer`
protected TomlWriteContext	_streamWriteContext Current context, in form we can use it (GeneratorBase has untyped reference; left as null)
private final int	_tomlFeatures
protected static final int	SHORT_WRITE

Access	Constructor and Description
public	TomlGenerator(ObjectWriteContext writeCtxt, IOContext ioCtxt, int stdFeatures, int tomlFeatures, Writer out)

Method Summary

Modifier and Type	Method and Description
private void	_appendPropertyName(StringBuilder path, String name)
protected void	_closeInput() Implements abstract tools.jackson.core.base.GeneratorBase._closeInput.
protected void	_flushBuffer()
protected void	_releaseBuffers() Implements abstract tools.jackson.core.base.GeneratorBase._releaseBuffers. Method called to release any buffers generator may be holding, once generator is being closed.
protected void	_verifyValueWrite(String typeMsg) Implements abstract tools.jackson.core.base.GeneratorBase._verifyValueWrite. Method called before trying to write a value (scalar or structured), to verify that this is legal in current output state, as well as to output separators if and as necessary.
protected void	_verifyValueWrite(String typeMsg, boolean forceMaterializeKey)
protected JsonGenerator	_writeRaw(char c)
protected JsonGenerator	_writeRaw(String text)
protected JsonGenerator	_writeRaw(StringBuilder text)
protected JsonGenerator	_writeRaw(char[] text, int offset, int len)
protected void	_writeRawLong(String text)
protected void	_writeRawLong(StringBuilder text)
private void	_writeStringImpl(int categoryMask, String name)
private void	_writeStringImpl(int categoryMask, char[] text, int offset, int len)
public void	assignCurrentValue(Object v) Implements abstract tools.jackson.core.JsonGenerator.assignCurrentValue. Helper method, usually equivalent to: `getOutputContext().assignCurrentValue(v);` used to assign "current value" for the current context of this generator.
public boolean	canOmitProperties() Overrides tools.jackson.core.JsonGenerator.canOmitProperties. Introspection method to call to check whether it is ok to omit writing of Object properties or not.
public boolean	canWriteObjectId() Overrides tools.jackson.core.JsonGenerator.canWriteObjectId. Introspection method that may be called to see if the underlying data format supports some kind of Object Ids natively (many do not; for example, JSON doesn't).
public boolean	canWriteTypeId() Overrides tools.jackson.core.JsonGenerator.canWriteTypeId. Introspection method that may be called to see if the underlying data format supports some kind of Type Ids natively (many do not; for example, JSON doesn't).
public void	close() Overrides tools.jackson.core.base.GeneratorBase.close. Implements java.io.Closeable.close. Method called to close this generator, so that no more content can be written.
public Object	currentValue() Implements abstract tools.jackson.core.JsonGenerator.currentValue. Helper method, usually equivalent to: `getOutputContext().currentValue();` Note that "current value" is NOT populated (or used) by Streaming generator; it is only used by higher-level data-binding functionality.
public void	flush() Implements abstract tools.jackson.core.JsonGenerator.flush. Implements java.io.Flushable.flush. Method called to flush any buffered content to the underlying target (output stream, writer), and to flush the target itself as well.
public PrettyPrinter	getPrettyPrinter() Overrides tools.jackson.core.JsonGenerator.getPrettyPrinter. Accessor for object that handles pretty-printing (usually additional white space to make results more human-readable) during output.
public JacksonFeatureSet<StreamWriteCapability>	streamWriteCapabilities() Implements abstract tools.jackson.core.JsonGenerator.streamWriteCapabilities. Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
public TokenStreamContext	streamWriteContext() Implements abstract tools.jackson.core.JsonGenerator.streamWriteContext. Accessor for context object that provides information about low-level logical position withing output token stream.
public int	streamWriteOutputBuffered() Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputBuffered. Method for verifying amount of content that is buffered by generator but not yet flushed to the underlying target (stream, writer), in units (byte, char) that the generator implementation uses for buffering; or -1 if this information is not available.
public Object	streamWriteOutputTarget() Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputTarget. Method that can be used to get access to object that is used as target for generated output; this is usually either `java.io.OutputStream` or `java.io.Writer`, depending on what generator was constructed with.
public Version	version() Implements abstract tools.jackson.core.JsonGenerator.version. Implements tools.jackson.core.Versioned.version. Accessor for finding out version of the bundle that provided this generator instance.
public JsonGenerator	writeBinary(Base64Variant b64variant, byte[] data, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeBinary. Method that will output given chunk of binary data as base64 encoded, as a complete String value (surrounded by double quotes).
public JsonGenerator	writeBoolean(boolean state) Implements abstract tools.jackson.core.JsonGenerator.writeBoolean. Method for outputting literal JSON boolean value (one of Strings 'true' and 'false').
private void	writeCurrentPath()
public JsonGenerator	writeEndArray() Implements abstract tools.jackson.core.JsonGenerator.writeEndArray. Method for writing closing marker of a JSON Array value (character ']'; plus possible white space decoration if pretty-printing is enabled).
public JsonGenerator	writeEndObject() Implements abstract tools.jackson.core.JsonGenerator.writeEndObject. Method for writing closing marker of an Object value (character '}'; plus possible white space decoration if pretty-printing is enabled).
public JsonGenerator	writeName(String name) Implements abstract tools.jackson.core.JsonGenerator.writeName. Method for writing an Object Property name (JSON String surrounded by double quotes: syntactically identical to a JSON String value), possibly decorated by white space if pretty-printing is enabled.
public JsonGenerator	writeNull() Implements abstract tools.jackson.core.JsonGenerator.writeNull. Method for outputting literal JSON null value.
public JsonGenerator	writeNumber(short v) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number.
public JsonGenerator	writeNumber(int i) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number.
public JsonGenerator	writeNumber(long l) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number.
public JsonGenerator	writeNumber(BigInteger v) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number.
public JsonGenerator	writeNumber(double d) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting indicate JSON numeric value.
public JsonGenerator	writeNumber(float f) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting indicate JSON numeric value.
public JsonGenerator	writeNumber(BigDecimal dec) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Method for outputting indicate JSON numeric value.
public JsonGenerator	writeNumber(String encodedValue) Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Write method that can be used for custom numeric types that can not be (easily?) converted to "standard" Java number types.
public JsonGenerator	writePOJO(Object value) Overrides tools.jackson.core.base.GeneratorBase.writePOJO. Method for writing given Java object (POJO) as tokens into stream this generator manages; serialization must be a valid JSON Value (Object, Array, null, Number, String or Boolean).
public JsonGenerator	writePropertyId(long id) Implements abstract tools.jackson.core.JsonGenerator.writePropertyId. Alternative to `writeName(String)` that may be used in cases where Object Property key is of numeric type; usually where underlying format supports such notion (some binary formats do, unlike JSON).
public JsonGenerator	writeRaw(String text) Implements abstract tools.jackson.core.JsonGenerator.writeRaw. Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such).
public JsonGenerator	writeRaw(String text, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeRaw. Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such).
public JsonGenerator	writeRaw(char[] text, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeRaw. Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such).
public JsonGenerator	writeRaw(char c) Implements abstract tools.jackson.core.JsonGenerator.writeRaw. Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such).
public JsonGenerator	writeRaw(SerializableString text) Overrides tools.jackson.core.JsonGenerator.writeRaw. Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such).
public JsonGenerator	writeRawUTF8String(byte[] text, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeRawUTF8String. Method similar to `writeString(String)` but that takes as its input a UTF-8 encoded String that is to be output as-is, without additional escaping (type of which depends on data format; backslashes for JSON).
public JsonGenerator	writeStartArray() Implements abstract tools.jackson.core.JsonGenerator.writeStartArray. Method for writing starting marker of a Array value (for JSON this is character '['; plus possible white space decoration if pretty-printing is enabled).
public JsonGenerator	writeStartArray(Object currValue) Implements abstract tools.jackson.core.JsonGenerator.writeStartArray. Method for writing start marker of an Array value, similar to `writeStartArray()`, but also specifying what is the Java object that the Array Object being written represents (if any); `null` may be passed if not known or not applicable.
public JsonGenerator	writeStartObject() Implements abstract tools.jackson.core.JsonGenerator.writeStartObject. Method for writing starting marker of an Object value (character '{'; plus possible white space decoration if pretty-printing is enabled).
public JsonGenerator	writeStartObject(Object forValue) Implements abstract tools.jackson.core.JsonGenerator.writeStartObject. Method for writing starting marker of an Object value to represent the given Java Object value.
public JsonGenerator	writeString(String text) Implements abstract tools.jackson.core.JsonGenerator.writeString. Method for outputting a String value.
public JsonGenerator	writeString(char[] text, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeString. Method for outputting a String value.
public JsonGenerator	writeUTF8String(byte[] text, int offset, int len) Implements abstract tools.jackson.core.JsonGenerator.writeUTF8String. Method similar to `writeString(String)` but that takes as its input a UTF-8 encoded String which has not been escaped using whatever escaping scheme data format requires (for JSON that is backslash-escaping for control characters and double-quotes; for other formats something else).
private JsonGenerator	writeValueEnd()

_basePath	back to summary
protected final StringBuilder _basePath

_out	back to summary
protected final Writer _out Underlying `Writer` used for output.

_outputBuffer	back to summary
protected char[] _outputBuffer Intermediate buffer in which contents are buffered before being written using `_out`.

_outputEnd	back to summary
protected final int _outputEnd Offset to index after the last valid index in `_outputBuffer`. Typically same as length of the buffer.

_outputTail	back to summary
protected int _outputTail Pointer to the next available location in `_outputBuffer`

_streamWriteContext	back to summary
protected TomlWriteContext _streamWriteContext Current context, in form we can use it (GeneratorBase has untyped reference; left as null)

_tomlFeatures	back to summary
private final int _tomlFeatures

SHORT_WRITE	back to summary
protected static final int SHORT_WRITE

TomlGenerator	back to summary
public TomlGenerator(ObjectWriteContext writeCtxt, IOContext ioCtxt, int stdFeatures, int tomlFeatures, Writer out)

Method Detail

_appendPropertyName	back to summary
private void _appendPropertyName(StringBuilder path, String name)

_closeInput	back to summary
protected void _closeInput() throws IOException Implements abstract tools.jackson.core.base.GeneratorBase._closeInput. Annotations @Override

_closeInput

back to summary

protected void _closeInput() throws IOException

Implements abstract tools.jackson.core.base.GeneratorBase._closeInput.

Annotations

@Override

_flushBuffer	back to summary
protected void _flushBuffer() throws JacksonException

_releaseBuffers	back to summary
protected void _releaseBuffers() Implements abstract tools.jackson.core.base.GeneratorBase._releaseBuffers. Doc from tools.jackson.core.base.GeneratorBase._releaseBuffers. Method called to release any buffers generator may be holding, once generator is being closed. Annotations @Override

_releaseBuffers

back to summary

protected void _releaseBuffers()

Implements abstract tools.jackson.core.base.GeneratorBase._releaseBuffers.

Doc from tools.jackson.core.base.GeneratorBase._releaseBuffers.

Method called to release any buffers generator may be holding, once generator is being closed.

Annotations

@Override

_verifyValueWrite	back to summary
protected void _verifyValueWrite(String typeMsg) throws JacksonException Implements abstract tools.jackson.core.base.GeneratorBase._verifyValueWrite. Doc from tools.jackson.core.base.GeneratorBase._verifyValueWrite. Method called before trying to write a value (scalar or structured), to verify that this is legal in current output state, as well as to output separators if and as necessary. Annotations @Override Exceptions JacksonException: if there is a problem in trying to write a value

_verifyValueWrite

back to summary

protected void _verifyValueWrite(String typeMsg) throws JacksonException

Implements abstract tools.jackson.core.base.GeneratorBase._verifyValueWrite.

Doc from tools.jackson.core.base.GeneratorBase._verifyValueWrite.

Method called before trying to write a value (scalar or structured), to verify that this is legal in current output state, as well as to output separators if and as necessary.

Annotations

@Override

Exceptions

JacksonException:: if there is a problem in trying to write a value

_verifyValueWrite	back to summary
protected void _verifyValueWrite(String typeMsg, boolean forceMaterializeKey) throws JacksonException

_writeRaw	back to summary
protected JsonGenerator _writeRaw(char c) throws JacksonException

_writeRaw	back to summary
protected JsonGenerator _writeRaw(String text) throws JacksonException

_writeRaw	back to summary
protected JsonGenerator _writeRaw(StringBuilder text) throws JacksonException

_writeRaw	back to summary
protected JsonGenerator _writeRaw(char[] text, int offset, int len) throws JacksonException

_writeRawLong	back to summary
protected void _writeRawLong(String text) throws JacksonException

_writeRawLong	back to summary
protected void _writeRawLong(StringBuilder text) throws JacksonException

_writeStringImpl	back to summary
private void _writeStringImpl(int categoryMask, String name)

_writeStringImpl	back to summary
private void _writeStringImpl(int categoryMask, char[] text, int offset, int len)

assignCurrentValue back to summary

assignCurrentValue	back to summary
public void assignCurrentValue(Object v) Implements abstract tools.jackson.core.JsonGenerator.assignCurrentValue. Doc from tools.jackson.core.JsonGenerator.assignCurrentValue. Helper method, usually equivalent to: `getOutputContext().assignCurrentValue(v);` used to assign "current value" for the current context of this generator. It is usually assigned and used by higher level data-binding functionality (instead of streaming parsers/generators) but is stored at streaming level. Annotations @Override

public void assignCurrentValue(Object v)

Implements abstract tools.jackson.core.JsonGenerator.assignCurrentValue.

Doc from tools.jackson.core.JsonGenerator.assignCurrentValue.

Helper method, usually equivalent to: getOutputContext().assignCurrentValue(v); used to assign "current value" for the current context of this generator. It is usually assigned and used by higher level data-binding functionality (instead of streaming parsers/generators) but is stored at streaming level.

Annotations

@Override

canOmitProperties back to summary

canOmitProperties	back to summary
public boolean canOmitProperties() Overrides tools.jackson.core.JsonGenerator.canOmitProperties. Doc from tools.jackson.core.JsonGenerator.canOmitProperties. Introspection method to call to check whether it is ok to omit writing of Object properties or not. Most formats do allow omission, but certain positional formats (such as CSV) require output of place holders, even if no real values are to be emitted. Note in Jackson 2.x method was `canOmitFields()`. Annotations @Override

public boolean canOmitProperties()

Overrides tools.jackson.core.JsonGenerator.canOmitProperties.

Doc from tools.jackson.core.JsonGenerator.canOmitProperties.

Introspection method to call to check whether it is ok to omit writing of Object properties or not. Most formats do allow omission, but certain positional formats (such as CSV) require output of place holders, even if no real values are to be emitted.

Note

in Jackson 2.x method was canOmitFields().

Annotations

@Override

canWriteObjectId back to summary

canWriteObjectId	back to summary
public boolean canWriteObjectId() Overrides tools.jackson.core.JsonGenerator.canWriteObjectId. Doc from tools.jackson.core.JsonGenerator.canWriteObjectId. Introspection method that may be called to see if the underlying data format supports some kind of Object Ids natively (many do not; for example, JSON doesn't). This method must be called prior to calling `writeObjectId` or `writeObjectRef`. Default implementation returns false; overridden by data formats that do support native Object Ids. Caller is expected to either use a non-native notation (explicit property or such), or fail, in case it cannot use native object ids. Annotations @Override

public boolean canWriteObjectId()

Overrides tools.jackson.core.JsonGenerator.canWriteObjectId.

Doc from tools.jackson.core.JsonGenerator.canWriteObjectId.

Introspection method that may be called to see if the underlying data format supports some kind of Object Ids natively (many do not; for example, JSON doesn't). This method must be called prior to calling writeObjectId or writeObjectRef.

Default implementation returns false; overridden by data formats that do support native Object Ids. Caller is expected to either use a non-native notation (explicit property or such), or fail, in case it cannot use native object ids.

Annotations

@Override

canWriteTypeId back to summary

canWriteTypeId	back to summary
public boolean canWriteTypeId() Overrides tools.jackson.core.JsonGenerator.canWriteTypeId. Doc from tools.jackson.core.JsonGenerator.canWriteTypeId. Introspection method that may be called to see if the underlying data format supports some kind of Type Ids natively (many do not; for example, JSON doesn't). This method must be called prior to calling `writeTypeId`. Default implementation returns false; overridden by data formats that do support native Type Ids. Caller is expected to either use a non-native notation (explicit property or such), or fail, in case it cannot use native type ids. Annotations @Override

public boolean canWriteTypeId()

Overrides tools.jackson.core.JsonGenerator.canWriteTypeId.

Doc from tools.jackson.core.JsonGenerator.canWriteTypeId.

Introspection method that may be called to see if the underlying data format supports some kind of Type Ids natively (many do not; for example, JSON doesn't). This method must be called prior to calling writeTypeId.

Default implementation returns false; overridden by data formats that do support native Type Ids. Caller is expected to either use a non-native notation (explicit property or such), or fail, in case it cannot use native type ids.

Annotations

@Override

close back to summary

close	back to summary
public void close() Overrides tools.jackson.core.base.GeneratorBase.close. Implements java.io.Closeable.close. Doc from tools.jackson.core.JsonGenerator.close. Method called to close this generator, so that no more content can be written. Whether the underlying target (stream, writer) gets closed depends on whether this generator either manages the target (i.e. is the only one with access to the target -- case if caller passes a reference to the resource such as File, but not stream); or has feature `StreamWriteFeature#AUTO_CLOSE_TARGET` enabled. If either of above is true, the target is also closed. Otherwise (not managing, feature not enabled), target is not closed. Annotations @Override

public void close()

Overrides tools.jackson.core.base.GeneratorBase.close.

Implements java.io.Closeable.close.

Doc from tools.jackson.core.JsonGenerator.close.

Method called to close this generator, so that no more content can be written.

Whether the underlying target (stream, writer) gets closed depends on whether this generator either manages the target (i.e. is the only one with access to the target -- case if caller passes a reference to the resource such as File, but not stream); or has feature StreamWriteFeature#AUTO_CLOSE_TARGET enabled. If either of above is true, the target is also closed. Otherwise (not managing, feature not enabled), target is not closed.

Annotations

@Override

currentValue back to summary

currentValue	back to summary
public Object currentValue() Implements abstract tools.jackson.core.JsonGenerator.currentValue. Doc from tools.jackson.core.JsonGenerator.currentValue. Helper method, usually equivalent to: `getOutputContext().currentValue();` Note that "current value" is NOT populated (or used) by Streaming generator; it is only used by higher-level data-binding functionality. The reason it is included here is that it can be stored and accessed hierarchically, and gets passed through data-binding. Annotations @Override

public Object currentValue()

Implements abstract tools.jackson.core.JsonGenerator.currentValue.

Doc from tools.jackson.core.JsonGenerator.currentValue.

Helper method, usually equivalent to: getOutputContext().currentValue();

Note that "current value" is NOT populated (or used) by Streaming generator; it is only used by higher-level data-binding functionality. The reason it is included here is that it can be stored and accessed hierarchically, and gets passed through data-binding.

Annotations

@Override

flush	back to summary
public void flush() Implements abstract tools.jackson.core.JsonGenerator.flush. Implements java.io.Flushable.flush. Doc from tools.jackson.core.JsonGenerator.flush. Method called to flush any buffered content to the underlying target (output stream, writer), and to flush the target itself as well. Annotations @Override

flush

back to summary

public void flush()

Implements abstract tools.jackson.core.JsonGenerator.flush.

Implements java.io.Flushable.flush.

Doc from tools.jackson.core.JsonGenerator.flush.

Method called to flush any buffered content to the underlying target (output stream, writer), and to flush the target itself as well.

Annotations

@Override

getPrettyPrinter back to summary

getPrettyPrinter	back to summary
public PrettyPrinter getPrettyPrinter() Overrides tools.jackson.core.JsonGenerator.getPrettyPrinter. Doc from tools.jackson.core.JsonGenerator.getPrettyPrinter. Accessor for object that handles pretty-printing (usually additional white space to make results more human-readable) during output. If `null`, no pretty-printing is done. Note this may be `PrettyPrinter` that `TokenStreamFactory` was configured with (if stateless), OR an instance created via `tools.jackson.core.util.Instantiatable#createInstance()` (if stateful). Default implementation returns null so pretty-printing capable generators need to override it. Annotations @Override

public PrettyPrinter getPrettyPrinter()

Overrides tools.jackson.core.JsonGenerator.getPrettyPrinter.

Doc from tools.jackson.core.JsonGenerator.getPrettyPrinter.

Accessor for object that handles pretty-printing (usually additional white space to make results more human-readable) during output. If null, no pretty-printing is done.

Note

this may be PrettyPrinter that TokenStreamFactory was configured with (if stateless), OR an instance created via tools.jackson.core.util.Instantiatable#createInstance() (if stateful).

Default implementation returns null so pretty-printing capable generators need to override it.

Annotations

@Override

streamWriteCapabilities	back to summary
public JacksonFeatureSet<StreamWriteCapability> streamWriteCapabilities() Implements abstract tools.jackson.core.JsonGenerator.streamWriteCapabilities. Doc from tools.jackson.core.JsonGenerator.streamWriteCapabilities. Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly). Annotations @Override

streamWriteCapabilities

back to summary

public JacksonFeatureSet<StreamWriteCapability> streamWriteCapabilities()

Implements abstract tools.jackson.core.JsonGenerator.streamWriteCapabilities.

Doc from tools.jackson.core.JsonGenerator.streamWriteCapabilities.

Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).

Annotations

@Override

streamWriteContext back to summary

streamWriteContext	back to summary
public TokenStreamContext streamWriteContext() Implements abstract tools.jackson.core.JsonGenerator.streamWriteContext. Doc from tools.jackson.core.JsonGenerator.streamWriteContext. Accessor for context object that provides information about low-level logical position withing output token stream. Note method was called `getOutputContext()` in Jackson 2.x Annotations @Override

public TokenStreamContext streamWriteContext()

Implements abstract tools.jackson.core.JsonGenerator.streamWriteContext.

Doc from tools.jackson.core.JsonGenerator.streamWriteContext.

Accessor for context object that provides information about low-level logical position withing output token stream.

Note

method was called getOutputContext() in Jackson 2.x

Annotations

@Override

streamWriteOutputBuffered back to summary

streamWriteOutputBuffered	back to summary
public int streamWriteOutputBuffered() Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputBuffered. Doc from tools.jackson.core.JsonGenerator.streamWriteOutputBuffered. Method for verifying amount of content that is buffered by generator but not yet flushed to the underlying target (stream, writer), in units (byte, char) that the generator implementation uses for buffering; or -1 if this information is not available. Unit used is often the same as the unit of underlying target (that is, `byte` for `java.io.OutputStream`, `char` for `java.io.Writer`), but may differ if buffering is done before encoding. Default JSON-backed implementations do use matching units. Note was named `getOutputBuffered()` in Jackson 2.x. Annotations @Override

public int streamWriteOutputBuffered()

Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputBuffered.

Doc from tools.jackson.core.JsonGenerator.streamWriteOutputBuffered.

Method for verifying amount of content that is buffered by generator but not yet flushed to the underlying target (stream, writer), in units (byte, char) that the generator implementation uses for buffering; or -1 if this information is not available. Unit used is often the same as the unit of underlying target (that is, byte for java.io.OutputStream, char for java.io.Writer), but may differ if buffering is done before encoding. Default JSON-backed implementations do use matching units.

Note

was named getOutputBuffered() in Jackson 2.x.

Annotations

@Override

streamWriteOutputTarget back to summary

streamWriteOutputTarget	back to summary
public Object streamWriteOutputTarget() Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputTarget. Doc from tools.jackson.core.JsonGenerator.streamWriteOutputTarget. Method that can be used to get access to object that is used as target for generated output; this is usually either `java.io.OutputStream` or `java.io.Writer`, depending on what generator was constructed with. Note that returned value may be null in some cases; including case where implementation does not want to exposed raw source to caller. In cases where output has been decorated, object returned here is the decorated version; this allows some level of interaction between users of generator and decorator object. In general use of this accessor should be considered as "last effort", i.e. only used if no other mechanism is applicable. Note was named `getOutputTarget()` in Jackson 2.x. Annotations @Override

public Object streamWriteOutputTarget()

Implements abstract tools.jackson.core.JsonGenerator.streamWriteOutputTarget.

Doc from tools.jackson.core.JsonGenerator.streamWriteOutputTarget.

Method that can be used to get access to object that is used as target for generated output; this is usually either java.io.OutputStream or java.io.Writer, depending on what generator was constructed with. Note that returned value may be null in some cases; including case where implementation does not want to exposed raw source to caller. In cases where output has been decorated, object returned here is the decorated version; this allows some level of interaction between users of generator and decorator object.

In general use of this accessor should be considered as "last effort", i.e. only used if no other mechanism is applicable.

Note

was named getOutputTarget() in Jackson 2.x.

Annotations

@Override

version	back to summary
public Version version() Implements abstract tools.jackson.core.JsonGenerator.version. Implements tools.jackson.core.Versioned.version. Doc from tools.jackson.core.JsonGenerator.version. Accessor for finding out version of the bundle that provided this generator instance. Annotations @Override

version

back to summary

public Version version()

Implements abstract tools.jackson.core.JsonGenerator.version.

Implements tools.jackson.core.Versioned.version.

Doc from tools.jackson.core.JsonGenerator.version.

Accessor for finding out version of the bundle that provided this generator instance.

Annotations

@Override

writeBinary back to summary

writeBinary	back to summary
public JsonGenerator writeBinary(Base64Variant b64variant, byte[] data, int offset, int len) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeBinary. Doc from tools.jackson.core.JsonGenerator.writeBinary. Method that will output given chunk of binary data as base64 encoded, as a complete String value (surrounded by double quotes). This method defaults Note because JSON Strings cannot contain unescaped linefeeds, if linefeeds are included (as per last argument), they must be escaped. This adds overhead for decoding without improving readability. Alternatively if linefeeds are not included, resulting String value may violate the requirement of base64 RFC which mandates line-length of 76 characters and use of linefeeds. However, all `JsonParser` implementations are required to accept such "long line base64"; as do typical production-level base64 decoders. Annotations @Override

public JsonGenerator writeBinary(Base64Variant b64variant, byte[] data, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeBinary.

Doc from tools.jackson.core.JsonGenerator.writeBinary.

Method that will output given chunk of binary data as base64 encoded, as a complete String value (surrounded by double quotes). This method defaults

Note

because JSON Strings cannot contain unescaped linefeeds, if linefeeds are included (as per last argument), they must be escaped. This adds overhead for decoding without improving readability. Alternatively if linefeeds are not included, resulting String value may violate the requirement of base64 RFC which mandates line-length of 76 characters and use of linefeeds. However, all JsonParser implementations are required to accept such "long line base64"; as do typical production-level base64 decoders.

Annotations

@Override

writeBoolean	back to summary
public JsonGenerator writeBoolean(boolean state) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeBoolean. Doc from tools.jackson.core.JsonGenerator.writeBoolean. Method for outputting literal JSON boolean value (one of Strings 'true' and 'false'). Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeBoolean

back to summary

public JsonGenerator writeBoolean(boolean state) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeBoolean.

Doc from tools.jackson.core.JsonGenerator.writeBoolean.

Method for outputting literal JSON boolean value (one of Strings 'true' and 'false'). Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled.

Annotations

@Override

writeCurrentPath	back to summary
private void writeCurrentPath()

writeEndArray	back to summary
public JsonGenerator writeEndArray() throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeEndArray. Doc from tools.jackson.core.JsonGenerator.writeEndArray. Method for writing closing marker of a JSON Array value (character ']'; plus possible white space decoration if pretty-printing is enabled). Marker can be written if the innermost structured type is Array. Annotations @Override

writeEndArray

back to summary

public JsonGenerator writeEndArray() throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeEndArray.

Doc from tools.jackson.core.JsonGenerator.writeEndArray.

Method for writing closing marker of a JSON Array value (character ']'; plus possible white space decoration if pretty-printing is enabled).

Marker can be written if the innermost structured type is Array.

Annotations

@Override

writeEndObject	back to summary
public JsonGenerator writeEndObject() throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeEndObject. Doc from tools.jackson.core.JsonGenerator.writeEndObject. Method for writing closing marker of an Object value (character '}'; plus possible white space decoration if pretty-printing is enabled). Marker can be written if the innermost structured type is Object, and the last written event was either a complete value, or START-OBJECT marker (see JSON specification for more details). Annotations @Override

writeEndObject

back to summary

public JsonGenerator writeEndObject() throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeEndObject.

Doc from tools.jackson.core.JsonGenerator.writeEndObject.

Method for writing closing marker of an Object value (character '}'; plus possible white space decoration if pretty-printing is enabled).

Marker can be written if the innermost structured type is Object, and the last written event was either a complete value, or START-OBJECT marker (see JSON specification for more details).

Annotations

@Override

writeName	back to summary
public JsonGenerator writeName(String name) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeName. Doc from tools.jackson.core.JsonGenerator.writeName. Method for writing an Object Property name (JSON String surrounded by double quotes: syntactically identical to a JSON String value), possibly decorated by white space if pretty-printing is enabled. Property names can only be written in Object context (check out JSON specification for details), when Object Property name is expected (property names alternate with values). Annotations @Override

writeName

back to summary

public JsonGenerator writeName(String name) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeName.

Doc from tools.jackson.core.JsonGenerator.writeName.

Method for writing an Object Property name (JSON String surrounded by double quotes: syntactically identical to a JSON String value), possibly decorated by white space if pretty-printing is enabled.

Property names can only be written in Object context (check out JSON specification for details), when Object Property name is expected (property names alternate with values).

Annotations

@Override

writeNull	back to summary
public JsonGenerator writeNull() throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeNull. Doc from tools.jackson.core.JsonGenerator.writeNull. Method for outputting literal JSON null value. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeNull

back to summary

public JsonGenerator writeNull() throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNull.

Doc from tools.jackson.core.JsonGenerator.writeNull.

Method for outputting literal JSON null value. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled.

Annotations

@Override

writeNumber	back to summary
public JsonGenerator writeNumber(short v) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Doc from tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeNumber

back to summary

public JsonGenerator writeNumber(short v) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Method for outputting given value as JSON number. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled.

Annotations

@Override

writeNumber	back to summary
public JsonGenerator writeNumber(int i) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Doc from tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeNumber

back to summary

public JsonGenerator writeNumber(int i) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Annotations

@Override

writeNumber	back to summary
public JsonGenerator writeNumber(long l) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Doc from tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeNumber

back to summary

public JsonGenerator writeNumber(long l) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Annotations

@Override

writeNumber	back to summary
public JsonGenerator writeNumber(BigInteger v) throws JacksonException Implements abstract tools.jackson.core.JsonGenerator.writeNumber. Doc from tools.jackson.core.JsonGenerator.writeNumber. Method for outputting given value as JSON number. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled. Annotations @Override

writeNumber

back to summary

public JsonGenerator writeNumber(BigInteger v) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Annotations

@Override

writeNumber

back to summary

public JsonGenerator writeNumber(double d) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Method for outputting indicate JSON numeric value. Can be called in any context where a value is expected (Array value, Object property value, root-level value). Additional white space may be added around the value if pretty-printing is enabled.

Annotations

@Override

writeNumber

back to summary

public JsonGenerator writeNumber(float f) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Annotations

@Override

writeNumber

back to summary

public JsonGenerator writeNumber(BigDecimal dec) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Annotations

@Override

writeNumber back to summary

public JsonGenerator writeNumber(String encodedValue) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeNumber.

Doc from tools.jackson.core.JsonGenerator.writeNumber.

Write method that can be used for custom numeric types that can not be (easily?) converted to "standard" Java number types. Because numbers are not surrounded by double quotes, regular writeString method cannot be used; nor writeRaw because that does not properly handle value separators needed in Array or Object contexts.

Note

because of lack of type safety, some generator implementations may not be able to implement this method. For example, if a binary JSON format is used, it may require type information for encoding; similarly for generator-wrappers around Java objects or JSON nodes. If implementation does not implement this method, it needs to throw UnsupportedOperationException.

Annotations

@Override

writePOJO back to summary

public JsonGenerator writePOJO(Object value) throws JacksonException

Overrides tools.jackson.core.base.GeneratorBase.writePOJO.

Doc from tools.jackson.core.JsonGenerator.writePOJO.

Method for writing given Java object (POJO) as tokens into stream this generator manages; serialization must be a valid JSON Value (Object, Array, null, Number, String or Boolean). This is done by delegating call to ObjectWriteContext#writeValue(JsonGenerator, Object).

Annotations

@Override

writePropertyId back to summary

public JsonGenerator writePropertyId(long id) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writePropertyId.

Doc from tools.jackson.core.JsonGenerator.writePropertyId.

Alternative to writeName(String) that may be used in cases where Object Property key is of numeric type; usually where underlying format supports such notion (some binary formats do, unlike JSON). Default implementation will simply convert id into String and call writeName(String).

Annotations

@Override

writeRaw back to summary

public JsonGenerator writeRaw(String text) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeRaw.

Doc from tools.jackson.core.JsonGenerator.writeRaw.

Method that will force generator to copy input text verbatim with no modifications (including that no escaping is done and no separators are added even if context [array, object] would otherwise require such). If such separators are desired, use writeRawValue(String) instead.

Note that not all generator implementations necessarily support such by-pass methods: those that do not will throw UnsupportedOperationException.

Annotations

@Override

writeRaw back to summary

public JsonGenerator writeRaw(String text, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeRaw.

Doc from tools.jackson.core.JsonGenerator.writeRaw.

Note that not all generator implementations necessarily support such by-pass methods: those that do not will throw UnsupportedOperationException.

Annotations

@Override

writeRaw back to summary

public JsonGenerator writeRaw(char[] text, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeRaw.

Doc from tools.jackson.core.JsonGenerator.writeRaw.

Note that not all generator implementations necessarily support such by-pass methods: those that do not will throw UnsupportedOperationException.

Annotations

@Override

writeRaw back to summary

public JsonGenerator writeRaw(char c) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeRaw.

Doc from tools.jackson.core.JsonGenerator.writeRaw.

Note that not all generator implementations necessarily support such by-pass methods: those that do not will throw UnsupportedOperationException.

Annotations

@Override

writeRaw back to summary

public JsonGenerator writeRaw(SerializableString text) throws JacksonException

Overrides tools.jackson.core.JsonGenerator.writeRaw.

Doc from tools.jackson.core.JsonGenerator.writeRaw.

Note that not all generator implementations necessarily support such by-pass methods: those that do not will throw UnsupportedOperationException.

The default implementation delegates to writeRaw(String); other backends that support raw inclusion of text are encouraged to implement it in more efficient manner (especially if they use UTF-8 encoding).

Annotations

@Override

writeRawUTF8String back to summary

public JsonGenerator writeRawUTF8String(byte[] text, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeRawUTF8String.

Doc from tools.jackson.core.JsonGenerator.writeRawUTF8String.

Method similar to writeString(String) but that takes as its input a UTF-8 encoded String that is to be output as-is, without additional escaping (type of which depends on data format; backslashes for JSON). However, quoting that data format requires (like double-quotes for JSON) will be added around the value if and as necessary.

Note that some backends may choose not to support this method: for example, if underlying destination is a java.io.Writer using this method would require UTF-8 decoding. If so, implementation may instead choose to throw a UnsupportedOperationException due to ineffectiveness of having to decode input.

Annotations

@Override

writeStartArray

back to summary

public JsonGenerator writeStartArray() throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeStartArray.

Doc from tools.jackson.core.JsonGenerator.writeStartArray.

Method for writing starting marker of a Array value (for JSON this is character '['; plus possible white space decoration if pretty-printing is enabled).

Array values can be written in any context where values are allowed: meaning everywhere except for when a property name is expected.

Annotations

@Override

writeStartArray back to summary

public JsonGenerator writeStartArray(Object currValue) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeStartArray.

Doc from tools.jackson.core.JsonGenerator.writeStartArray.

Method for writing start marker of an Array value, similar to writeStartArray(), but also specifying what is the Java object that the Array Object being written represents (if any); null may be passed if not known or not applicable. This value is accessible from context as "current value"

Annotations

@Override

writeStartObject

back to summary

public JsonGenerator writeStartObject() throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeStartObject.

Doc from tools.jackson.core.JsonGenerator.writeStartObject.

Method for writing starting marker of an Object value (character '{'; plus possible white space decoration if pretty-printing is enabled).

Object values can be written in any context where values are allowed: meaning everywhere except for when a property name is expected.

Annotations

@Override

writeStartObject

back to summary

public JsonGenerator writeStartObject(Object forValue) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeStartObject.

Doc from tools.jackson.core.JsonGenerator.writeStartObject.

Method for writing starting marker of an Object value to represent the given Java Object value. Argument is offered as metadata, but more importantly it should be assigned as the "current value" for the Object content that gets constructed and initialized.

Object values can be written in any context where values are allowed: meaning everywhere except for when a property name is expected.

Annotations

@Override

writeString

back to summary

public JsonGenerator writeString(String text) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeString.

Doc from tools.jackson.core.JsonGenerator.writeString.

Method for outputting a String value. Depending on context this means either array element, (object) property value or a stand-alone (root-level value) String; but in all cases, String will be surrounded in double quotes, and contents will be properly escaped as required by JSON specification.

Annotations

@Override

writeString

back to summary

public JsonGenerator writeString(char[] text, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeString.

Doc from tools.jackson.core.JsonGenerator.writeString.

Method for outputting a String value. Depending on context this means either array element, (object) property value or a stand alone String; but in all cases, String will be surrounded in double quotes, and contents will be properly escaped as required by JSON specification.

Annotations

@Override

writeUTF8String back to summary

public JsonGenerator writeUTF8String(byte[] text, int offset, int len) throws JacksonException

Implements abstract tools.jackson.core.JsonGenerator.writeUTF8String.

Doc from tools.jackson.core.JsonGenerator.writeUTF8String.

Method similar to writeString(String) but that takes as its input a UTF-8 encoded String which has not been escaped using whatever escaping scheme data format requires (for JSON that is backslash-escaping for control characters and double-quotes; for other formats something else). This means that textual JSON backends need to check if value needs JSON escaping, but otherwise can just be copied as is to output. Also, quoting that data format requires (like double-quotes for JSON) will be added around the value if and as necessary.

Note that some backends may choose not to support this method: for example, if underlying destination is a java.io.Writer using this method would require UTF-8 decoding. In this case generator implementation may instead choose to throw a UnsupportedOperationException due to ineffectiveness of having to decode input.

Annotations

@Override

writeValueEnd	back to summary
private JsonGenerator writeValueEnd()

pack-priv final Class TomlGenerator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail