Jackson 3.0.1 · tools.jackson.dataformat.javaprop.JavaPropsGenerator

Modifier and Type	Field and Description
protected final StringBuilder	_basePath
protected boolean	_headerChecked
protected int	_indentLength
protected final JavaPropsSchema	_schema Definition of mapping of logically structured property names into actual flattened property names.
protected JPropWriteContext	_streamWriteContext Current context, in form we can use it (GeneratorBase has untyped reference; left as null)
protected static final int	SHORT_WRITE

Access	Constructor and Description
public	JavaPropsGenerator(ObjectWriteContext writeCtxt, IOContext ioCtxt, int stdFeatures, JavaPropsSchema schema)

Method Summary

Modifier and Type	Method and Description
protected abstract void	_appendPropertyName(StringBuilder path, String name)
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 abstract void	_writeEscapedEntry(String value)
protected abstract void	_writeEscapedEntry(char[] text, int offset, int len)
protected abstract void	_writeRaw(char c)
protected abstract void	_writeRaw(String text)
protected abstract void	_writeRaw(StringBuilder text)
protected abstract void	_writeRaw(char[] text, int offset, int len)
protected abstract void	_writeUnescapedEntry(String value)
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 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 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 FormatSchema	getSchema() Overrides tools.jackson.core.JsonGenerator.getSchema. Method for accessing Schema that this generator uses, if any.
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 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').
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	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).

_basePath	back to summary
protected final StringBuilder _basePath

_headerChecked	back to summary
protected boolean _headerChecked

_indentLength	back to summary
protected int _indentLength

_schema	back to summary
protected final JavaPropsSchema _schema Definition of mapping of logically structured property names into actual flattened property names.

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

SHORT_WRITE	back to summary
protected static final int SHORT_WRITE

JavaPropsGenerator	back to summary
public JavaPropsGenerator(ObjectWriteContext writeCtxt, IOContext ioCtxt, int stdFeatures, JavaPropsSchema schema)

Method Detail

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

_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

_writeEscapedEntry	back to summary
protected abstract void _writeEscapedEntry(String value) throws JacksonException

_writeEscapedEntry	back to summary
protected abstract void _writeEscapedEntry(char[] text, int offset, int len) throws JacksonException

_writeRaw	back to summary
protected abstract void _writeRaw(char c) throws JacksonException

_writeRaw	back to summary
protected abstract void _writeRaw(String text) throws JacksonException

_writeRaw	back to summary
protected abstract void _writeRaw(StringBuilder text) throws JacksonException

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

_writeUnescapedEntry	back to summary
protected abstract void _writeUnescapedEntry(String value) throws JacksonException

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

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

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

getSchema	back to summary
public FormatSchema getSchema() Overrides tools.jackson.core.JsonGenerator.getSchema. Doc from tools.jackson.core.JsonGenerator.getSchema. Method for accessing Schema that this generator uses, if any. Default implementation returns null. Annotations @Override

getSchema

back to summary

public FormatSchema getSchema()

Overrides tools.jackson.core.JsonGenerator.getSchema.

Doc from tools.jackson.core.JsonGenerator.getSchema.

Method for accessing Schema that this generator uses, if any. Default implementation returns null.

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

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

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(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. 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. 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(BigDecimal dec) throws JacksonException

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

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

Annotations

@Override

writeNumber back to summary

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

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

writePropertyId back to summary

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

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

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

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

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

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

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

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

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

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

writeRaw	back to summary
public JsonGenerator writeRaw(SerializableString text) throws JacksonException Overrides 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`. 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

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

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

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

public abstract Class JavaPropsGenerator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail