Top Inners Fields Constructors Methods
com.fasterxml.jackson.dataformat.csv

public Class CsvGenerator

extends GeneratorBase
Class Inheritance
Imports
java.io.*, java.math.BigDecimal, .BigInteger, java.util.Arrays, com.fasterxml.jackson.core.*, com.fasterxml.jackson.core.base.GeneratorBase, com.fasterxml.jackson.core.io.CharacterEscapes, .IOContext, com.fasterxml.jackson.core.util.JacksonFeatureSet, com.fasterxml.jackson.dataformat.csv.impl.CsvEncoder, .SimpleTokenWriteContext

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static enum
CsvGenerator.Feature

Enumeration that defines all togglable features for CSV writers (if any: currently none)

Field Summary

Modifier and TypeField and Description
protected StringBuilder
_arrayContents

Accumulated contents of an array cell, if any

protected int
_arrayElements

Additional counter that indicates number of value entries in the array.

protected String
_arraySeparator

Separator to use during writing of (simple) array value, to be encoded as a single column value, if any.

protected CharacterEscapes
protected int
_formatFeatures

Bit flag composed of bits that indicate which CsvGenerator.Features are enabled.

protected boolean
_handleFirstLine

Flag that indicates that we need to write header line, if one is needed.

protected int
_nextColumnByName

Index of column that we will be getting next, based on field name call that was made.

protected CsvValueDecorator
_nextColumnDecorator

Decorator to use for decorating the column value to follow, if any; null if none.

protected CsvSchema
_schema

Definition of columns being written, if available.

protected boolean
_skipValue

Flag set when property to write is unknown, and the matching value is to be skipped quietly.

protected SimpleTokenWriteContext
_skipWithin

When skipping output (for "unknown" output), outermost write context where skipping should occur

protected final StreamWriteConstraints
protected SimpleTokenWriteContext
_tokenWriteContext

Current context, in form we can use it (GeneratorBase has untyped reference; left as null)

protected CsvEncoder
private static final CsvSchema
protected static final long
protected static final long
Inherited from com.fasterxml.jackson.core.base.GeneratorBase:
_cfgNumbersAsStrings_closed_features_ioContext_objectCodec_writeContextDERIVED_FEATURES_MASKMAX_BIG_DECIMAL_SCALESURR1_FIRSTSURR1_LASTSURR2_FIRSTSURR2_LASTWRITE_BINARYWRITE_BOOLEANWRITE_NULLWRITE_NUMBERWRITE_RAWWRITE_STRING

Constructor Summary

AccessConstructor and Description
public
CsvGenerator(IOContext ctxt, int jsonFeatures, int csvFeatures, ObjectCodec codec, Writer out, CsvSchema schema)

public
CsvGenerator(IOContext ctxt, int jsonFeatures, int csvFeatures, ObjectCodec codec, CsvEncoder csvWriter)

Method Summary

Modifier and TypeMethod and Description
protected void
protected void
_addToArray(char[] value)

protected final int
protected void
protected void
_releaseBuffers()

Implements abstract com.fasterxml.jackson.core.base.GeneratorBase._releaseBuffers.

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

protected void
_reportMappingError(String msg)

Method called when there is a problem related to mapping data (compared to a low-level generation); if so, should be surfaced as

protected final void
_verifyValueWrite(String
Additional message used for generating exception message if value output is NOT legal in current generator output state.
typeMsg
)

Implements abstract com.fasterxml.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.

private final void
public boolean
canOmitFields()

Overrides com.fasterxml.jackson.core.JsonGenerator.canOmitFields.

Introspection method to call to check whether it is ok to omit writing of Object fields or not.

public boolean
canUseSchema(FormatSchema
Schema to check
schema
)

Overrides com.fasterxml.jackson.core.JsonGenerator.canUseSchema.

Method that can be used to verify that given schema can be used with this generator (using setSchema).

public boolean
canWriteFormattedNumbers()

Overrides com.fasterxml.jackson.core.JsonGenerator.canWriteFormattedNumbers.

Introspection method to call to check whether it is possible to write numbers using writeNumber(java.lang.String) using possible custom format, or not.

public void
close()

Overrides com.fasterxml.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 CsvGenerator
configure(CsvGenerator.Feature f, boolean state)

public CsvGenerator
public CsvGenerator
protected void
finishRow()

Method called when the current row is complete; typically will flush possibly buffered column values, append linefeed and reset state appropriately.

public final void
flush()

Implements abstract com.fasterxml.jackson.core.base.GeneratorBase.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 CharacterEscapes
getCharacterEscapes()

Overrides com.fasterxml.jackson.core.JsonGenerator.getCharacterEscapes.

Method for accessing custom escapes factory uses for JsonGenerators it creates.

public int
getFormatFeatures()

Overrides com.fasterxml.jackson.core.JsonGenerator.getFormatFeatures.

Bulk access method for getting state of all FormatFeatures, format-specific on/off configuration settings.

public int
getOutputBuffered()

Overrides com.fasterxml.jackson.core.JsonGenerator.getOutputBuffered.

Note

while this method will return some information on amount of data buffered, it may be an incomplete view as some buffering happens at a higher level, as not-yet-serialized values.

public SimpleTokenWriteContext
getOutputContext()

Overrides com.fasterxml.jackson.core.base.GeneratorBase.getOutputContext.

Note

type was co-variant until Jackson 2.7; reverted back to base type in 2.8 to allow for overriding by subtypes that use custom context type.

public Object
getOutputTarget()

Overrides com.fasterxml.jackson.core.JsonGenerator.getOutputTarget.

Method that can be used to get access to object that is used as target for generated output; this is usually either OutputStream or Writer, depending on what generator was constructed with.

public JacksonFeatureSet<StreamWriteCapability>
getWriteCapabilities()

Overrides com.fasterxml.jackson.core.JsonGenerator.getWriteCapabilities.

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

public final boolean
public JsonGenerator
overrideFormatFeatures(int
Bit mask of set/clear state for features to change
values
,
int
Bit mask of features to change
mask
)

Overrides com.fasterxml.jackson.core.JsonGenerator.overrideFormatFeatures.

Bulk set method for (re)setting states of FormatFeatures, by specifying values (set / clear) along with a mask, to determine which features to change, if any.

public JsonGenerator
setCharacterEscapes(CharacterEscapes
CharacterEscapes to configure this generator to use, if any; null if none
esc
)

Overrides com.fasterxml.jackson.core.JsonGenerator.setCharacterEscapes.

Method for defining custom escapes factory uses for JsonGenerators it creates.

public CsvGenerator
setPrettyPrinter(PrettyPrinter
PrettyPrinter to assign, if any; null if none
pp
)

Overrides com.fasterxml.jackson.core.JsonGenerator.setPrettyPrinter.

No way (or need) to indent anything, so let's block any attempts.

public void
setSchema(FormatSchema
Schema to use
schema
)

Overrides com.fasterxml.jackson.core.JsonGenerator.setSchema.

Method to call to make this generator use specified schema.

public StreamWriteConstraints
streamWriteConstraints()

Overrides com.fasterxml.jackson.core.JsonGenerator.streamWriteConstraints.

Get the constraints to apply when performing streaming writes.

public CsvGenerator
useDefaultPrettyPrinter()

Overrides com.fasterxml.jackson.core.base.GeneratorBase.useDefaultPrettyPrinter.

No way (or need) to indent anything, so let's block any attempts.

public Version
version()

Overrides com.fasterxml.jackson.core.base.GeneratorBase.version.

Implements com.fasterxml.jackson.core.Versioned.version.

Implemented with standard version number detection algorithm, typically using a simple generated class, with information extracted from Maven project file during build.

public void
writeBinary(Base64Variant
Base64 variant to use: defines details such as whether padding is used (and if so, using which character); what is the maximum line length before adding linefeed, and also the underlying alphabet to use.
b64variant
,
byte[]
Buffer that contains binary data to write
data
,
int
Offset in data of the first byte of data to write
offset
,
int
Length of data to write
len
)

Implements abstract com.fasterxml.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 void
writeBoolean(boolean
Boolean value to write
state
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeBoolean.

Method for outputting literal JSON boolean value (one of Strings 'true' and 'false').

public final void
writeEndArray()

Implements abstract com.fasterxml.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 final void
writeEndObject()

Implements abstract com.fasterxml.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 final void
writeFieldName(String
Field name to write
name
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeFieldName.

Method for writing a field 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 final void
writeFieldName(SerializableString
Field name to write
name
)

Overrides com.fasterxml.jackson.core.base.GeneratorBase.writeFieldName.

Method similar to writeFieldName(String), main difference being that it may perform better as some of processing (such as quoting of certain characters, or encoding into external encoding if supported by generator) can be done just once and reused for later calls.

public void
writeNull()

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNull.

Method for outputting literal JSON null value.

public void
writeNumber(int
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting given value as JSON number.

public void
writeNumber(long
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting given value as JSON number.

public void
writeNumber(BigInteger
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting given value as JSON number.

public void
writeNumber(double
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting indicate JSON numeric value.

public void
writeNumber(float
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting indicate JSON numeric value.

public void
writeNumber(BigDecimal
Number value to write
v
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeNumber.

Method for outputting indicate JSON numeric value.

public void
writeNumber(String
Textual (possibly formatted) number representation to write
encodedValue
)

Implements abstract com.fasterxml.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 void
writeOmittedField(String
Name of the field omitted
fieldName
)

Overrides com.fasterxml.jackson.core.JsonGenerator.writeOmittedField.

Method called to indicate that a property in this position was skipped.

public void
writeRaw(String
Textual contents to include as-is in output.
text
)

Implements abstract com.fasterxml.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 void
writeRaw(String
String that has contents to include as-is in output
text
,
int
Offset within text of the first character to output
offset
,
int
Length of content (from text, starting at offset offset) to output
len
)

Implements abstract com.fasterxml.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 void
writeRaw(char[]
Buffer that has contents to include as-is in output
text
,
int
Offset within text of the first character to output
offset
,
int
Length of content (from text, starting at offset offset) to output
len
)

Implements abstract com.fasterxml.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 void
writeRaw(char
Character to included in output
c
)

Implements abstract com.fasterxml.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 void
writeRawUTF8String(byte[]
Buffer that contains String value to write
text
,
int
Offset in buffer of the first byte of String value to write
offset
,
int
Length of the String value (in characters) to write
len
)

Implements abstract com.fasterxml.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 void
writeRawValue(String
Textual contents to included in output
text
)

Overrides com.fasterxml.jackson.core.base.GeneratorBase.writeRawValue.

Method that will force generator to copy input text verbatim without any modifications, but assuming it must constitute a single legal JSON value (number, string, boolean, null, Array or List).

public void
public void
public final void
writeStartArray()

Implements abstract com.fasterxml.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 final void
writeStartObject()

Implements abstract com.fasterxml.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 void
writeString(String
Text value to write
text
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeString.

Method for outputting a String value.

public void
writeString(char[]
Buffer that contains String value to write
text
,
int
Offset in buffer of the first character of String value to write
offset
,
int
Length of the String value (in characters) to write
len
)

Implements abstract com.fasterxml.jackson.core.JsonGenerator.writeString.

Method for outputting a String value.

public final void
writeString(SerializableString
Pre-encoded String value to write
sstr
)

Overrides com.fasterxml.jackson.core.base.GeneratorBase.writeString.

Method similar to writeString(String), but that takes SerializableString which can make this potentially more efficient to call as generator may be able to reuse quoted and/or encoded representation.

public void
writeUTF8String(byte[]
Buffer that contains String value to write
text
,
int
Offset in buffer of the first byte of String value to write
offset
,
int
Length of the String value (in characters) to write
len
)

Implements abstract com.fasterxml.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).

Inherited from com.fasterxml.jackson.core.base.GeneratorBase:
_asString_checkRangeBoundsForByteArray_checkRangeBoundsForCharArray_checkRangeBoundsForString_checkStdFeatureChanges_constructDefaultPrettyPrinter_decodeSurrogatedisableenablegetCodecgetCurrentValuegetFeatureMaskisClosedisEnabledoverrideStdFeaturessetCodecsetCurrentValuesetFeatureMaskwriteBinarywriteObjectwriteRawValuewriteStartObjectwriteTree