diff --git a/docs/javadoc/2.12/allclasses-frame.html b/docs/javadoc/2.12/allclasses-frame.html index d172140f7a..f8673798b8 100644 --- a/docs/javadoc/2.12/allclasses-frame.html +++ b/docs/javadoc/2.12/allclasses-frame.html @@ -2,10 +2,10 @@ - + All Classes (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/allclasses-noframe.html b/docs/javadoc/2.12/allclasses-noframe.html index 8da3f1d107..76800af0c2 100644 --- a/docs/javadoc/2.12/allclasses-noframe.html +++ b/docs/javadoc/2.12/allclasses-noframe.html @@ -2,10 +2,10 @@ - + All Classes (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.PaddingReadBehaviour.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.PaddingReadBehaviour.html index 9934633572..3d07769f3e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.PaddingReadBehaviour.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.PaddingReadBehaviour.html @@ -2,10 +2,10 @@ - + Base64Variant.PaddingReadBehaviour (Jackson-core 2.12.0 API) - + @@ -376,6 +376,6 @@

valueOf

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.html index 11b5a51701..1c1571b6c5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variant.html @@ -2,10 +2,10 @@ - + Base64Variant (Jackson-core 2.12.0 API) - + @@ -326,7 +326,7 @@

Method Summary

int encodeBase64Chunk(int b24, byte[] buffer, - int ptr) + int outPtr)
Method that encodes given right-aligned (LSB) 24-bit value into 4 base64 bytes (ascii), stored in given result buffer.
@@ -335,7 +335,7 @@

Method Summary

int encodeBase64Chunk(int b24, char[] buffer, - int ptr) + int outPtr)
Method that encodes given right-aligned (LSB) 24-bit value into 4 base64 characters, stored in given result buffer.
@@ -558,6 +558,13 @@

Base64Variant

"Copy constructor" that can be used when the base alphabet is identical to one used by another variant except for the maximum line length (and obviously, name).
+
+
Parameters:
+
base - Variant to use for settings not specific by other parameters
+
name - Name of this variant
+
maxLineLength - Maximum length (in characters) of lines to output before + using linefeed
+
@@ -574,6 +581,15 @@

Base64Variant

"Copy constructor" that can be used when the base alphabet is identical to one used by another variant, but other details (padding, maximum line length) differ
+
+
Parameters:
+
base - Variant to use for settings not specific by other parameters
+
name - Name of this variant
+
writePadding - Whether variant will use padding when encoding
+
paddingChar - Padding character used for encoding, excepted on reading, if any
+
maxLineLength - Maximum length (in characters) of lines to output before + using linefeed
+
@@ -704,6 +720,8 @@

usesPadding

requiresPaddingOnRead

public boolean requiresPaddingOnRead()
+
Returns:
+
True if this variant requires padding on content decoded; false if not.
Since:
2.12
@@ -717,6 +735,8 @@

requiresPaddingOnRead

acceptsPaddingOnRead

public boolean acceptsPaddingOnRead()
+
Returns:
+
True if this variant accepts padding on content decoded; false if not.
Since:
2.12
@@ -751,6 +771,8 @@

paddingReadBehaviour

Returns:
Indicator on how this Base64 encoding will handle possible padding in content when reading.
+
Since:
+
2.12
@@ -789,6 +811,8 @@

getMaxLineLength

decodeBase64Char

public int decodeBase64Char(char c)
+
Parameters:
+
c - Character to decode
Returns:
6-bit decoded value, if valid character;
@@ -829,9 +853,19 @@

encodeBase64BitsAsChar

encodeBase64Chunk

public int encodeBase64Chunk(int b24,
                              char[] buffer,
-                             int ptr)
+ int outPtr)
Method that encodes given right-aligned (LSB) 24-bit value - into 4 base64 characters, stored in given result buffer.
+ into 4 base64 characters, stored in given result buffer. + Caller must ensure there is sufficient space for 4 encoded characters + at specified position. +
+
Parameters:
+
b24 - 3-byte value to encode
+
buffer - Output buffer to append characters to
+
outPtr - Starting position within buffer to append encoded characters
+
Returns:
+
Pointer in output buffer after appending 4 encoded characters
+
 @@ -860,7 +894,12 @@

encodeBase64Partial

(LSB) of int.
Parameters:
-
outputBytes - Number of encoded bytes included (either 1 or 2)
+
bits - 24-bit chunk containing 1 or 2 bytes to encode
+
outputBytes - Number of input bytes to encode (either 1 or 2)
+
buffer - Output buffer to append characters to
+
outPtr - Starting position within buffer to append encoded characters
+
Returns:
+
Pointer in output buffer after appending encoded characters (2, 3 or 4)
@@ -892,9 +931,17 @@

encodeBase64BitsAsByte

encodeBase64Chunk

public int encodeBase64Chunk(int b24,
                              byte[] buffer,
-                             int ptr)
+ int outPtr)
Method that encodes given right-aligned (LSB) 24-bit value into 4 base64 bytes (ascii), stored in given result buffer.
+
+
Parameters:
+
b24 - 3-byte value to encode
+
buffer - Output buffer to append characters (as bytes) to
+
outPtr - Starting position within buffer to append encoded characters
+
Returns:
+
Pointer in output buffer after appending 4 encoded characters
+
 @@ -913,7 +960,12 @@

encodeBase64Partial

(LSB) of int.
Parameters:
-
outputBytes - Number of encoded bytes included (either 1 or 2)
+
bits - 24-bit chunk containing 1 or 2 bytes to encode
+
outputBytes - Number of input bytes to encode (either 1 or 2)
+
buffer - Output buffer to append characters to
+
outPtr - Starting position within buffer to append encoded characters
+
Returns:
+
Pointer in output buffer after appending encoded characters (2, 3 or 4)
@@ -930,6 +982,8 @@

encode

Parameters:
input - Byte array to encode
+
Returns:
+
Base64 encoded String of encoded input bytes, not surrounded by quotes
@@ -949,6 +1003,9 @@

encode

Parameters:
input - Byte array to encode
addQuotes - Whether to surround resulting value in double quotes or not
+
Returns:
+
Base64 encoded String of encoded input bytes, possibly + surrounded by quotes (if addQuotes enabled)
@@ -968,6 +1025,9 @@

encode

Parameters:
input - Byte array to encode
addQuotes - Whether to surround resulting value in double quotes or not
+
linefeed - Linefeed to use for encoded content
+
Returns:
+
Base64 encoded String of encoded input bytes
Since:
2.10
@@ -985,7 +1045,9 @@

decode

using this variant's settings.
Parameters:
-
input -
+
input - Base64-encoded input String to decode
+
Returns:
+
Byte array of decoded contents
Throws:
IllegalArgumentException - if input is not valid base64 encoded data
Since:
@@ -1010,6 +1072,9 @@

decode

assumption is that caller will ensure it is given in proper state, and used as appropriate afterwards.
+
Parameters:
+
str - Input to decode
+
builder - Builder used for assembling decoded content
Throws:
IllegalArgumentException - if input is not valid base64 encoded data
Since:
@@ -1068,8 +1133,10 @@

_reportInvalidBase64

throws IllegalArgumentException
Parameters:
+
ch - Character to report on
bindex - Relative index within base64 character unit; between 0 and 3 (as unit has exactly 4 characters)
+
msg - Base message to use for exception
Throws:
IllegalArgumentException
@@ -1113,6 +1180,8 @@

unexpectedPaddingMessage

Helper method that will construct a message to use in exceptions for cases where input ends prematurely in place where padding is not expected.
+
Returns:
+
Exception message for indicating "unexpected padding" case
Since:
2.12
@@ -1128,6 +1197,8 @@

missingPaddingMessage

Helper method that will construct a message to use in exceptions for cases where input ends prematurely in place where padding would be expected.
+
Returns:
+
Exception message for indicating "missing padding" case
Since:
2.10
@@ -1202,6 +1273,6 @@

missingPaddingMessage

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variants.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variants.html index 5de77338c5..4dc69c1b3c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variants.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/Base64Variants.html @@ -2,10 +2,10 @@ - + Base64Variants (Jackson-core 2.12.0 API) - + @@ -354,6 +354,10 @@

getDefaultVariant

where caller does not explicitly specify the variant. We will prefer no-linefeed version because linefeeds in JSON values must be escaped, making linefeed-containing variants sub-optimal. +
+
Returns:
+
Default variant (MIME_NO_LINEFEEDS)
+
@@ -368,10 +372,12 @@

valueOf

If name does not match any of standard variant names, a IllegalArgumentException is thrown.
+
Parameters:
+
name - Name of base64 variant to return
+
Returns:
+
Standard base64 variant that matches given name
Throws:
-
IllegalArgumentException
-
Since:
-
2.1
+
IllegalArgumentException - if no standard variant with given name exists
@@ -444,6 +450,6 @@

valueOf

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatFeature.html index 78193f582a..d0be522404 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatFeature.html @@ -2,10 +2,10 @@ - + FormatFeature (Jackson-core 2.12.0 API) - + @@ -186,6 +186,8 @@

enabledByDefault

Specified by:
enabledByDefault in interface JacksonFeature
+
Returns:
+
Whether this instance is enabled by default or not
@@ -201,6 +203,8 @@

getMask

Specified by:
getMask in interface JacksonFeature
+
Returns:
+
Bit mask of this feature
@@ -215,6 +219,10 @@

enabledIn

Specified by:
enabledIn in interface JacksonFeature
+
Parameters:
+
flags - Bit field that contains a set of enabled features of this type
+
Returns:
+
True if this feature is enabled in passed bit field
@@ -287,6 +295,6 @@

enabledIn

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatSchema.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatSchema.html index d14ecb2b6e..316fd78624 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatSchema.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/FormatSchema.html @@ -2,10 +2,10 @@ - + FormatSchema (Jackson-core 2.12.0 API) - + @@ -169,6 +169,10 @@

getSchemaType

purposes, to indicate what kind of data format this schema is used for: typically it is a short name of format itself, but it can also contain additional information in cases where data format supports multiple types of schemas. +
+
Returns:
+
Logical name of schema type
+
@@ -240,6 +244,6 @@

getSchemaType

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JacksonException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JacksonException.html index 3e9c0109df..b8a4c28e45 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JacksonException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JacksonException.html @@ -2,10 +2,10 @@ - + JacksonException (Jackson-core 2.12.0 API) - + @@ -296,6 +296,11 @@

getLocation

Accuracy of location information depends on backend (format) as well as (in some cases) operation being performed. +

+
Returns:
+
Location in input or output that triggered the problem reported, if + available; null otherwise.
+
@@ -308,6 +313,11 @@

getOriginalMessage

Method that allows accessing the original "message" argument, without additional decorations (like location information) that overridden Throwable.getMessage() adds.
+
+
Returns:
+
Original, unmodified message argument used to construct + this exception instance
+
@@ -329,7 +339,7 @@

getProcessor

type-safe access.
Returns:
-
Originating processor, if available; null if not.
+
Originating processor, if available; null if not.
@@ -402,6 +412,6 @@

getProcessor

 -

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonEncoding.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonEncoding.html index 234eb7eec1..a1c5e216e5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonEncoding.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonEncoding.html @@ -2,10 +2,10 @@ - + JsonEncoding (Jackson-core 2.12.0 API) - + @@ -439,6 +439,6 @@

bits

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.Feature.html index 4901ac60cf..43d26f4540 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.Feature.html @@ -2,10 +2,10 @@ - + JsonFactory.Feature (Jackson-core 2.12.0 API) - + @@ -208,14 +208,14 @@

Method Summary

boolean enabledIn(int flags) -
Convenience method for checking whether feature is enabled in given bitmask
+
Convenience method for checking whether feature is enabled in given bitmask.
int getMask()
Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
+ that is of form 1 << N. @@ -403,6 +403,10 @@

collectDefaults

public static int collectDefaults()
Method that calculates bit set (flags) of all features that are enabled by default.
+
+
Returns:
+
Bit field of features enabled by default
+
@@ -417,6 +421,8 @@

enabledByDefault

Specified by:
enabledByDefault in interface JacksonFeature
+
Returns:
+
Whether this instance is enabled by default or not
@@ -428,10 +434,14 @@

enabledByDefault

enabledIn

public boolean enabledIn(int flags)
Description copied from interface: JacksonFeature
-
Convenience method for checking whether feature is enabled in given bitmask
+
Convenience method for checking whether feature is enabled in given bitmask.
Specified by:
enabledIn in interface JacksonFeature
+
Parameters:
+
flags - Bit field that contains a set of enabled features of this type
+
Returns:
+
True if this feature is enabled in passed bit field
@@ -444,10 +454,12 @@

getMask

public int getMask()
Description copied from interface: JacksonFeature
Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
+ that is of form 1 << N.
Specified by:
getMask in interface JacksonFeature
+
Returns:
+
Bit mask of this feature
@@ -520,6 +532,6 @@

getMask

-

Copyright © 2008–2020 FasterXML. All rights reserved.

+

Copyright © 2008–2021 FasterXML. All rights reserved.

diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.html index 9ba6ade714..4907c7c2ad 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactory.html @@ -2,10 +2,10 @@ - + JsonFactory (Jackson-core 2.12.0 API) - + @@ -884,17 +884,11 @@

Method Summary

MatchStrength -hasFormat(InputAccessor acc) -
Convenience method for trying to determine whether input via given accessor - is of format type supported by this factory.
- +hasFormat(InputAccessor acc)  protected MatchStrength -hasJSONFormat(InputAccessor acc) -
Helper method that can be called to determine if content accessed - using given accessor seems to be JSON content.
- +hasJSONFormat(InputAccessor acc)  boolean @@ -911,22 +905,27 @@

Method Summary

boolean isEnabled(JsonParser.Feature f) -
Checked whether specified parser feature is enabled.
+
Method for checking if the specified parser feature is enabled.
boolean -isEnabled(StreamReadFeature f)  +isEnabled(StreamReadFeature f) +
Method for checking if the specified stream read feature is enabled.
+ boolean -isEnabled(StreamWriteFeature f)  +isEnabled(StreamWriteFeature f) +
Check whether specified stream write feature is enabled.
+ protected Object readResolve()
Method that we need to override to actually make restoration go - through constructors etc.
+ through constructors etc: needed to allow JDK serializability of + factory instances. @@ -982,7 +981,7 @@

Method Summary

JsonFactory setOutputDecorator(OutputDecorator d)
Deprecated.  -
Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
+
Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
@@ -1298,6 +1297,9 @@

JsonFactory

ObjectCodec codec)
Constructor used when copy()ing a factory instance.
+
Parameters:
+
src - Original factory to copy settings from
+
codec - Databinding-level codec to use, if any
Since:
2.2.1
@@ -1312,6 +1314,8 @@

JsonFactory

public JsonFactory(JsonFactoryBuilder b)
Constructor used by JsonFactoryBuilder for instantiation.
+
Parameters:
+
b - Builder that contains settings to use
Since:
2.10
@@ -1330,7 +1334,7 @@

JsonFactory

implementation for json.
Parameters:
-
b - Builder that contains information
+
b - Builder that contains settings to use
bogus - Argument only needed to separate constructor signature; ignored
@@ -1353,6 +1357,8 @@

rebuild

Method that allows construction of differently configured factory, starting with settings of this factory.
+
Returns:
+
Builder instance to use
Since:
2.10
@@ -1372,6 +1378,10 @@

builder

NOTE: signature unfortunately does not expose true implementation type; this will be fixed in 3.0. +

+
Returns:
+
Builder instance to use
+
@@ -1392,6 +1402,8 @@

copy

mapping between codec, factory. Caller has to, then, explicitly set codec after making the copy.
+
Returns:
+
Copy of this factory instance
Since:
2.1
@@ -1404,10 +1416,6 @@

copy

  • _checkInvalidCopy

    protected void _checkInvalidCopy(Class<?> exp)
    -
    -
    Since:
    -
    2.1
    -
    • @@ -1418,8 +1426,14 @@

    _checkInvalidCopy

    readResolve

    protected Object readResolve()
    Method that we need to override to actually make restoration go - through constructors etc. - Also: must be overridden by sub-classes as well.
    + through constructors etc: needed to allow JDK serializability of + factory instances. +

    + Note: must be overridden by sub-classes as well. +

    +
    Returns:
    +
    Newly constructed instance
    +
    @@ -1443,6 +1457,9 @@

    requiresPropertyOrdering

    Specified by:
    requiresPropertyOrdering in class TokenStreamFactory
    +
    Returns:
    +
    Whether format supported by this factory + requires Object properties to be ordered.
    Since:
    2.3
    @@ -1466,6 +1483,9 @@

    canHandleBinaryNatively

    Specified by:
    canHandleBinaryNatively in class TokenStreamFactory
    +
    Returns:
    +
    Whether format supported by this factory + supports native binary content
    Since:
    2.3
    @@ -1487,6 +1507,9 @@

    canUseCharArrays

    to access String content by first copying it into recyclable intermediate buffer.
    +
    Returns:
    +
    Whether access to decoded textual content can be efficiently + accessed using parser method getTextCharacters().
    Since:
    2.4
    @@ -1506,6 +1529,9 @@

    canParseAsync

    Specified by:
    canParseAsync in class TokenStreamFactory
    +
    Returns:
    +
    Whether this factory supports non-blocking ("async") parsing or + not (and consequently whether createNonBlockingXxx() method(s) work)
    Since:
    2.9
    @@ -1525,6 +1551,8 @@

    getFormatReadFeatureType

    Specified by:
    getFormatReadFeatureType in class TokenStreamFactory
    +
    Returns:
    +
    Type of format-specific stream read features, if any; null if none
    @@ -1542,6 +1570,8 @@

    getFormatWriteFeatureType

    Specified by:
    getFormatWriteFeatureType in class TokenStreamFactory
    +
    Returns:
    +
    Type of format-specific stream read features, if any; null if none
    @@ -1561,8 +1591,11 @@

    canUseSchema

    Specified by:
    canUseSchema in class TokenStreamFactory
    -
    Since:
    -
    2.1
    +
    Parameters:
    +
    schema - Schema instance to check
    +
    Returns:
    +
    Whether parsers and generators constructed by this factory + can use specified format schema instance
    @@ -1581,6 +1614,8 @@

    getFormatName

    Specified by:
    getFormatName in class TokenStreamFactory
    +
    Returns:
    +
    Name of the format handled by parsers, generators this factory creates
    @@ -1592,8 +1627,6 @@

    getFormatName

    hasFormat

    public MatchStrength hasFormat(InputAccessor acc)
                         throws IOException
    -
    Convenience method for trying to determine whether input via given accessor - is of format type supported by this factory.
    Throws:
    IOException
    @@ -1630,8 +1663,6 @@

    requiresCustomCodec

    hasJSONFormat

    protected MatchStrength hasJSONFormat(InputAccessor acc)
                                throws IOException
    -
    Helper method that can be called to determine if content accessed - using given accessor seems to be JSON content.
    Throws:
    IOException
    @@ -1652,6 +1683,8 @@

    version

    Specified by:
    version in interface Versioned
    +
    Returns:
    +
    Version of the component
    @@ -1667,6 +1700,13 @@

    configure

    Deprecated. since 2.10 use TSFBuilder.configure(JsonFactory.Feature, boolean) instead
    Method for enabling or disabling specified parser feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable/disable
    +
    state - Whether to enable or disable the feature
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1680,6 +1720,12 @@

    enable

    Deprecated. since 2.10 use TSFBuilder.configure(JsonFactory.Feature, boolean) instead
    Method for enabling specified parser feature (check JsonFactory.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1693,6 +1739,12 @@

    disable

    Deprecated. since 2.10 use TSFBuilder.configure(JsonFactory.Feature, boolean) instead
    Method for disabling specified parser features (check JsonFactory.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1703,6 +1755,12 @@

    disable

    isEnabled

    public final boolean isEnabled(JsonFactory.Feature f)
    Checked whether specified parser feature is enabled.
    +
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if the specified feature is enabled
    +
    @@ -1767,6 +1825,13 @@

    configure

    boolean state)
    Method for enabling or disabling specified parser feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable/disable
    +
    state - Whether to enable or disable the feature
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1778,6 +1843,12 @@

    enable

    public JsonFactory enable(JsonParser.Feature f)
    Method for enabling specified parser feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1789,6 +1860,12 @@

    disable

    public JsonFactory disable(JsonParser.Feature f)
    Method for disabling specified parser features (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1798,10 +1875,14 @@

    disable

  • isEnabled

    public final boolean isEnabled(JsonParser.Feature f)
    -
    Checked whether specified parser feature is enabled.
    +
    Method for checking if the specified parser feature is enabled.
    Specified by:
    isEnabled in class TokenStreamFactory
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled
    • @@ -1812,7 +1893,12 @@

    isEnabled

  • isEnabled

    public final boolean isEnabled(StreamReadFeature f)
    +
    Method for checking if the specified stream read feature is enabled.
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled
    Since:
    2.10
    @@ -1827,6 +1913,10 @@

    getInputDecorator

    public InputDecorator getInputDecorator()
    Method for getting currently configured input decorator (if any; there is no default decorator).
    +
    +
    Returns:
    +
    InputDecorator configured, if any
    +
    • @@ -1839,6 +1929,12 @@

    setInputDecorator

    public     JsonFactory setInputDecorator(InputDecorator d)
    Deprecated. Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    Method for overriding currently configured input decorator
    +
    +
    Parameters:
    +
    d - Decorator to configure for this factory, if any (null if none)
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1851,6 +1947,13 @@

    configure

    boolean state)
    Method for enabling or disabling specified generator feature (check JsonGenerator.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable/disable
    +
    state - Whether to enable or disable the feature
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1862,6 +1965,12 @@

    enable

    public JsonFactory enable(JsonGenerator.Feature f)
    Method for enabling specified generator features (check JsonGenerator.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1873,6 +1982,12 @@

    disable

    public JsonFactory disable(JsonGenerator.Feature f)
    Method for disabling specified generator feature (check JsonGenerator.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1886,6 +2001,10 @@

    isEnabled

    Specified by:
    isEnabled in class TokenStreamFactory
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    Whether specified feature is enabled
    @@ -1896,7 +2015,12 @@

    isEnabled

  • isEnabled

    public final boolean isEnabled(StreamWriteFeature f)
    +
    Check whether specified stream write feature is enabled.
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    Whether specified feature is enabled
    Since:
    2.10
    @@ -1911,6 +2035,10 @@

    getCharacterEscapes

    public CharacterEscapes getCharacterEscapes()
    Method for accessing custom escapes factory uses for JsonGenerators it creates.
    +
    +
    Returns:
    +
    Configured CharacterEscapes, if any; null if none
    +
    • @@ -1922,6 +2050,12 @@

    setCharacterEscapes

    public JsonFactory setCharacterEscapes(CharacterEscapes esc)
    Method for defining custom escapes factory uses for JsonGenerators it creates.
    +
    +
    Parameters:
    +
    esc - CharaterEscapes to set (or null for "none")
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1933,6 +2067,11 @@

    getOutputDecorator

    public OutputDecorator getOutputDecorator()
    Method for getting currently configured output decorator (if any; there is no default decorator).
    +
    +
    Returns:
    +
    OutputDecorator configured for generators factory creates, if any; + null if none.
    +
    @@ -1943,8 +2082,14 @@

    getOutputDecorator

    setOutputDecorator

    @Deprecated
 public JsonFactory setOutputDecorator(OutputDecorator d)
    -
    Deprecated. Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    +
    Deprecated. Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
    Method for overriding currently configured output decorator
    +
    +
    Parameters:
    +
    d - Output decorator to use, if any
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -1960,8 +2105,8 @@

    setRootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    @@ -1973,8 +2118,8 @@

    setRootValueSeparator

    getRootValueSeparator

    public String getRootValueSeparator()
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    Root value separator configured, if any
    @@ -1990,6 +2135,12 @@

    setCodec

    with this factory (and more importantly, parsers and generators it constructs). This is needed to use data-binding methods of JsonParser and JsonGenerator instances. +
    +
    Parameters:
    +
    oc - Codec to use
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    +
    @@ -2495,9 +2646,11 @@

    createJsonParser

    Parameters:
    f - File that contains JSON content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2514,14 +2667,12 @@

    createJsonParser

    Deprecated. Since 2.2, use createParser(URL) instead.
    Method for constructing JSON parser instance to parse contents of resource reference by given URL. -

    Encoding is auto-detected from contents according to JSON specification recommended mechanism. Json specification supports only UTF-8, UTF-16 and UTF-32 as valid encodings, so auto-detection implemented only for this charsets. For other charsets use createParser(java.io.Reader). -

    Underlying input stream (needed for reading contents) will be owned (and managed, i.e. closed as need be) by @@ -2529,9 +2680,11 @@

    createJsonParser

    Parameters:
    url - URL pointing to resource that contains JSON content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2564,9 +2717,11 @@

    createJsonParser

    Parameters:
    in - InputStream to use for reading JSON content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2592,9 +2747,11 @@

    createJsonParser

    Parameters:
    r - Reader to use for reading JSON content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2611,9 +2768,13 @@

    createJsonParser

    Deprecated. Since 2.2, use createParser(byte[]) instead.
    Method for constructing parser for parsing the contents of given byte array.
    +
    Parameters:
    +
    data - Input content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2637,9 +2798,11 @@

    createJsonParser

    data - Buffer that contains data to parse
    offset - Offset of the first data byte within buffer
    len - Length of contents to parse within buffer
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2657,9 +2820,13 @@

    createJsonParser

    Method for constructing parser for parsing contents of given String.
    +
    Parameters:
    +
    content - Input content to parse
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    -
    JsonParseException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    +
    JsonParseException - if parser initialization fails due to content decoding problem
    @@ -2693,8 +2860,10 @@

    createJsonGenerator

    Parameters:
    out - OutputStream to use for writing JSON content
    enc - Character encoding to use
    +
    Returns:
    +
    Generator constructed
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (write) problem
    @@ -2720,8 +2889,10 @@

    createJsonGenerator

    Parameters:
    out - Writer to use for writing JSON content
    +
    Returns:
    +
    Generator constructed
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (write) problem
    @@ -2740,8 +2911,12 @@

    createJsonGenerator

    Note: there are formats that use fixed encoding (like most binary data formats).

    +
    Parameters:
    +
    out - OutputStream to use for writing JSON content
    +
    Returns:
    +
    Generator constructed
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (write) problem
    @@ -2763,8 +2938,13 @@

    _createParser

    interface from sub-class perspective, although not a public method available to users of factory implementations.
    +
    Parameters:
    +
    in - InputStream to use for reading content to parse
    +
    ctxt - I/O context to use for parsing
    +
    Returns:
    +
    Parser constructed
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    Since:
    2.1
    @@ -2788,8 +2968,13 @@

    _createParser

    interface from sub-class perspective, although not a public method available to users of factory implementations.
    +
    Parameters:
    +
    r - Reader to use for reading content to parse
    +
    ctxt - I/O context to use for parsing
    +
    Returns:
    +
    Actual parser to use
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    Since:
    2.1
    @@ -2810,8 +2995,16 @@

    _createParser

    Overridable factory method that actually instantiates parser using given char[] object for accessing content.
    +
    Parameters:
    +
    data - Buffer that contains content to parse
    +
    offset - Offset to the first character of data to parse
    +
    len - Number of characters within buffer to parse
    +
    ctxt - I/O context to use for parsing
    +
    recyclable - Whether input buffer is recycled by the factory
    +
    Returns:
    +
    Actual parser to use
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    Since:
    2.4
    @@ -2838,8 +3031,15 @@

    _createParser

    interface from sub-class perspective, although not a public method available to users of factory implementations.
    +
    Parameters:
    +
    data - Buffer that contains content to parse
    +
    offset - Offset to the first character of data to parse
    +
    len - Number of characters within buffer to parse
    +
    ctxt - I/O context to use for parsing
    +
    Returns:
    +
    Actual parser to use
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    @@ -2854,8 +3054,13 @@

    _createParser

    throws IOException
    Optional factory method, expected to be overridden
    +
    Parameters:
    +
    input - DataInput to use for reading content to parse
    +
    ctxt - I/O context to use for parsing
    +
    Returns:
    +
    Actual parser to use
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (read) problem
    Since:
    2.8
    @@ -2879,8 +3084,13 @@

    _createGenerator

    interface from sub-class perspective, although not a public method available to users of factory implementations.
    +
    Parameters:
    +
    out - Writer underlying writer to write generated content to
    +
    ctxt - I/O context to use
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (write) problem
    @@ -2902,8 +3112,13 @@

    _createUTF8Generator

    interface from sub-class perspective, although not a public method available to users of factory implementations.
    +
    Parameters:
    +
    out - OutputStream underlying writer to write generated content to
    +
    ctxt - I/O context to use
    +
    Returns:
    +
    This factory instance (to allow call chaining)
    Throws:
    -
    IOException
    +
    IOException - if parser initialization fails due to I/O (write) problem
    @@ -2935,8 +3150,6 @@

    _decorate

    Throws:
    IOException
    -
    Since:
    -
    2.4
    @@ -2952,8 +3165,6 @@

    _decorate

    Throws:
    IOException
    -
    Since:
    -
    2.4
    @@ -2969,8 +3180,6 @@

    _decorate

    Throws:
    IOException
    -
    Since:
    -
    2.8
    @@ -2986,8 +3195,6 @@

    _decorate

    Throws:
    IOException
    -
    Since:
    -
    2.4
    @@ -3003,8 +3210,6 @@

    _decorate

    Throws:
    IOException
    -
    Since:
    -
    2.4
    @@ -3019,6 +3224,10 @@

    _getBufferRecycler

    for parsers and generators.

    Note: only public to give access for ObjectMapper +

    +
    Returns:
    +
    Buffer recycler instance to use
    +
    @@ -3031,6 +3240,13 @@

    _createContext

    boolean resourceManaged)
    Overridable factory method that actually instantiates desired context object.
    +
    +
    Parameters:
    +
    srcRef - Source reference to use for diagnostics, exception messages
    +
    resourceManaged - Whether input buffer is managed by this factory or not
    +
    Returns:
    +
    I/O context created
    +
     @@ -3043,6 +3259,10 @@

    _createNonBlockingContext

    Overridable factory method that actually instantiates desired context object for async (non-blocking) parsing
    +
    Parameters:
    +
    srcRef - Source reference to use for diagnostics, exception messages
    +
    Returns:
    +
    I/O context created
    Since:
    2.9.7
    @@ -3117,6 +3337,6 @@

    _createNonBlockingContext

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactoryBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactoryBuilder.html index d2850c8666..06c44c1b4b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactoryBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonFactoryBuilder.html @@ -2,10 +2,10 @@ - + JsonFactoryBuilder (Jackson-core 2.12.0 API) - + @@ -563,6 +563,12 @@

    characterEscapes

    public JsonFactoryBuilder characterEscapes(CharacterEscapes esc)
    Method for defining custom escapes factory uses for JsonGenerators it creates.
    +
    +
    Parameters:
    +
    esc - CharacterEscapes to configure, if any; null if none
    +
    Returns:
    +
    This builder instance (to allow call chaining)
    +
    @@ -578,6 +584,8 @@

    rootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    +
    Returns:
    +
    This builder instance (to allow call chaining)
    @@ -594,6 +602,8 @@

    rootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    +
    Returns:
    +
    This builder instance (to allow call chaining)
    @@ -621,6 +631,8 @@

    highestNonEscapedChar

    beside from what JSON specification requires (and possible custom escape settings). Values between 1 and 127 are all taken to behave as if 127 is specified: that is, no automatic escaping is applied in ASCII range. +
    Returns:
    +
    This builder instance (to allow call chaining)
    @@ -641,6 +653,8 @@

    quoteChar

    Parameters:
    ch - Character to use for quoting field names and JSON String values.
    +
    Returns:
    +
    This builder instance (to allow call chaining)
    @@ -693,6 +707,8 @@

    build

    Specified by:
    build in class TSFBuilder<JsonFactory,JsonFactoryBuilder>
    +
    Returns:
    +
    TokenStreamFactory build based on current configuration
    @@ -765,6 +781,6 @@

    build

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerationException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerationException.html index fa50e46ccf..229d93263a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerationException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerationException.html @@ -2,10 +2,10 @@ - + JsonGenerationException (Jackson-core 2.12.0 API) - + @@ -345,10 +345,6 @@

    JsonGenerationException

    JsonGenerationException

    public JsonGenerationException(Throwable rootCause,
                                JsonGenerator g)
    -
    -
    Since:
    -
    2.7
    -
    @@ -359,10 +355,6 @@

    JsonGenerationException

    JsonGenerationException

    public JsonGenerationException(String msg,
                                JsonGenerator g)
    -
    -
    Since:
    -
    2.7
    -
    @@ -374,10 +366,6 @@

    JsonGenerationException

    public JsonGenerationException(String msg,
                                Throwable rootCause,
                                JsonGenerator g)
    -
    -
    Since:
    -
    2.7
    -
    @@ -398,6 +386,10 @@

    withGenerator

    Fluent method that may be used to assign originating JsonGenerator, to be accessed using getProcessor().
    +
    Parameters:
    +
    g - Generator to assign
    +
    Returns:
    +
    This exception instance (to allow call chaining)
    Since:
    2.7
    @@ -496,6 +488,6 @@

    getProcessor

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.Feature.html index 37f587f08b..41cd6c8d0b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.Feature.html @@ -2,10 +2,10 @@ - + JsonGenerator.Feature (Jackson-core 2.12.0 API) - + @@ -569,6 +569,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit field of the features that are enabled by default
    +
    @@ -587,10 +591,6 @@

    enabledByDefault

  • enabledIn

    public boolean enabledIn(int flags)
    -
    -
    Since:
    -
    2.3
    -
    •  @@ -671,6 +671,6 @@

    getMask

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.html index 9314362571..1766325ebe 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonGenerator.html @@ -2,10 +2,10 @@ - + JsonGenerator (Jackson-core 2.12.0 API) - + @@ -342,14 +342,14 @@

    Method Summary

    abstract JsonGenerator disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    abstract JsonGenerator enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -417,7 +417,10 @@

    Method Summary

    abstract JsonStreamContext -getOutputContext()  +getOutputContext() +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    + Object @@ -438,13 +441,13 @@

    Method Summary

    FormatSchema getSchema() -
    Method for accessing Schema that this parser uses, if any.
    +
    Method for accessing Schema that this generator uses, if any; null if none.
    JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities() -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    @@ -463,7 +466,9 @@

    Method Summary

    boolean -isEnabled(StreamWriteFeature f)  +isEnabled(StreamWriteFeature f) +
    Method for checking whether given feature is enabled.
    + JsonGenerator @@ -676,8 +681,9 @@

    Method Summary

    void writeEmbeddedObject(Object object) -
    Method that can be called on backends that support passing opaque datatypes of - non-JSON formats
    +
    Method that can be called on backends that support passing opaque native + values that some data formats support; not used with JSON backend, + more common with binary formats.
    @@ -752,7 +758,7 @@

    Method Summary

    void writeNumber(char[] encodedValueBuffer, int offset, - int length) + int len)
    Overloaded version of writeNumber(String) with same semantics but possibly more efficient operation.
    @@ -879,7 +885,7 @@

    Method Summary

    void -writeObjectRef(Object id) +writeObjectRef(Object referenced)
    Method that can be called to output references to native Object Ids.
    @@ -941,9 +947,9 @@

    Method Summary

    abstract void -writeRawUTF8String(byte[] text, +writeRawUTF8String(byte[] buffer, int offset, - int length) + int len)
    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).
    @@ -996,12 +1002,23 @@

    Method Summary

    void -writeStartArray(Object forValue)  +writeStartArray(Object forValue) +
    Method for writing start marker of an Array value, similar + to writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    + void writeStartArray(Object forValue, - int size)  + int size) +
    Method for writing start marker of an Array value, similar + to writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + writeEndArray().
    + abstract void @@ -1028,7 +1045,7 @@

    Method Summary

    abstract void -writeString(char[] text, +writeString(char[] buffer, int offset, int len)
    Method for outputting a String value.
    @@ -1079,17 +1096,23 @@

    Method Summary

    WritableTypeId -writeTypePrefix(WritableTypeId typeIdDef)  +writeTypePrefix(WritableTypeId typeIdDef) +
    Replacement method for writeTypeId(Object) which is called + regardless of whether format has native type ids.
    + WritableTypeId -writeTypeSuffix(WritableTypeId typeIdDef)  +writeTypeSuffix(WritableTypeId typeIdDef) +
    Method to call along with writeTypePrefix(com.fasterxml.jackson.core.type.WritableTypeId), but after actual value + that has type id has been completely written.
    + abstract void -writeUTF8String(byte[] text, +writeUTF8String(byte[] buffer, int offset, - int length) + int len)
    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 @@ -1212,8 +1235,10 @@

    setCodec

    use for writing Java objects as JsonContent (using method writeObject(java.lang.Object)).
    +
    Parameters:
    +
    oc - Codec to assign, if any; null if none
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1227,6 +1252,10 @@

    getCodec

    Method for accessing the object used for writing Java object as JSON content (using method writeObject(java.lang.Object)).
    +
    +
    Returns:
    +
    Codec assigned to this generator, if any; null if none
    +
    @@ -1240,6 +1269,93 @@

    version

    Specified by:
    version in interface Versioned
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    +
    + + + + + +
      +
    • +

      getOutputContext

      +
      public abstract JsonStreamContext getOutputContext()
      +
      Accessor for context object that provides information about low-level + logical position withing output token stream.
      +
      +
      Returns:
      +
      Stream output context (JsonStreamContext) associated with this generator
      +
      +
      • +
    + + + +
      +
    • +

      getOutputTarget

      +
      public Object 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. + 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.

      +
      +
      Returns:
      +
      Output target this generator was configured with
      +
      +
      • +
    + + + +
      +
    • +

      getCurrentValue

      +
      public Object getCurrentValue()
      +
      Helper method, usually equivalent to: + + getOutputContext().getCurrentValue(); + +

      + Note that "current value" is NOT populated (or used) by Streaming parser or generators; + 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.

      +
      +
      Returns:
      +
      "Current value" associated with the current context (state) of this generator
      +
      Since:
      +
      2.5
      +
      +
      • +
    + + + +
      +
    • +

      setCurrentValue

      +
      public void setCurrentValue(Object v)
      +
      Helper method, usually equivalent to: + + getOutputContext().setCurrentValue(v); +
      +
      +
      Parameters:
      +
      v - Current value to assign for the current context of this generator
      +
      Since:
      +
      2.5
    @@ -1250,11 +1366,13 @@

    version

  • enable

    public abstract JsonGenerator enable(JsonGenerator.Feature f)
    -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    +
    Parameters:
    +
    f - Feature to enable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    • @@ -1265,11 +1383,13 @@

    enable

  • disable

    public abstract JsonGenerator disable(JsonGenerator.Feature f)
    -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    +
    Parameters:
    +
    f - Feature to disable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    • @@ -1284,8 +1404,11 @@

    configure

    Method for enabling or disabling specified feature: check JsonGenerator.Feature for list of available features.
    +
    Parameters:
    +
    f - Feature to enable or disable
    +
    state - Whether to enable (true) or disable (false) feature
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1298,6 +1421,12 @@

    isEnabled

    public abstract boolean isEnabled(JsonGenerator.Feature f)
    Method for checking whether given feature is enabled. Check JsonGenerator.Feature for list of available features.
    +
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled; false if not
    +
    @@ -1307,7 +1436,13 @@

    isEnabled

  • isEnabled

    public boolean isEnabled(StreamWriteFeature f)
    +
    Method for checking whether given feature is enabled. + Check JsonGenerator.Feature for list of available features.
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled; false if not
    Since:
    2.10
    @@ -1345,7 +1480,7 @@

    setFeatureMask

    values - Bitmask that defines which JsonGenerator.Features are enabled and which disabled
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This generator, to allow call chaining
    Since:
    2.3
    @@ -1371,6 +1506,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This generator, to allow call chaining
    Since:
    2.6
    @@ -1411,6 +1548,8 @@

    overrideFormatFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This generator, to allow call chaining
    Since:
    2.6
    @@ -1447,11 +1586,11 @@

    setSchema

  • getSchema

    public FormatSchema getSchema()
    -
    Method for accessing Schema that this parser uses, if any. +
    Method for accessing Schema that this generator uses, if any; null if none. Default implementation returns null.
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    Schema in use by this generator, if any; null if none
    • @@ -1470,8 +1609,10 @@

    setPrettyPrinter

    Jackson distribution, call useDefaultPrettyPrinter() instead.
    +
    Parameters:
    +
    pp - PrettyPrinter to assign, if any; null if none
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1485,8 +1626,8 @@

    getPrettyPrinter

    Accessor for checking whether this generator has a configured PrettyPrinter; returns it if so, null if none configured.
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    PrettyPrinter configured for this generator, if any; null if none
    @@ -1502,7 +1643,7 @@

    useDefaultPrettyPrinter

    (DefaultPrettyPrinter).
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1533,6 +1674,8 @@

    setHighestNonEscapedChar

    charCode - Either -1 to indicate that no additional escaping is to be done; or highest code point not to escape (meaning higher ones will be), if positive value.
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1566,6 +1709,10 @@

    getCharacterEscapes

    public CharacterEscapes getCharacterEscapes()
    Method for accessing custom escapes factory uses for JsonGenerators it creates.
    +
    +
    Returns:
    +
    CharacterEscapes configured for this generator, if any; null if none
    +
    @@ -1579,6 +1726,12 @@

    setCharacterEscapes

    it creates.

    Default implementation does nothing and simply returns this instance.

    +
    +
    Parameters:
    +
    esc - CharacterEscapes to configure this generator to use, if any; null if none
    +
    Returns:
    +
    This generator, to allow call chaining
    +
    @@ -1596,33 +1749,11 @@

    setRootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    This generator, to allow call chaining
    -     - - - @@ -1650,45 +1781,6 @@

    getOutputBuffered

    - - - - - - - - @@ -1724,6 +1816,10 @@

    canWriteObjectId

    use a non-native notation (explicit property or such), or fail, in case it can not use native object ids.
    +
    Returns:
    +
    True if this generator is capable of writing "native" Object Ids + (which is typically determined by capabilities of the underlying format), + false if not
    Since:
    2.3
    @@ -1747,6 +1843,10 @@

    canWriteTypeId

    use a non-native notation (explicit property or such), or fail, in case it can not use native type ids.
    +
    Returns:
    +
    True if this generator is capable of writing "native" Type Ids + (which is typically determined by capabilities of the underlying format), + false if not
    Since:
    2.3
    @@ -1766,6 +1866,11 @@

    canWriteBinaryNatively

    Default implementation returns false; overridden by data formats that do support native binary content.
    +
    Returns:
    +
    True if this generator is capable of writing "raw" Binary + Content + (this is typically determined by capabilities of the underlying format); + false if not
    Since:
    2.3
    @@ -1783,6 +1888,9 @@

    canOmitFields

    but certain positional formats (such as CSV) require output of placeholders, even if no real values are to be emitted.
    +
    Returns:
    +
    True if this generator is allowed to only write values + of some Object fields and omit the rest; false if not
    Since:
    2.3
    @@ -1804,6 +1912,11 @@

    canWriteFormattedNumbers

    formatting of numbers may be applied by higher-level code (databinding) or not.
    +
    Returns:
    +
    True if this generator is capable of writing "formatted" + numbers (and if so, need to be passed using + writeNumber(String), that is, passed as String); + false if not
    Since:
    2.8
    @@ -1816,11 +1929,11 @@

    canWriteFormattedNumbers

  • getWriteCapabilities

    public JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities()
    -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    Returns:
    -
    Set of read capabilities for content to read via this parser
    +
    Set of write capabilities for content written using this generator
    Since:
    2.12
    @@ -1843,7 +1956,8 @@

    writeStartArray

    a field name is expected.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    • @@ -1858,7 +1972,8 @@

    writeStartArray

    throws IOException
    Deprecated. Since 2.12 Use writeStartArray(Object, int) instead
    Method for writing start marker of an Array value, similar - to writeStartArray(), but also specifying how many + to writeStartArray(), + but also specifying how many elements will be written for the array before calling writeEndArray().

    @@ -1868,9 +1983,10 @@

    writeStartArray

    size - Number of elements this array will have: actual number of values written (before matching call to writeEndArray() MUST match; generator MAY verify - this is the case.
    + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.4
    @@ -1884,9 +2000,16 @@

    writeStartArray

    writeStartArray

    public void writeStartArray(Object forValue)
                      throws IOException
    +
    Method for writing start marker of an Array value, similar + to writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.10
    @@ -1901,9 +2024,21 @@

    writeStartArray

    public void writeStartArray(Object forValue,
                             int size)
                      throws IOException
    +
    Method for writing start marker of an Array value, similar + to writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + writeEndArray().
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    +
    size - Number of elements this Array will have: actual + number of values written (before matching call to + writeEndArray() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.10
    @@ -1925,7 +2060,8 @@

    writeEndArray

    is Array.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1946,7 +2082,8 @@

    writeStartObject

    a field name is expected.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1968,8 +2105,11 @@

    writeStartObject

    are allowed: meaning everywhere except for when a field name is expected.
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -1997,8 +2137,15 @@

    writeStartObject

    are allowed: meaning everywhere except for when a field name is expected.
    -
    Throws:
    -
    IOException
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    +
    size - Number of key/value pairs this Object will have: actual + number of entries written (before matching call to + writeEndObject() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    +
    Throws:
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.10
    @@ -2022,7 +2169,8 @@

    writeEndObject

    for more details).
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2042,8 +2190,11 @@

    writeFieldName

    JSON specification for details), when field name is expected (field names alternate with values).
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2065,8 +2216,11 @@

    writeFieldName

    serialized String; implementations are strongly encouraged to make use of more efficient methods argument object has.
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2085,8 +2239,11 @@

    writeFieldId

    Default implementation will simply convert id into String and call writeFieldName(String).
    +
    Parameters:
    +
    id - Field id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -2111,7 +2268,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -2136,7 +2294,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -2161,7 +2320,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -2186,7 +2346,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.11
    @@ -2206,8 +2367,11 @@

    writeString

    surrounded in double quotes, and contents will be properly escaped as required by JSON specification.
    +
    Parameters:
    +
    text - Text value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2225,12 +2389,21 @@

    writeString

    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. - If the reader is null, then write a null. - If len is < 0, then write all contents of the reader. - Otherwise, write only len characters. + If len is < 0, then write all contents of the reader. + Otherwise, write only len characters. +

    + Note: actual length of content available may exceed len but + can not be less than it: if not enough content available, a + JsonGenerationException will be thrown.

    +
    Parameters:
    +
    reader - Reader to use for reading Text value to write
    +
    len - Maximum Length of Text value to read (in chars, non-negative) + if known; -1 to indicate "read and write it all"
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer; or if length (len) is specified but + reader does not provide enough content
    Since:
    2.9
    @@ -2242,7 +2415,7 @@

    writeString

    @@ -2274,8 +2452,11 @@

    writeString

    sub-classes should override it with more efficient implementation if possible.
    +
    Parameters:
    +
    text - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2285,9 +2466,9 @@

    writeString

    @@ -2313,9 +2499,9 @@

    writeRawUTF8String

    @@ -2358,8 +2549,11 @@

    writeRaw

    such by-pass methods: those that do not will throw UnsupportedOperationException.
    +
    Parameters:
    +
    text - Textual contents to include as-is in output.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2384,8 +2578,13 @@

    writeRaw

    such by-pass methods: those that do not will throw UnsupportedOperationException.
    +
    Parameters:
    +
    text - String that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2410,8 +2609,13 @@

    writeRaw

    such by-pass methods: those that do not will throw UnsupportedOperationException.
    +
    Parameters:
    +
    text - Buffer that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2434,8 +2638,11 @@

    writeRaw

    such by-pass methods: those that do not will throw UnsupportedOperationException.
    +
    Parameters:
    +
    c - Character to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2463,10 +2670,11 @@

    writeRaw

    to implement it in more efficient manner (especially if they use UTF-8 encoding).
    +
    Parameters:
    +
    raw - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    -
    Since:
    -
    2.1
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2485,8 +2693,11 @@

    writeRawValue

    are added if and as needed (comma or colon), and generator state updated to reflect this.
    +
    Parameters:
    +
    text - Textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2534,8 +2745,11 @@

    writeRawValue

    efficient as it may be able to use pre-encoded content (similar to writeRaw(SerializableString).
    +
    Parameters:
    +
    raw - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.5
    @@ -2572,8 +2786,12 @@

    writeBinary

    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. +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2591,8 +2809,13 @@

    writeBinary

    but default to using the Jackson default Base64 variant (which is Base64Variants.MIME_NO_LINEFEEDS).
    +
    Parameters:
    +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2609,8 +2832,11 @@

    writeBinary

    (which is Base64Variants.MIME_NO_LINEFEEDS). Also assumes that whole byte array is to be output.
    +
    Parameters:
    +
    data - Buffer that contains binary data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2635,8 +2861,11 @@

    writeBinary

    need not support cases where length is not known in advance; this depends on underlying data format: JSON output does NOT require length, other formats may +
    Returns:
    +
    Number of bytes actually written
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2669,9 +2898,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    -
    Since:
    -
    2.1
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2692,7 +2920,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.2
    @@ -2715,7 +2944,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2736,7 +2966,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2757,7 +2988,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2778,7 +3010,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2799,7 +3032,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2820,7 +3054,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2847,12 +3082,15 @@

    writeNumber

    If implementation does not implement this method, it needs to throw UnsupportedOperationException.
    +
    Parameters:
    +
    encodedValue - Textual (possibly format) number representation to write
    Throws:
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    UnsupportedOperationException - If underlying data format does not support numbers serialized textually AND if generator is not allowed to just output a String instead (Schema-based formats may require actual number, for example)
    -
    IOException
    @@ -2864,13 +3102,18 @@

    writeNumber

    writeNumber

    public void writeNumber(char[] encodedValueBuffer,
                         int offset,
-                        int length)
+                        int len)
                  throws IOException
    Overloaded version of writeNumber(String) with same semantics but possibly more efficient operation.
    +
    Parameters:
    +
    encodedValueBuffer - Buffer that contains the textual number representation to write
    +
    offset - Offset of the first character of value to write
    +
    len - Length of the value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.11
    @@ -2891,8 +3134,11 @@

    writeBoolean

    Additional white space may be added around the value if pretty-printing is enabled.
    +
    Parameters:
    +
    state - Boolean value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2911,7 +3157,8 @@

    writeNull

    if pretty-printing is enabled.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2923,11 +3170,18 @@

    writeNull

    writeEmbeddedObject

    public void writeEmbeddedObject(Object object)
                          throws IOException
    -
    Method that can be called on backends that support passing opaque datatypes of - non-JSON formats
    +
    Method that can be called on backends that support passing opaque native + values that some data formats support; not used with JSON backend, + more common with binary formats. +

    + NOTE: this is NOT the method to call for serializing regular POJOs, + see writeObject(java.lang.Object) instead.

    +
    Parameters:
    +
    object - Native format-specific value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.8
    @@ -2949,8 +3203,13 @@

    writeObjectId

    If output is not allowed by the data format in this position, a JsonGenerationException will be thrown.
    +
    Parameters:
    +
    id - Native Object Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Object ID output is not allowed + (either at all, or specifically in this position in output)
    Since:
    2.3
    @@ -2962,7 +3221,7 @@

    writeObjectId

    @@ -2993,8 +3257,13 @@

    writeTypeId

    If output is not allowed by the data format in this position, a JsonGenerationException will be thrown.
    +
    Parameters:
    +
    id - Native Type Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Type ID output is not allowed + (either at all, or specifically in this position in output)
    Since:
    2.3
    @@ -3008,9 +3277,29 @@

    writeTypeId

    writeTypePrefix

    public WritableTypeId writeTypePrefix(WritableTypeId typeIdDef)
                                throws IOException
    +
    Replacement method for writeTypeId(Object) which is called + regardless of whether format has native type ids. If it does have native + type ids, those are to be used (if configuration allows this), if not, + structural type id inclusion is to be used. For JSON, for example, no + native type ids exist and structural inclusion is always used. +

    + NOTE: databind may choose to skip calling this method for some special cases + (and instead included type id via regular write methods and/or writeTypeId(java.lang.Object) + -- this is discouraged, but not illegal, and may be necessary as a work-around + in some cases.

    +
    Parameters:
    +
    typeIdDef - Full Type Id definition
    +
    Returns:
    +
    WritableTypeId for caller to retain and pass to matching + writeTypeSuffix(com.fasterxml.jackson.core.type.WritableTypeId) call
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Type ID output is not allowed + (either at all, or specifically in this position in output)
    +
    Since:
    +
    2.9
    @@ -3022,9 +3311,22 @@

    writeTypePrefix

    writeTypeSuffix

    public WritableTypeId writeTypeSuffix(WritableTypeId typeIdDef)
                                throws IOException
    +
    Method to call along with writeTypePrefix(com.fasterxml.jackson.core.type.WritableTypeId), but after actual value + that has type id has been completely written. This allows post-processing + for some cases (for example if the actual Type Id is written at the END of + the value, not before or at the beginning).
    +
    Parameters:
    +
    typeIdDef - Value returned by the earlier matching call to writeTypePrefix(WritableTypeId)
    +
    Returns:
    +
    Argument typeIdDef, possibly modified
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Type ID output is not allowed + (either at all, or specifically in this position in output)
    +
    Since:
    +
    2.9
    @@ -3046,8 +3348,11 @@

    writeObject

    set to non-null value; for generators created by a mapping factory this is the case, for others not.
    +
    Parameters:
    +
    pojo - General POJO value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3066,8 +3371,11 @@

    writeTree

    for convenience and to make code more explicit in cases where it deals specifically with trees.
    +
    Parameters:
    +
    rootNode - TreeNode to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3088,8 +3396,12 @@

    writeBinaryField

    writeBinary(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    data - Binary data for the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3109,8 +3421,12 @@

    writeBooleanField

    writeBoolean(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Boolean value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3129,8 +3445,11 @@

    writeNullField

    writeNull();
    +
    Parameters:
    +
    fieldName - Name of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3148,12 +3467,14 @@

    writeStringField

       writeFieldName(fieldName);
   writeString(value);
-
    -

    - Note: many performance-sensitive implementations override this method +

    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - String value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3173,8 +3494,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.11
    @@ -3196,8 +3521,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3217,8 +3546,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3238,8 +3571,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.11
    @@ -3261,8 +3598,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3282,8 +3623,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3304,8 +3649,12 @@

    writeNumberField

    writeNumber(value);
    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    value - Numeric value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3329,8 +3678,11 @@

    writeArrayFieldStart

    (by calling {#link #writeEndArray}) after writing all values of the value Array.
    +
    Parameters:
    +
    fieldName - Name of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3354,8 +3706,11 @@

    writeObjectFieldStart

    (by calling {#link #writeEndObject}) after writing all entries of the value Object.
    +
    Parameters:
    +
    fieldName - Name of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3374,10 +3729,17 @@

    writeObjectField

       writeFieldName(fieldName);
   writeObject(pojo);
-
    + +

    + NOTE: actual serialization of POJO value requires assigned ObjectCodec + and will delegate to that (usually ObjectMapper of databind layer)

    +
    Parameters:
    +
    fieldName - Name of the field to write
    +
    pojo - POJO value of the field to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3395,8 +3757,11 @@

    writeOmittedField

    Default implementation does nothing.

    +
    Parameters:
    +
    fieldName - Name of the field omitted
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    Since:
    2.3
    @@ -3419,8 +3784,11 @@

    copyCurrentEvent

    parser, although it may cause parser to internally process more data (if it lazy loads contents of value events, for example)
    +
    Parameters:
    +
    p - Parser that points to event (token) to copy
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3461,8 +3829,11 @@

    copyCurrentStructure

    the event parser already pointed to (if there were no enclosed events), or the last enclosed event copied.
    +
    Parameters:
    +
    p - Parser that points to the value to copy
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3477,22 +3848,6 @@

    _copyCurrentContents

    Throws:
    IOException
    -
    Since:
    -
    2.10
    -
    - - - - - - @@ -3511,7 +3866,8 @@

    flush

    Specified by:
    flush in interface Flushable
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3524,6 +3880,10 @@

    isClosed

    public abstract boolean isClosed()
    Method that can be called to determine whether this generator is closed or not. If it is closed, no more output can be done.
    +
    +
    Returns:
    +
    True if this generator instance has been closed
    +
    @@ -3550,7 +3910,7 @@

    close

    Specified by:
    close in interface AutoCloseable
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -3568,8 +3928,10 @@

    _reportError

    Note that sub-classes may override this method to add more detail or use a JsonGenerationException sub-class.
    +
    Parameters:
    +
    msg - Exception message to use
    Throws:
    -
    JsonGenerationException
    +
    JsonGenerationException - constructed
    @@ -3600,10 +3962,6 @@

    _verifyOffsets

    protected final void _verifyOffsets(int arrayLength,
                                     int offset,
                                     int length)
    -
    -
    Since:
    -
    2.8
    -
    @@ -3619,9 +3977,10 @@

    _writeSimpleObject

    only simple basic types are to be coerced as necessary.
    Parameters:
    -
    value - Non-null value to write
    +
    value - Value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3694,6 +4053,6 @@

    _writeSimpleObject

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonLocation.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonLocation.html index eddc39d082..b7854bdcc8 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonLocation.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonLocation.html @@ -2,10 +2,10 @@ - + JsonLocation (Jackson-core 2.12.0 API) - + @@ -405,6 +405,10 @@

    getSourceRef

    that File. Will return null if no such reference is available, for example when InputStream was used to construct the parser instance. +
    +
    Returns:
    +
    Source reference this location was constructed with, if any; null if none
    +
    @@ -474,6 +478,8 @@

    sourceDescription

    NOTE: not added as a "getter" to prevent it from getting serialized.

    +
    Returns:
    +
    Description of the source reference (see getSourceRef()
    Since:
    2.9
    @@ -596,6 +602,6 @@

    _appendSourceDesc

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParseException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParseException.html index d6614a0e2a..5f1827cbb9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParseException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParseException.html @@ -2,10 +2,10 @@ - + JsonParseException (Jackson-core 2.12.0 API) - + @@ -285,7 +285,7 @@

    Method Summary

    JsonParseException -withRequestPayload(RequestPayload p) +withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -363,6 +363,9 @@

    JsonParseException

    sets processor (accessible via getProcessor()) to specified parser.
    +
    Parameters:
    +
    p - Parser in use when encountering issue reported
    +
    msg - Base exception message to use
    Since:
    2.7
    @@ -377,10 +380,6 @@

    JsonParseException

    public JsonParseException(JsonParser p,
                           String msg,
                           Throwable root)
    -
    -
    Since:
    -
    2.7
    -
    @@ -392,10 +391,6 @@

    JsonParseException

    public JsonParseException(JsonParser p,
                           String msg,
                           JsonLocation loc)
    -
    -
    Since:
    -
    2.7
    -
    @@ -408,10 +403,6 @@

    JsonParseException

    String msg, JsonLocation loc, Throwable root) -
    -
    Since:
    -
    2.7
    -
    @@ -436,6 +427,10 @@

    withParser

    Specified by:
    withParser in class StreamReadException
    +
    Parameters:
    +
    p - Parser instance to assign to this exception
    +
    Returns:
    +
    This exception instance to allow call chaining
    Since:
    2.7
    @@ -447,7 +442,7 @@

    withParser

    @@ -604,6 +606,6 @@

    getMessage

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.Feature.html index 800a183824..c5a4ed9f40 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.Feature.html @@ -2,10 +2,10 @@ - + JsonParser.Feature (Jackson-core 2.12.0 API) - + @@ -722,6 +722,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit mask of all features that are enabled by default
    +
    @@ -740,10 +744,6 @@

    enabledByDefault

  • enabledIn

    public boolean enabledIn(int flags)
    -
    -
    Since:
    -
    2.3
    -
    •  @@ -824,6 +824,6 @@

    getMask

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.NumberType.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.NumberType.html index 7f3930ac95..6c3faa72e4 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.NumberType.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.NumberType.html @@ -2,10 +2,10 @@ - + JsonParser.NumberType (Jackson-core 2.12.0 API) - + @@ -392,6 +392,6 @@

    valueOf

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.html index 689a28789c..24cb31c806 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonParser.html @@ -2,10 +2,10 @@ - + JsonParser (Jackson-core 2.12.0 API) - + @@ -309,7 +309,13 @@

    Method Summary

    String -currentName()  +currentName() +
    Method that can be called to get the name associated with + the current token: for JsonToken.FIELD_NAMEs it will + be the same as what getText() returns; + for field values it will be preceding field name; + and for others (array values, root-level values) null.
    + JsonToken @@ -378,7 +384,8 @@

    Method Summary

    getBooleanValue()
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE.
    + JsonToken.VALUE_FALSE, to return matching boolean + value. @@ -406,11 +413,7 @@

    Method Summary

    abstract String getCurrentName() -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See currentName().
    @@ -670,7 +673,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value. @@ -959,7 +962,7 @@

    Method Summary

    abstract void -setCodec(ObjectCodec c) +setCodec(ObjectCodec oc)
    Setter that allows defining ObjectCodec associated with this parser, if any.
    @@ -1129,6 +1132,10 @@

    getCodec

    Accessor for ObjectCodec associated with this parser, if any. Codec is used by readValueAs(Class) method (and its variants).
    +
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    +
    @@ -1137,10 +1144,14 @@

    getCodec

     @@ -1163,6 +1174,10 @@

    getInputSource

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

    +
    Returns:
    +
    Input source this parser was configured with
    +
     @@ -1182,6 +1197,8 @@

    getCurrentValue

    The reason it is included here is that it can be stored and accessed hierarchically, and gets passed through data-binding.
    +
    Returns:
    +
    "Current value" associated with the current input context (state) of this parser
    Since:
    2.5
    @@ -1199,6 +1216,8 @@

    setCurrentValue

    getParsingContext().setCurrentValue(v);
    +
    Parameters:
    +
    v - Current value to assign for the current input context of this parser
    Since:
    2.5
    @@ -1213,6 +1232,8 @@

    setRequestPayloadOnError

    public void setRequestPayloadOnError(RequestPayload payload)
    Sets the payload to be passed if JsonParseException is thrown.
    +
    Parameters:
    +
    payload - Payload to pass
    Since:
    2.8
    @@ -1228,6 +1249,9 @@

    setRequestPayloadOnError

    String charset)
    Sets the byte[] request payload and the charset
    +
    Parameters:
    +
    payload - Payload to pass
    +
    charset - Character encoding for (lazily) decoding payload
    Since:
    2.8
    @@ -1242,6 +1266,8 @@

    setRequestPayloadOnError

    public void setRequestPayloadOnError(String payload)
    Sets the String request payload
    +
    Parameters:
    +
    payload - Payload to pass
    Since:
    2.8
    @@ -1280,6 +1306,8 @@

    getSchema

    Method for accessing Schema that this parser uses, if any. Default implementation returns null.
    +
    Returns:
    +
    Schema in use by this parser, if any; null if none
    Since:
    2.1
    @@ -1316,8 +1344,7 @@

    requiresCustomCodec

    with JsonGenerator).
    Returns:
    -
    True if custom codec is needed with parsers and - generators created by this factory; false if a general +
    True if format-specific codec is needed with this parser; false if a general ObjectCodec is enough
    Since:
    2.1
    @@ -1341,6 +1368,8 @@

    canParseAsync

    for feeding input; otherwise (false returned) input is read by blocking
    +
    Returns:
    +
    True if this is a non-blocking ("asynchronous") parser
    Since:
    2.9
    @@ -1357,6 +1386,8 @@

    getNonBlockingInputFeeder

    non-blocking, aka asynchronous access); or null for parsers that use blocking I/O.
    +
    Returns:
    +
    Input feeder to use with non-blocking (async) parsing
    Since:
    2.9
    @@ -1391,6 +1422,9 @@

    version

    Specified by:
    version in interface Versioned
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -1421,7 +1455,7 @@

    close

    Specified by:
    close in interface AutoCloseable
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -1438,6 +1472,10 @@

    isClosed

    stream may be closed). Closing may be due to an explicit call to close() or because parser has encountered end of input. +
    +
    Returns:
    +
    True if this parser instance has been closed
    +
    @@ -1455,6 +1493,10 @@

    getParsingContext

    array or object (for highlighting purposes, or error reporting). Contexts can also be used for simple xpath-like matching of input, if so desired. +
    +
    Returns:
    +
    Stream input context (JsonStreamContext) associated with this parser
    +
    @@ -1466,7 +1508,17 @@

    getTokenLocation

    public abstract JsonLocation getTokenLocation()
    Method that return the starting location of the current token; that is, position of the first character from input - that starts the current token.
    + that starts the current token. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library) +

    +
    Returns:
    +
    Starting location of the token parser currently points to
    +
    @@ -1477,7 +1529,18 @@

    getTokenLocation

    getCurrentLocation

    public abstract JsonLocation getCurrentLocation()
    Method that returns location of the last processed character; - usually for error reporting purposes.
    + usually for error reporting purposes. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + report specific boundary locations (start or end locations of tokens) + and others only return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library) +

    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    +
    @@ -1495,6 +1558,8 @@

    releaseBuffered

    if underlying input is byte-based it can released, if not (char-based) it can not.
    +
    Parameters:
    +
    out - OutputStream to which buffered, undecoded content is written to
    Returns:
    -1 if the underlying content source is not byte based (that is, input can not be sent to OutputStream; @@ -1520,6 +1585,8 @@

    releaseBuffered

    if underlying input is char-based it can released, if not (byte-based) it can not.
    +
    Parameters:
    +
    w - Writer to which buffered but unprocessed content is written to
    Returns:
    -1 if the underlying content source is not char-based (that is, input can not be sent to Writer; @@ -1538,6 +1605,12 @@

    enable

    public JsonParser enable(JsonParser.Feature f)
    Method for enabling specified parser feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This parser, to allow call chaining
    +
    @@ -1549,6 +1622,12 @@

    disable

    public JsonParser disable(JsonParser.Feature f)
    Method for disabling specified feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This parser, to allow call chaining
    +
    @@ -1561,6 +1640,13 @@

    configure

    boolean state)
    Method for enabling or disabling specified feature (check JsonParser.Feature for list of features)
    +
    +
    Parameters:
    +
    f - Feature to enable or disable
    +
    state - Whether to enable feature (true) or disable (false)
    +
    Returns:
    +
    This parser, to allow call chaining
    +
    @@ -1571,6 +1657,12 @@

    configure

    isEnabled

    public boolean isEnabled(JsonParser.Feature f)
    Method for checking whether specified JsonParser.Feature is enabled.
    +
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if feature is enabled; false otherwise
    +
    @@ -1582,6 +1674,10 @@

    isEnabled

    public boolean isEnabled(StreamReadFeature f)
    Method for checking whether specified JsonParser.Feature is enabled.
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if feature is enabled; false otherwise
    Since:
    2.10
    @@ -1614,8 +1710,10 @@

    setFeatureMask

    Deprecated. Since 2.7, use overrideStdFeatures(int, int) instead
    Bulk set method for (re)setting states of all standard JsonParser.Features
    +
    Parameters:
    +
    mask - Bit mask that defines set of features to enable
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This parser, to allow call chaining
    Since:
    2.3
    @@ -1641,6 +1739,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This parser, to allow call chaining
    Since:
    2.6
    @@ -1676,11 +1776,13 @@

    overrideFormatFeatures

    which features to change, if any.

    Default implementation will simply throw an exception to indicate that - the generator implementation does not support any FormatFeatures. + the parser implementation does not support any FormatFeatures.

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This parser, to allow call chaining
    Since:
    2.6
    @@ -1703,7 +1805,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1732,7 +1835,8 @@

    nextValue

    parsers, JsonToken.NOT_AVAILABLE if no tokens were available yet)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1757,8 +1861,12 @@

    nextFieldName

    Parameters:
    str - Property name to compare next token to (if next token is JsonToken.FIELD_NAME)
    +
    Returns:
    +
    True if parser advanced to JsonToken.FIELD_NAME with + specified name; false otherwise (different token or non-matching name)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1774,8 +1882,12 @@

    nextFieldName

    verifies whether it is JsonToken.FIELD_NAME; if it is, returns same as getCurrentName(), otherwise null.
    +
    Returns:
    +
    Name of the the JsonToken.FIELD_NAME parser advanced to, if any; + null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.5
    @@ -1799,8 +1911,12 @@

    nextTextValue

    but may be faster for parser to process, and can therefore be used if caller expects to get a String value next from input.
    +
    Returns:
    +
    Text value of the JsonToken.VALUE_STRING token parser advanced + to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1820,10 +1936,19 @@

    nextIntValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getIntValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get an int value next from input. + expects to get an int value next from input. +

    + NOTE: value checks are performed similar to getIntValue()

    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    Integer (int) value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java int
    @@ -1843,10 +1968,19 @@

    nextLongValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getLongValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get a long value next from input. + expects to get a long value next from input. +

    + NOTE: value checks are performed similar to getLongValue()

    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    long value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java long
    @@ -1871,8 +2005,12 @@

    nextBooleanValue

    but may be faster for parser to process, and can therefore be used if caller expects to get a Boolean value next from input.
    +
    Returns:
    +
    Boolean value of the JsonToken.VALUE_TRUE or JsonToken.VALUE_FALSE + token parser advanced to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1897,8 +2035,11 @@

    skipChildren

    will call nextToken() to point to the next available token, if any.
    +
    Returns:
    +
    This parser, to allow call chaining
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1922,7 +2063,8 @@

    finishToken

    overridden by sub-classes.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.8
    @@ -1981,6 +2123,11 @@

    getCurrentToken

    public abstract JsonToken getCurrentToken()
    Alias for currentToken(), may be deprecated sometime after Jackson 2.12 (will be removed from 3.0).
    +
    +
    Returns:
    +
    Type of the token this parser currently points to, + if any: null before any tokens have been read, and
    +
    @@ -1993,6 +2140,10 @@

    getCurrentTokenId

    public abstract int getCurrentTokenId()
    Deprecated. Since 2.12 use currentTokenId() instead
    Alias for currentTokenId().
    +
    +
    Returns:
    +
    int matching one of constants from JsonTokenId.
    +
    @@ -2032,6 +2183,10 @@

    hasTokenId

    cases calling method like     isExpectedStartArrayToken() is necessary instead.
    +
    Parameters:
    +
    id - Token id to match (from (@link JsonTokenId})
    +
    Returns:
    +
    True if the parser current points to specified token
    Since:
    2.5
    @@ -2054,6 +2209,10 @@

    hasToken

    cases calling method like isExpectedStartArrayToken() is necessary instead.
    +
    Parameters:
    +
    t - Token to match
    +
    Returns:
    +
    True if the parser current points to specified token
    Since:
    2.6
    @@ -2083,7 +2242,7 @@

    isExpectedStartArrayToken

    Returns:
    True if the current token can be considered as a start-array marker (such JsonToken.START_ARRAY); - false if not.
    + false if not @@ -2097,6 +2256,10 @@

    isExpectedStartObjectToken

    Similar to isExpectedStartArrayToken(), but checks whether stream currently points to JsonToken.START_OBJECT.
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.START_OBJECT); + false if not
    Since:
    2.5
    @@ -2115,6 +2278,10 @@

    isExpectedNumberIntToken

    The initial use case is for XML backend to efficiently (attempt to) coerce textual content into numbers.
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.VALUE_NUMBER_INT); + false if not
    Since:
    2.12
    @@ -2135,8 +2302,13 @@

    isNaN

    NOTE: roughly equivalent to calling !Double.isFinite() on value you would get from calling getDoubleValue().
    +
    Returns:
    +
    True if the current token is of type JsonToken.VALUE_NUMBER_FLOAT + but represents a "Not a Number"; false for other tokens and regular + floating-point numbers
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.9
    @@ -2173,6 +2345,10 @@

    getLastClearedToken

    the latest token read. Will return null if no tokens have been cleared, or if parser has been closed. +
    +
    Returns:
    +
    Last cleared token, if any; null otherwise
    +
    @@ -2203,14 +2379,13 @@

    overrideCurrentName

    getCurrentName

    public abstract String getCurrentName()
                                throws IOException
    -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See currentName().
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2222,9 +2397,19 @@

    getCurrentName

    currentName

    public String currentName()
                    throws IOException
    +
    Method that can be called to get the name associated with + the current token: for JsonToken.FIELD_NAMEs it will + be the same as what getText() returns; + for field values it will be preceding field name; + and for others (array values, root-level values) null.
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    Since:
    +
    2.10
    @@ -2241,8 +2426,12 @@

    getText

    after encountering end-of-input), returns null. Method can be called for any token type.
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2265,10 +2454,14 @@

    getText

    be combined into a single String to return, and write can occur directly from intermediate buffers Jackson uses.
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    UnsupportedOperationException
    Since:
    2.8
    @@ -2307,8 +2500,12 @@

    getTextCharacters

    is to avoid construction of a String object (which will make a copy of contents).
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2328,7 +2525,8 @@

    getTextLength

    by getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2348,7 +2546,8 @@

    getTextOffset

    by getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2444,8 +2643,11 @@

    getNumberType

    JsonToken.VALUE_NUMBER_FLOAT, returns one of JsonParser.NumberType constants; otherwise returns null.
    +
    Returns:
    +
    Type of current number, if parser points to numeric token; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2460,17 +2662,27 @@

    getByteValue

    Numeric accessor that can be called when the current token is of type JsonToken.VALUE_NUMBER_INT and it can be expressed as a value of Java byte primitive type. + Note that in addition to "natural" input range of [-128, 127], + this also allows "unsigned 8-bit byte" values [128, 255]: + but for this range value will be translated by truncation, leading + to sign change. +

    It can also be called for JsonToken.VALUE_NUMBER_FLOAT; if so, it is equivalent to calling getDoubleValue() and then casting; except for possible overflow/underflow exception.

    Note: if the resulting integer value falls outside range of - Java byte, a InputCoercionException + [-128, 255], + a InputCoercionException will be thrown to indicate numeric overflow/underflow.

    +
    Returns:
    +
    Current number value as byte (if numeric token within + range of [-128, 255]); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2494,8 +2706,12 @@

    getShortValue

    Java short, a InputCoercionException will be thrown to indicate numeric overflow/underflow.
    +
    Returns:
    +
    Current number value as short (if numeric token within + Java 16-bit signed short range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2516,11 +2732,15 @@

    getIntValue

    exception.

    Note: if the resulting integer value falls outside range of - Java int, a InputCoercionException + Java int, a InputCoercionException may be thrown to indicate numeric overflow/underflow.

    +
    Returns:
    +
    Current number value as int (if numeric token within + Java 32-bit signed int range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2544,8 +2764,12 @@

    getLongValue

    outside of range of Java long, a InputCoercionException may be thrown to indicate numeric overflow/underflow.
    +
    Returns:
    +
    Current number value as long (if numeric token within + Java 32-bit signed long range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2565,8 +2789,12 @@

    getBigIntegerValue

    if so, it is equivalent to calling getDecimalValue() and then constructing a BigInteger from that value.
    +
    Returns:
    +
    Current number value as BigInteger (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2590,8 +2818,12 @@

    getFloatValue

    outside of range of Java float, a InputCoercionException will be thrown to indicate numeric overflow/underflow.
    +
    Returns:
    +
    Current number value as float (if numeric token within + Java float range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2615,8 +2847,12 @@

    getDoubleValue

    outside of range of Java double, a InputCoercionException will be thrown to indicate numeric overflow/underflow.
    +
    Returns:
    +
    Current number value as double (if numeric token within + Java double range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2633,8 +2869,12 @@

    getDecimalValue

    JsonToken.VALUE_NUMBER_INT. No under/overflow exceptions are ever thrown.
    +
    Returns:
    +
    Current number value as BigDecimal (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2648,15 +2888,18 @@

    getBooleanValue

    throws IOException
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE. -

    - Note: if the token is not of above-mentioned boolean types, - an integer, but its value falls - outside of range of Java long, a JsonParseException - may be thrown to indicate numeric overflow/underflow.

    + JsonToken.VALUE_FALSE, to return matching boolean + value. + If the current token is of some other type, JsonParseException + will be thrown
    +
    Returns:
    +
    True if current token is JsonToken.VALUE_TRUE, + false if current token is JsonToken.VALUE_FALSE; + otherwise throws JsonParseException
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2679,8 +2922,12 @@

    getEmbeddedObject

    which typically is accessible using this method, as well as getBinaryValue().
    +
    Returns:
    +
    Embedded value (usually of "native" type supported by format) + for the current token, if any; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2714,7 +2961,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2733,7 +2981,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2757,7 +3006,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.1
    @@ -2781,7 +3031,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.1
    @@ -2796,7 +3047,7 @@

    getValueAsInt

    public int getValueAsInt()
                   throws IOException
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -2805,8 +3056,12 @@

    getValueAsInt

    markers like start/end Object/Array) default value of 0 will be returned; no exceptions are thrown.
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2828,8 +3083,13 @@

    getValueAsInt

    markers like start/end Object/Array) specified def will be returned; no exceptions are thrown.
    +
    Parameters:
    +
    def - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2851,8 +3111,12 @@

    getValueAsLong

    markers like start/end Object/Array) default value of 0L will be returned; no exceptions are thrown.
    +
    Returns:
    +
    long value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2874,8 +3138,13 @@

    getValueAsLong

    markers like start/end Object/Array) specified def will be returned; no exceptions are thrown.
    +
    Parameters:
    +
    def - Default value to return if conversion to long is not possible
    +
    Returns:
    +
    long value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2897,8 +3166,12 @@

    getValueAsDouble

    like Objects and Arrays), default value of 0.0 will be returned; no exceptions are thrown.
    +
    Returns:
    +
    double value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2920,8 +3193,13 @@

    getValueAsDouble

    like Objects and Arrays), specified def will be returned; no exceptions are thrown.
    +
    Parameters:
    +
    def - Default value to return if conversion to double is not possible
    +
    Returns:
    +
    double value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2943,8 +3221,12 @@

    getValueAsBoolean

    like Objects and Arrays), default value of false will be returned; no exceptions are thrown.
    +
    Returns:
    +
    boolean value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2966,8 +3248,13 @@

    getValueAsBoolean

    like Objects and Arrays), specified def will be returned; no exceptions are thrown.
    +
    Parameters:
    +
    def - Default value to return if conversion to boolean is not possible
    +
    Returns:
    +
    boolean value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2987,8 +3274,11 @@

    getValueAsString

    like Objects and Arrays and null token), default value of null will be returned; no exceptions are thrown.
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.1
    @@ -3010,8 +3300,13 @@

    getValueAsString

    like Objects and Arrays and null token), specified default value will be returned; no exceptions are thrown.
    +
    Parameters:
    +
    def - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.1
    @@ -3033,6 +3328,9 @@

    canReadObjectId

    use a non-native notation (explicit property or such), or fail, in case it can not use native object ids.
    +
    Returns:
    +
    True if the format being read supports native Object Ids; + false if not
    Since:
    2.3
    @@ -3054,6 +3352,9 @@

    canReadTypeId

    use a non-native notation (explicit property or such), or fail, in case it can not use native type ids.
    +
    Returns:
    +
    True if the format being read supports native Type Ids; + false if not
    Since:
    2.3
    @@ -3077,8 +3378,11 @@

    getObjectId

    Default implementation will simply return null.

    +
    Returns:
    +
    Native Object id associated with the current token, if any; null if none
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.3
    @@ -3102,8 +3406,11 @@

    getTypeId

    Default implementation will simply return null.

    +
    Returns:
    +
    Native Type Id associated with the current token, if any; null if none
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    Since:
    2.3
    @@ -3137,8 +3444,16 @@

    readValueAs

    The reason is that due to type erasure, key and value types can not be introspected when using this method.
    +
    Type Parameters:
    +
    T - Nominal type parameter for value type
    +
    Parameters:
    +
    valueType - Java type to read content as (passed to ObjectCodec that + deserializes content)
    +
    Returns:
    +
    Java value read from content
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or decoding + issue at format layer
    @@ -3167,8 +3482,16 @@

    readValueAs

    (and for JsonToken.VALUE_EMBEDDED_OBJECT) stream is not advanced.
    +
    Type Parameters:
    +
    T - Nominal type parameter for value type
    +
    Parameters:
    +
    valueTypeRef - Java type to read content as (passed to ObjectCodec that + deserializes content)
    +
    Returns:
    +
    Java value read from content
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or decoding + issue at format layer
    @@ -3183,8 +3506,16 @@

    readValuesAs

    Method for reading sequence of Objects from parser stream, all with same specified value type.
    +
    Type Parameters:
    +
    T - Nominal type parameter for value type
    +
    Parameters:
    +
    valueType - Java type to read content as (passed to ObjectCodec that + deserializes content)
    +
    Returns:
    +
    Iterator for reading multiple Java values from content
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or decoding + issue at format layer
    @@ -3199,8 +3530,16 @@

    readValuesAs

    Method for reading sequence of Objects from parser stream, all with same specified value type.
    +
    Type Parameters:
    +
    T - Nominal type parameter for value type
    +
    Parameters:
    +
    valueTypeRef - Java type to read content as (passed to ObjectCodec that + deserializes content)
    +
    Returns:
    +
    Iterator for reading multiple Java values from content
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or decoding + issue at format layer
    @@ -3218,10 +3557,13 @@

    readValueAsTree

    for objects object node (with child nodes), and for other types matching leaf node type. Empty or whitespace documents are null.
    +
    Type Parameters:
    +
    T - Nominal type parameter for result node type (to reduce need for casting)
    Returns:
    root of the document, or null if empty or whitespace.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or decoding + issue at format layer
    @@ -3243,6 +3585,12 @@

    _constructError

    protected JsonParseException _constructError(String msg)
    Helper method for constructing JsonParseExceptions based on current state of the parser
    +
    +
    Parameters:
    +
    msg - Base exception message to construct exception with
    +
    Returns:
    +
    JsonParseException constructed
    +
    @@ -3329,6 +3677,6 @@

    _reportUnsupportedOperation

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonPointer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonPointer.html index ef21cc7d6b..21abfb7991 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonPointer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonPointer.html @@ -2,10 +2,10 @@ - + JsonPointer (Jackson-core 2.12.0 API) - + @@ -222,9 +222,7 @@

    Constructor Summary

    protected JsonPointer(String fullString, String segment, - JsonPointer next) -
    Constructor used for creating non-empty Segments
    - + JsonPointer next)  @@ -277,7 +275,7 @@

    Method Summary

    static JsonPointer -compile(String input) +compile(String expr)
    Factory method that parses given input and construct matching pointer instance, if it represents a valid JSON Pointer: if not, a IllegalArgumentException is thrown.
    @@ -323,13 +321,15 @@

    Method Summary

    JsonPointer -last() -
    Returns the leaf of current JSON Pointer expression.
    - +last()  JsonPointer -matchElement(int index)  +matchElement(int index) +
    Method that may be called to check whether the pointer head (first segment) + matches specified Array index and if so, return + JsonPointer that represents rest of the path after match.
    + boolean @@ -339,19 +339,23 @@

    Method Summary

    boolean matchesElement(int index)
    Method that may be called to see if the pointer would match - array element (of a JSON Array) with given index.
    + Array element (of a JSON Array) with given index. boolean matchesProperty(String name) -
    Method that may be called to see if the pointer would match property - (of a JSON Object) with given name.
    +
    Method that may be called to see if the pointer head (first segment) + would match property (of a JSON Object) with given name.
    JsonPointer -matchProperty(String name)  +matchProperty(String name) +
    Method that may be called to check whether the pointer head (first segment) + matches specified Object property (by name) and if so, return + JsonPointer that represents rest of the path after match.
    + boolean @@ -364,8 +368,8 @@

    Method Summary

    JsonPointer tail() -
    Accessor for getting a "sub-pointer", instance where current segment - has been removed and pointer includes rest of segments.
    +
    Accessor for getting a "sub-pointer" (or sub-path), instance where current segment + has been removed and pointer includes rest of the segments.
    @@ -374,7 +378,7 @@

    Method Summary

    static JsonPointer -valueOf(String input) +valueOf(String expr)
    Alias for compile(java.lang.String); added to make instances automatically deserializable by Jackson databind.
    @@ -519,7 +523,6 @@

    JsonPointer

    protected JsonPointer(String fullString,
                       String segment,
                       JsonPointer next)
    -
    Constructor used for creating non-empty Segments
    @@ -532,10 +535,6 @@

    JsonPointer

    String segment, int matchIndex, JsonPointer next) -
    -
    Since:
    -
    2.5
    -
    @@ -552,12 +551,16 @@

    Method Detail

    @@ -741,8 +770,12 @@

    matchProperty

    matchesElement

    public boolean matchesElement(int index)
    Method that may be called to see if the pointer would match - array element (of a JSON Array) with given index.
    + Array element (of a JSON Array) with given index.
    +
    Parameters:
    +
    index - Index of Array element to match
    +
    Returns:
    +
    True if the pointer head matches specified Array index
    Since:
    2.5
    @@ -755,7 +788,16 @@

    matchesElement

  • matchElement

    public JsonPointer matchElement(int index)
    +
    Method that may be called to check whether the pointer head (first segment) + matches specified Array index and if so, return + JsonPointer that represents rest of the path after match. + If there is no match, null is returned.
    +
    Parameters:
    +
    index - Index of Array element to match
    +
    Returns:
    +
    Remaining path after matching specified index, if there is match; + null otherwise
    Since:
    2.6
    @@ -768,9 +810,19 @@

    matchElement

  • tail

    public JsonPointer tail()
    -
    Accessor for getting a "sub-pointer", instance where current segment - has been removed and pointer includes rest of segments. - For matching state, will return null.
    +
    Accessor for getting a "sub-pointer" (or sub-path), instance where current segment + has been removed and pointer includes rest of the segments. + For example, for JSON Pointer "/root/branch/leaf", this method would + return pointer "/branch/leaf". + For matching state (last segment), will return null. +

    + Note that this is a very cheap method to call as it simply returns "next" segment + (which has been constructed when pointer instance was constructed).

    +
    +
    Returns:
    +
    Tail of this pointer, if it has any; null if this pointer only + has the current segment
    +
    • @@ -782,11 +834,17 @@

    head

    public JsonPointer head()
    Accessor for getting a pointer instance that is identical to this instance except that the last segment has been dropped. - For example, for JSON Point "/root/branch/leaf", this method would + For example, for JSON Pointer "/root/branch/leaf", this method would return pointer "/root/branch" (compared to tail() that would return "/branch/leaf"). - For leaf
    +

    + Note that whereas tail() is a very cheap operation to call (as "tail" already + exists for single-linked forward direction), this method has to fully + construct a new instance by traversing the chain of segments.

    +
    Returns:
    +
    Pointer expression that contains same segments as this one, except for + the last segment.
    Since:
    2.5
    @@ -854,6 +912,8 @@

    _parseQuotedTail

    Parameters:
    input - Full input for the tail being parsed
    i - Offset to character after tilde
    +
    Returns:
    +
    Pointer instance constructed
    @@ -945,6 +1005,6 @@

    _constructHead

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonProcessingException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonProcessingException.html index 9124b1f383..a2960c6a74 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonProcessingException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonProcessingException.html @@ -2,10 +2,10 @@ - + JsonProcessingException (Jackson-core 2.12.0 API) - + @@ -245,7 +245,7 @@

    Method Summary

    String getMessage() -
    Default method overridden so that we can add location information
    +
    Default implementation overridden so that we can add location information
    @@ -396,6 +396,9 @@

    getLocation

    Specified by:
    getLocation in class JacksonException
    +
    Returns:
    +
    Location in input or output that triggered the problem reported, if + available; null otherwise.
    @@ -428,6 +431,8 @@

    getOriginalMessage

    Specified by:
    getOriginalMessage in class JacksonException
    +
    Returns:
    +
    Original message passed in constructor
    Since:
    2.1
    @@ -468,6 +473,10 @@

    getMessageSuffix

    Accessor that sub-classes can override to append additional information right after the main message, but before source location information.
    +
    +
    Returns:
    +
    Message suffix assigned, if any; null if none
    +
    @@ -477,10 +486,13 @@

    getMessageSuffix

  • getMessage

    public String getMessage()
    -
    Default method overridden so that we can add location information
    +
    Default implementation overridden so that we can add location information
    Overrides:
    getMessage in class Throwable
    +
    Returns:
    +
    Original message preceded by optional prefix and followed by + location information, message and location information separated by a linefeed
    • @@ -566,6 +578,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonStreamContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonStreamContext.html index c966433a7a..381c840993 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonStreamContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonStreamContext.html @@ -2,10 +2,10 @@ - + JsonStreamContext (Jackson-core 2.12.0 API) - + @@ -292,14 +292,14 @@

    Method Summary

    boolean inArray()
    Method that returns true if this context is an Array context; - that is, content is being read from or written to a Json Array.
    + that is, content is being read from or written to a JSON Array. boolean inObject()
    Method that returns true if this context is an Object context; - that is, content is being read from or written to a Json Object.
    + that is, content is being read from or written to a JSON Object. @@ -343,7 +343,11 @@

    Method Summary

    String -typeDesc()  +typeDesc() +
    Method for accessing simple type description of current context; + either ROOT (for root-level values), OBJECT (for field names and + values of JSON Objects) or ARRAY (for values of JSON Arrays)
    + @@ -496,6 +498,10 @@

    getParent

    public abstract JsonStreamContext getParent()
    Accessor for finding parent context of this context; will return null for root context.
    +
    +
    Returns:
    +
    Parent context of this context, if any; null for Root contexts
    +
    @@ -506,7 +512,11 @@

    getParent

    inArray

    public final boolean inArray()
    Method that returns true if this context is an Array context; - that is, content is being read from or written to a Json Array.
    + that is, content is being read from or written to a JSON Array. +
    +
    Returns:
    +
    True if this context represents an Array; false otherwise
    +
     @@ -519,6 +529,10 @@

    inRoot

    Method that returns true if this context is a Root context; that is, content is being read from or written to without enclosing array or object structure.
    +
    +
    Returns:
    +
    True if this context represents a sequence of Root values; false otherwise
    +
     @@ -529,7 +543,11 @@

    inRoot

    inObject

    public final boolean inObject()
    Method that returns true if this context is an Object context; - that is, content is being read from or written to a Json Object.
    + that is, content is being read from or written to a JSON Object. +
    +
    Returns:
    +
    True if this context represents an Object; false otherwise
    +
     @@ -541,9 +559,10 @@

    getTypeDesc

    @Deprecated
 public final String getTypeDesc()
    Deprecated. Since 2.8 use typeDesc() instead
    -
    Method for accessing simple type description of current context; - either ROOT (for root-level values), OBJECT (for field names and - values of JSON Objects) or ARRAY (for values of JSON Arrays)
    +
    +
    Returns:
    +
    Type description String
    +
    @@ -553,7 +572,12 @@

    getTypeDesc

  • typeDesc

    public String typeDesc()
    +
    Method for accessing simple type description of current context; + either ROOT (for root-level values), OBJECT (for field names and + values of JSON Objects) or ARRAY (for values of JSON Arrays)
    +
    Returns:
    +
    Type description String
    Since:
    2.8
    @@ -596,6 +620,8 @@

    hasCurrentIndex

    will return `false` before the first entry of Object context or before first element of Array context; otherwise returns `true`.
    +
    Returns:
    +
    True if this context has value index to access, false otherwise
    Since:
    2.9
    @@ -622,6 +648,8 @@

    hasPathSegment

    Method is mostly used to determine whether this context should be used for constructing JsonPointer
    +
    Returns:
    +
    True if this context has value path segment to access, false otherwise
    Since:
    2.9
    @@ -637,6 +665,10 @@

    getCurrentName

    Method for accessing name associated with the current location. Non-null for FIELD_NAME and value events that directly follow field names; null for root level and array values.
    +
    +
    Returns:
    +
    Current field name within context, if any; null if none
    +
    • @@ -647,6 +679,9 @@

    getCurrentName

    hasCurrentName

    public boolean hasCurrentName()
    +
    Returns:
    +
    True if a call to getCurrentName() would return non-null + name; false otherwise
    Since:
    2.9
    @@ -686,6 +721,8 @@

    setCurrentValue

    called indirectly through JsonParser.setCurrentValue(java.lang.Object) or JsonGenerator.setCurrentValue(java.lang.Object)).
    +
    Parameters:
    +
    v - Current value to assign to this context
    Since:
    2.5
    @@ -702,6 +739,8 @@

    pathAsPointer

    location within the stream that this context is for, excluding information about "root context" (only relevant for multi-root-value cases)
    +
    Returns:
    +
    Pointer instance constructed
    Since:
    2.9
    @@ -720,6 +759,8 @@

    pathAsPointer

    Parameters:
    includeRoot - Whether root-value offset is included as the first segment or not;
    +
    Returns:
    +
    Pointer instance constructed
    Since:
    2.9
    @@ -736,14 +777,16 @@

    getStartLocation

    for example, in case of JSON `Object` context, offset at which `[` token was read or written. Often used for error reporting purposes. Implementations that do not keep track of such location are expected to return - JsonLocation.NA; this is what the default implementation does. + JsonLocation.NA; this is what the default implementation does. +

    + NOTE: demoted from JsonReadContext in 2.9, to allow use for + "non-standard" read contexts.

    +
    Parameters:
    +
    srcRef - Source reference needed to construct location instance
    Returns:
    Location pointing to the point where the context - start marker was found (or written); never `null`. -

    - NOTE: demoted from JsonReadContext in 2.9, to allow use for - "non-standard" read contexts.

    + start marker was found (or written); never `null`.
    Since:
    2.9
    @@ -761,6 +804,9 @@

    toString

    Overrides:
    toString in class Object
    +
    Returns:
    +
    Simple developer-readable description this context layer + (note: NOT constructed with parents, unlike pathAsPointer())
    Since:
    2.9
    @@ -835,6 +881,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonToken.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonToken.html index 012894c639..20b3d27a64 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonToken.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonToken.html @@ -2,10 +2,10 @@ - + JsonToken (Jackson-core 2.12.0 API) - + @@ -592,6 +592,11 @@

    asByteArray

  • isNumeric

    public final boolean isNumeric()
    +
    +
    Returns:
    +
    True if this token is VALUE_NUMBER_INT or VALUE_NUMBER_FLOAT, + false otherwise
    +
    • @@ -606,6 +611,9 @@

    isStructStart

    this == JsonToken.START_OBJECT || this == JsonToken.START_ARRAY
    +
    Returns:
    +
    True if this token is START_OBJECT or START_ARRAY, + false otherwise
    Since:
    2.3
    @@ -623,6 +631,9 @@

    isStructEnd

    this == JsonToken.END_OBJECT || this == JsonToken.END_ARRAY
    +
    Returns:
    +
    True if this token is END_OBJECT or END_ARRAY, + false otherwise
    Since:
    2.3
    @@ -636,8 +647,14 @@

    isStructEnd

    isScalarValue

    public final boolean isScalarValue()
    Method that can be used to check whether this token represents - a valid non-structured value. This means all tokens other than - Object/Array start/end markers all field names.
    + a valid non-structured value. This means all VALUE_xxx tokens; + excluding START_xxx and END_xxx tokens as well + FIELD_NAME. +
    +
    Returns:
    +
    True if this token is a scalar value token (one of + VALUE_xxx tokens), false otherwise
    +
     @@ -647,6 +664,11 @@

    isScalarValue

  • isBoolean

    public final boolean isBoolean()
    +
    +
    Returns:
    +
    True if this token is VALUE_TRUE or VALUE_FALSE, + false otherwise
    +
    • @@ -718,6 +740,6 @@

    isBoolean

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonTokenId.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonTokenId.html index dffd24d50c..8a6f757f90 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonTokenId.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonTokenId.html @@ -2,10 +2,10 @@ - + JsonTokenId (Jackson-core 2.12.0 API) - + @@ -497,6 +497,6 @@

    ID_EMBEDDED_OBJECT

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonpCharacterEscapes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonpCharacterEscapes.html index 04955afdc8..8f692d4dde 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonpCharacterEscapes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/JsonpCharacterEscapes.html @@ -2,10 +2,10 @@ - + JsonpCharacterEscapes (Jackson-core 2.12.0 API) - + @@ -272,6 +272,10 @@

    getEscapeSequence

    Specified by:
    getEscapeSequence in class CharacterEscapes
    +
    Parameters:
    +
    ch - Character to look escape sequence for
    +
    Returns:
    +
    Escape sequence to use for the character, if any; null if not
    @@ -368,6 +372,6 @@

    getEscapeCodesForAscii

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/ObjectCodec.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/ObjectCodec.html index 0d23e274ea..94c7fba99c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/ObjectCodec.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/ObjectCodec.html @@ -2,10 +2,10 @@ - + ObjectCodec (Jackson-core 2.12.0 API) - + @@ -191,14 +191,14 @@

    Method Summary

    JsonFactory getJsonFactory()
    Deprecated.  -
    Since 2.1: Use getFactory() instead.
    +
    Use getFactory() instead.
    abstract <T extends TreeNode>
    T     readTree(JsonParser p) -
    Method to deserialize JSON content as tree expressed +
    Method for deserializing JSON content as tree expressed using set of TreeNode instances.
    @@ -280,7 +280,10 @@

    Method Summary

    abstract void writeTree(JsonGenerator gen, - TreeNode tree)  + TreeNode tree) +
    Method for serializing JSON content from given Tree instance, using + specified generator.
    + abstract void @@ -350,6 +353,8 @@

    version

    Specified by:
    version in interface Versioned
    +
    Returns:
    +
    Version of the component
    @@ -371,8 +376,16 @@

    readValue

    The reason is that due to type erasure, key and value types can not be introspected when using this method.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueType - Java value type to bind content to
    +
    Returns:
    +
    Value deserialized
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -391,8 +404,16 @@

    readValue

    and specifically needs to be used if the root type is a parameterized (generic) container type.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueTypeRef - Java value type to bind content to
    +
    Returns:
    +
    Value deserialized
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -410,8 +431,16 @@

    readValue

    including containers like Collection and Map).
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueType - Java value type to bind content to
    +
    Returns:
    +
    Value deserialized
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -427,8 +456,16 @@

    readValues

    Method for reading sequence of Objects from parser stream, all with same specified value type.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueType - Java value type to bind content to
    +
    Returns:
    +
    Iterator for incrementally deserializing values
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -444,8 +481,16 @@

    readValues

    Method for reading sequence of Objects from parser stream, all with same specified value type.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueTypeRef - Java value type to bind content to
    +
    Returns:
    +
    Iterator for incrementally deserializing values
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -461,8 +506,16 @@

    readValues

    Method for reading sequence of Objects from parser stream, all with same specified value type.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    p - Parser to use for decoding content to bind
    +
    valueType - Java value type to bind content to
    +
    Returns:
    +
    Iterator for incrementally deserializing values
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -478,8 +531,12 @@

    writeValue

    Method to serialize given Java Object, using generator provided.
    +
    Parameters:
    +
    gen - Generator to use for serializing value
    +
    value - Value to serialize
    Throws:
    -
    IOException
    +
    IOException - for low-level write issues, or + JsonGenerationException for decoding problems
    @@ -491,7 +548,7 @@

    writeValue

    readTree

    public abstract <T extends TreeNode> T readTree(JsonParser p)
                                          throws IOException
    -
    Method to deserialize JSON content as tree expressed +
    Method for deserializing JSON content as tree expressed using set of TreeNode instances. Returns root of the resulting tree (where root can consist of just a single node if the current event is a @@ -501,9 +558,10 @@

    readTree

    Specified by:
    readTree in class TreeCodec
    Returns:
    -
    next tree from p, or null if empty.
    +
    next tree from p, or null if empty.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -516,11 +574,17 @@

    writeTree

    public abstract void writeTree(JsonGenerator gen,
                                TreeNode tree)
                         throws IOException
    +
    Method for serializing JSON content from given Tree instance, using + specified generator.
    Specified by:
    writeTree in class TreeCodec
    +
    Parameters:
    +
    gen - Generator to use for serializing value
    +
    tree - Tree to serialize
    Throws:
    -
    IOException
    +
    IOException - for low-level write issues, or + JsonGenerationException for decoding problems
    @@ -536,6 +600,8 @@

    createObjectNode

    Specified by:
    createObjectNode in class TreeCodec
    +
    Returns:
    +
    Object node created
    @@ -551,6 +617,8 @@

    createArrayNode

    Specified by:
    createArrayNode in class TreeCodec
    +
    Returns:
    +
    Array node created
    @@ -567,6 +635,10 @@

    treeAsTokens

    Specified by:
    treeAsTokens in class TreeCodec
    +
    Parameters:
    +
    n - Content to traverse over
    +
    Returns:
    +
    Parser constructed for traversing over contents of specified node
    @@ -583,8 +655,15 @@

    treeToValue

    value type. This is equivalent to first constructing a JsonParser to iterate over contents of the tree, and using that parser for data binding.
    +
    Type Parameters:
    +
    T - Nominal parameter for target type
    +
    Parameters:
    +
    n - Tree to convert
    +
    valueType - Java target value type to convert content to
    +
    Returns:
    +
    Converted value instance
    Throws:
    -
    JsonProcessingException
    +
    JsonProcessingException - if structural conversion fails
    @@ -596,7 +675,11 @@

    treeToValue

    getJsonFactory

    @Deprecated
 public JsonFactory getJsonFactory()
    -
    Deprecated. Since 2.1: Use getFactory() instead.
    +
    Deprecated. Use getFactory() instead.
    +
    +
    Returns:
    +
    Underlying JsonFactory instance
    +
    @@ -609,8 +692,8 @@

    getFactory

    Accessor for finding underlying data format factory (JsonFactory) codec will use for data binding.
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    Underlying JsonFactory instance
    @@ -683,6 +766,6 @@

    getFactory

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/PrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/PrettyPrinter.html index a6bbfa276b..bea5238cbb 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/PrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/PrettyPrinter.html @@ -2,10 +2,10 @@ - + PrettyPrinter (Jackson-core 2.12.0 API) - + @@ -202,7 +202,7 @@

    Method Summary

    void writeObjectEntrySeparator(JsonGenerator gen) -
    Method called after an object entry (field:value) has been completely +
    Method called after an Object entry (field:value) has been completely output, and before another value is to be output.
    @@ -295,14 +295,16 @@

    writeRootValueSeparator

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

    - Default - handling (without pretty-printing) will output a space, to + Default handling (without pretty-printing) will output a space, to allow values to be parsed correctly. Pretty-printer is to output some other suitable and nice-looking separator (tab(s), space(s), linefeed(s) or any combination thereof).

    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -323,8 +325,11 @@

    writeStartObject

    to output a curly bracket as well, but can surround that with other (white-space) decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -347,10 +352,12 @@

    writeEndObject

    with other (white-space) decoration.
    Parameters:
    -
    nrOfEntries - Number of direct members of the array that +
    gen - Generator used for output
    +
    nrOfEntries - Number of direct members of the Object that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -362,7 +369,7 @@

    writeEndObject

    writeObjectEntrySeparator

    void writeObjectEntrySeparator(JsonGenerator gen)
                         throws IOException
    -
    Method called after an object entry (field:value) has been completely +
    Method called after an Object entry (field:value) has been completely output, and before another value is to be output.

    Default handling (without pretty-printing) will output a single @@ -370,8 +377,11 @@

    writeObjectEntrySeparator

    to output a comma as well, but can surround that with other (white-space) decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -391,8 +401,11 @@

    writeObjectFieldValueSeparator

    to output a colon as well, but can surround that with other (white-space) decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -413,8 +426,11 @@

    writeStartArray

    to output a bracket as well, but can surround that with other (white-space) decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -437,10 +453,12 @@

    writeEndArray

    with other (white-space) decoration.
    Parameters:
    +
    gen - Generator used for output
    nrOfValues - Number of direct members of the array that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -460,8 +478,11 @@

    writeArrayValueSeparator

    to output a comma as well, but can surround that with other (white-space) decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -480,8 +501,11 @@

    beforeArrayValues

    Default handling does not output anything, but pretty-printer is free to add any white space decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -501,8 +525,11 @@

    beforeObjectEntries

    Default handling does not output anything, but pretty-printer is free to add any white space decoration.
    +
    Parameters:
    +
    gen - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -575,6 +602,6 @@

    beforeObjectEntries

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/SerializableString.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/SerializableString.html index 9bf708ff56..b5b282b9dd 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/SerializableString.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/SerializableString.html @@ -2,10 +2,10 @@ - + SerializableString (Jackson-core 2.12.0 API) - + @@ -202,19 +202,31 @@

    Method Summary

    int -putQuotedUTF8(ByteBuffer buffer)  +putQuotedUTF8(ByteBuffer buffer) +
    Method for appending JSON-escaped UTF-8 encoded String value into given + ByteBuffer, if it fits.
    + int -putUnquotedUTF8(ByteBuffer out)  +putUnquotedUTF8(ByteBuffer buffer) +
    Method for appending unquoted ('raw') UTF-8 encoded String value into given + ByteBuffer, if it fits.
    + int -writeQuotedUTF8(OutputStream out)  +writeQuotedUTF8(OutputStream out) +
    Method for writing JSON-escaped UTF-8 encoded String value using given + OutputStream.
    + int -writeUnquotedUTF8(OutputStream out)  +writeUnquotedUTF8(OutputStream out) +
    Method for writing unescaped UTF-8 encoded String value using given + OutputStream.
    + @@ -240,6 +252,10 @@

    getValue

    String getValue()
    Returns unquoted String that this object represents (and offers serialized forms for)
    +
    +
    Returns:
    +
    Unquoted String
    +
    @@ -254,6 +270,10 @@

    charLength

        getValue().length();
    +
    +
    Returns:
    +
    Length of the String in characters
    +
     @@ -265,6 +285,10 @@

    asQuotedChars

    char[] asQuotedChars()
    Returns JSON quoted form of the String, as character array. Result can be embedded as-is in textual JSON as property name or JSON String.
    +
    +
    Returns:
    +
    JSON quoted form of the String as char[]
    +
     @@ -279,6 +303,10 @@

    asUnquotedUTF8

      getValue().getBytes("UTF-8");
    +
    +
    Returns:
    +
    UTF-8 encoded version of String, without any escaping
    +
     @@ -293,6 +321,10 @@

    asQuotedUTF8

      new String(asQuotedChars()).getBytes("UTF-8");
    +
    +
    Returns:
    +
    UTF-8 encoded version of JSON-escaped String
    +
     @@ -312,6 +344,9 @@

    appendQuotedUTF8

    return bytes.length;
    +
    Parameters:
    +
    buffer - Buffer to append JSON-escaped String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of bytes appended, if successful, otherwise -1
    @@ -333,6 +368,9 @@

    appendQuoted

    return ch.length;
    +
    Parameters:
    +
    buffer - Buffer to append JSON-escaped String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of characters appended, if successful, otherwise -1
    @@ -354,6 +392,9 @@

    appendUnquotedUTF8

    return bytes.length;
    +
    Parameters:
    +
    buffer - Buffer to append literal (unescaped) String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of bytes appended, if successful, otherwise -1
    @@ -375,6 +416,9 @@

    appendUnquoted

    return ch.length;
    +
    Parameters:
    +
    buffer - Buffer to append literal (unescaped) String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of characters appended, if successful, otherwise -1
    @@ -388,11 +432,15 @@

    appendUnquoted

    writeQuotedUTF8

    int writeQuotedUTF8(OutputStream out)
              throws IOException
    +
    Method for writing JSON-escaped UTF-8 encoded String value using given + OutputStream.
    +
    Parameters:
    +
    out - OutputStream to write String into
    Returns:
    Number of bytes written
    Throws:
    -
    IOException
    +
    IOException - if underlying stream write fails
    @@ -404,11 +452,15 @@

    writeQuotedUTF8

    writeUnquotedUTF8

    int writeUnquotedUTF8(OutputStream out)
                throws IOException
    +
    Method for writing unescaped UTF-8 encoded String value using given + OutputStream.
    +
    Parameters:
    +
    out - OutputStream to write String into
    Returns:
    Number of bytes written
    Throws:
    -
    IOException
    +
    IOException - if underlying stream write fails
    @@ -420,11 +472,15 @@

    writeUnquotedUTF8

    putQuotedUTF8

    int putQuotedUTF8(ByteBuffer buffer)
            throws IOException
    +
    Method for appending JSON-escaped UTF-8 encoded String value into given + ByteBuffer, if it fits.
    +
    Parameters:
    +
    buffer - ByteBuffer to append String into
    Returns:
    -
    Number of bytes put, if successful, otherwise -1
    +
    Number of bytes put, if contents fit, otherwise -1
    Throws:
    -
    IOException
    +
    IOException - if underlying buffer append operation fails
    @@ -434,13 +490,17 @@

    putQuotedUTF8

    @@ -513,6 +573,6 @@

    putUnquotedUTF8

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadCapability.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadCapability.html index a99970aae7..98a443e7c0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadCapability.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadCapability.html @@ -2,10 +2,10 @@ - + StreamReadCapability (Jackson-core 2.12.0 API) - + @@ -193,14 +193,14 @@

    Method Summary

    boolean enabledIn(int flags) -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. @@ -356,6 +356,8 @@

    enabledByDefault

    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -367,10 +369,14 @@

    enabledByDefault

    enabledIn

    public boolean enabledIn(int flags)
    Description copied from interface: JacksonFeature
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -383,10 +389,12 @@

    getMask

    public int getMask()
    Description copied from interface: JacksonFeature
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N.
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -459,6 +467,6 @@

    getMask

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadFeature.html index 7ea234d0bb..d7d4d8c64b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamReadFeature.html @@ -2,10 +2,10 @@ - + StreamReadFeature (Jackson-core 2.12.0 API) - + @@ -202,14 +202,14 @@

    Method Summary

    boolean enabledIn(int flags) -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. @@ -408,6 +408,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit mask of all features that are enabled by default
    +
    @@ -422,6 +426,8 @@

    enabledByDefault

    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -433,10 +439,14 @@

    enabledByDefault

    enabledIn

    public boolean enabledIn(int flags)
    Description copied from interface: JacksonFeature
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -449,10 +459,12 @@

    getMask

    public int getMask()
    Description copied from interface: JacksonFeature
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N.
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -534,6 +546,6 @@

    mappedFeature

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteCapability.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteCapability.html index 388873086d..e222ab3980 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteCapability.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteCapability.html @@ -2,10 +2,10 @@ - + StreamWriteCapability (Jackson-core 2.12.0 API) - + @@ -185,14 +185,14 @@

    Method Summary

    boolean enabledIn(int flags) -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. @@ -328,6 +328,8 @@

    enabledByDefault

    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -339,10 +341,14 @@

    enabledByDefault

    enabledIn

    public boolean enabledIn(int flags)
    Description copied from interface: JacksonFeature
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -355,10 +361,12 @@

    getMask

    public int getMask()
    Description copied from interface: JacksonFeature
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N.
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -431,6 +439,6 @@

    getMask

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteFeature.html index c79c7b34a2..818aba422e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/StreamWriteFeature.html @@ -2,10 +2,10 @@ - + StreamWriteFeature (Jackson-core 2.12.0 API) - + @@ -218,14 +218,14 @@

    Method Summary

    boolean enabledIn(int flags) -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. @@ -453,6 +453,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit mask of all features that are enabled by default
    +
    @@ -467,6 +471,8 @@

    enabledByDefault

    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -478,10 +484,14 @@

    enabledByDefault

    enabledIn

    public boolean enabledIn(int flags)
    Description copied from interface: JacksonFeature
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -494,10 +504,12 @@

    getMask

    public int getMask()
    Description copied from interface: JacksonFeature
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N.
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -579,6 +591,6 @@

    mappedFeature

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/TSFBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/TSFBuilder.html index 4bc9e52818..ac939ef9d7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/TSFBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/TSFBuilder.html @@ -2,10 +2,10 @@ - + TSFBuilder (Jackson-core 2.12.0 API) - + @@ -841,6 +841,10 @@

    build

    public abstract F build()
    Method for constructing actual TokenStreamFactory instance, given configuration.
    +
    +
    Returns:
    +
    TokenStreamFactory build based on current configuration
    +
    @@ -957,6 +961,6 @@

    _legacyDisable

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/TokenStreamFactory.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/TokenStreamFactory.html index 85d06d9f01..483e0a12ce 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/TokenStreamFactory.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/TokenStreamFactory.html @@ -2,10 +2,10 @@ - + TokenStreamFactory (Jackson-core 2.12.0 API) - + @@ -397,6 +397,11 @@

    requiresPropertyOrdering

    require stable ordering. Formats that require ordering include positional textual formats like CSV, and schema-based binary formats like Avro. +
    +
    Returns:
    +
    Whether format supported by this factory + requires Object properties to be ordered.
    +
    @@ -414,6 +419,11 @@

    canHandleBinaryNatively

    Default implementation returns false as JSON does not support native access: all binary content must use Base64 encoding. Most binary formats (like Smile and Avro) support native binary content. +
    +
    Returns:
    +
    Whether format supported by this factory + supports native binary content
    +
     @@ -427,6 +437,11 @@

    canParseAsync

    factory can create non-blocking parsers: parsers that do not use blocking I/O abstractions but instead use a     NonBlockingInputFeeder. +
    +
    Returns:
    +
    Whether this factory supports non-blocking ("async") parsing or + not (and consequently whether createNonBlockingXxx() method(s) work)
    +
    @@ -440,6 +455,8 @@

    getFormatReadFeatureType

    JsonParser produced by this factory would accept, if any; null returned if none.
    +
    Returns:
    +
    Type of format-specific stream read features, if any; null if none
    Since:
    2.6
    @@ -456,6 +473,8 @@

    getFormatWriteFeatureType

    JsonGenerator produced by this factory would accept, if any; null returned if none.
    +
    Returns:
    +
    Type of format-specific stream read features, if any; null if none
    Since:
    2.6
    @@ -475,6 +494,11 @@

    canUseSchema

    generators this factory constructs); individual schema instances may have further usage restrictions.
    +
    Parameters:
    +
    schema - Schema instance to check
    +
    Returns:
    +
    Whether parsers and generators constructed by this factory + can use specified format schema instance
    Since:
    2.1
    @@ -489,6 +513,10 @@

    getFormatName

    public abstract String getFormatName()
    Method that returns short textual id identifying format this factory supports.
    +
    +
    Returns:
    +
    Name of the format handled by parsers, generators this factory creates
    +
    @@ -811,8 +839,12 @@

    _optimizedStreamFromURL

    parsers to use, when input is to be read from an URL. This helps when reading file content via URL.
    +
    Parameters:
    +
    url - Source to read content to parse from
    +
    Returns:
    +
    InputStream constructed for given URL
    Throws:
    -
    IOException
    +
    IOException - If there is a problem accessing content from specified URL
    @@ -885,6 +917,6 @@

    _optimizedStreamFromURL

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeCodec.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeCodec.html index 6f01a587c0..358567c6d8 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeCodec.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeCodec.html @@ -2,10 +2,10 @@ - + TreeCodec (Jackson-core 2.12.0 API) - + @@ -266,6 +266,9 @@

    writeTree

    missingNode

    public TreeNode missingNode()
    +
    Returns:
    +
    Node that represents "missing" node during traversal: something + referenced but that does not exist in content model
    Since:
    2.10
    @@ -279,6 +282,8 @@

    missingNode

    nullNode

    public TreeNode nullNode()
    +
    Returns:
    +
    Node that represents explict null value in content
    Since:
    2.10
    @@ -380,6 +385,6 @@

    treeAsTokens

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeNode.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeNode.html index 3585dcc52b..d470a2789a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeNode.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/TreeNode.html @@ -2,10 +2,10 @@ - + TreeNode (Jackson-core 2.12.0 API) - + @@ -117,12 +117,10 @@

    Interface TreeNode

    be minimized.

    NOTE: starting with Jackson 2.2, there is more functionality - available via this class, and the intent is that this should + available via this class, and the intent was that this should form actual base for multiple alternative tree representations; for example, immutable trees could use different implementation - than mutable trees. It should also be possible to move actual - Tree Model implementation out of databind package eventually - (Jackson 3?). + than mutable trees.

    Since:
    2.2
    @@ -293,6 +291,10 @@

    asToken

    Will return the first JsonToken that equivalent stream event would produce (for most nodes there is just one token but for structured/container types multiple) +
    +
    Returns:
    +
    JsonToken that is most closely associated with the node type
    +
    @@ -347,6 +349,9 @@

    isValueNode

    isContainerNode() and isMissingNode() ever returns true for any given node.
    +
    Returns:
    +
    True if this node is considered a value node; something that + represents either a scalar value or explicit null
    Since:
    2.2
    @@ -365,6 +370,8 @@

    isContainerNode

    isContainerNode() and isMissingNode() ever returns true for any given node.
    +
    Returns:
    +
    True for Array and Object nodes, false otherwise
    Since:
    2.2
    @@ -385,6 +392,8 @@

    isMissingNode

    isContainerNode() and isMissingNode() ever returns true for any given node.
    +
    Returns:
    +
    True if this node represents a "missing" node
    Since:
    2.2
    @@ -402,6 +411,8 @@

    isArray

    Note that if true is returned, isContainerNode() must also return true.
    +
    Returns:
    +
    True for Array nodes, false for everything else
    Since:
    2.2
    @@ -419,6 +430,8 @@

    isObject

    Note that if true is returned, isContainerNode() must also return true.
    +
    Returns:
    +
    True for Object nodes, false for everything else
    Since:
    2.2
    @@ -440,10 +453,12 @@

    get

    implementations; some trees may retain explicit nulls, others not.
    +
    Parameters:
    +
    fieldName - Name of the field (of Object node) to access
    Returns:
    Node that represent value of the specified field, - if this node is an object and has value for the specified - field. Null otherwise.
    + if this node is an Object and has value for the specified + field; null otherwise.
    Since:
    2.2
    @@ -467,10 +482,12 @@

    get

    node.size(), null is returned; no exception is thrown for any index.
    +
    Parameters:
    +
    index - Index of the Array node element to access
    Returns:
    Node that represent value of the specified element, - if this node is an array and has specified element. - Null otherwise.
    + if this node is an array and has specified element; + null otherwise.
    Since:
    2.2
    @@ -488,6 +505,8 @@

    path

    For other nodes, a "missing node" (virtual node for which isMissingNode() returns true) is returned.
    +
    Parameters:
    +
    fieldName - Name of the field (of Object node) to access
    Returns:
    Node that represent value of the specified field, if this node is an object and has value for the specified field; @@ -517,6 +536,8 @@

    path

    node.size(), "missing node" is returned; no exception is thrown for any index.
    +
    Parameters:
    +
    index - Index of the Array node element to access
    Returns:
    Node that represent value of the specified element, if this node is an array and has specified element; @@ -537,6 +558,9 @@

    fieldNames

    this node is an Object node. Number of field names accessible will be size().
    +
    Returns:
    +
    An iterator for traversing names of all fields this Object node + has (if Object node); empty Iterator otherwise (never null).
    Since:
    2.2
    @@ -551,11 +575,14 @@

    at

    TreeNode at(JsonPointer ptr)
    Method for locating node specified by given JSON pointer instances. Method will never return null; if no matching node exists, - will return a node for which isMissingNode() returns true.
    + will return a node for which isMissingNode() returns true.
    +
    Parameters:
    +
    ptr - JsonPointer expression for descendant node to return
    Returns:
    -
    Node that matches given JSON Pointer: if no match exists, - will return a node for which isMissingNode() returns true.
    +
    Node that matches given JSON Pointer, if any: if no match exists, + will return a "missing" node (for which isMissingNode() + returns true).
    Since:
    2.3
    @@ -582,8 +609,9 @@

    at

    jsonPointerExpression - Expression to compile as a JsonPointer instance
    Returns:
    -
    Node that matches given JSON Pointer: if no match exists, - will return a node for which isMissingNode() returns true.
    +
    Node that matches given JSON Pointer, if any: if no match exists, + will return a "missing" node (for which isMissingNode() + returns true).
    Throws:
    IllegalArgumentException
    Since:
    @@ -612,6 +640,10 @@

    traverse

    reference, so data-binding callback methods like JsonParser.readValueAs(Class) will not work with calling JsonParser.setCodec(com.fasterxml.jackson.core.ObjectCodec)). It is often better to call traverse(ObjectCodec) to pass the codec explicitly. +
    +
    Returns:
    +
    JsonParser that will stream over contents of this node
    +
    @@ -629,6 +661,10 @@

    traverse

    so before passing it to deserializers, it is typically necessary to advance it to the first available token by calling     JsonParser.nextToken().
    +
    Parameters:
    +
    codec - ObjectCodec to associate with parser constructed
    +
    Returns:
    +
    JsonParser that will stream over contents of this node
    Since:
    2.1
    @@ -703,6 +739,6 @@

    traverse

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/Version.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/Version.html index d509f51b6d..28ce141e9c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/Version.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/Version.html @@ -2,10 +2,10 @@ - + Version (Jackson-core 2.12.0 API) - + @@ -381,6 +381,11 @@

    Version

    String snapshotInfo)
    Deprecated. Use variant that takes group and artifact ids
    +
    Parameters:
    +
    major - Major version number
    +
    minor - Minor version number
    +
    patchLevel - patch level of version
    +
    snapshotInfo - Optional additional string qualifier
    Since:
    2.1
    @@ -417,6 +422,11 @@

    unknownVersion

    public static Version unknownVersion()
    Method returns canonical "not known" version, which is used as version in cases where actual version information is not known (instead of null).
    +
    +
    Returns:
    +
    Version instance to use as a placeholder when actual version is not known + (or not relevant)
    +
    @@ -427,6 +437,9 @@

    unknownVersion

    isUnknownVersion

    public boolean isUnknownVersion()
    +
    Returns:
    +
    True if this instance is the one returned by + call to unknownVersion()
    Since:
    2.7 to replace misspelled isUknownVersion()
    @@ -450,6 +463,11 @@

    isUknownVersion

    @Deprecated
 public boolean isUknownVersion()
    Deprecated. Since 2.7 use correctly spelled method isUnknownVersion()
    +
    +
    Returns:
    +
    True if this instance is the one returned by + call to unknownVersion()
    +
    @@ -627,6 +645,6 @@

    compareTo

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/Versioned.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/Versioned.html index 1c1b3e026c..179f668046 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/Versioned.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/Versioned.html @@ -2,10 +2,10 @@ - + Versioned (Jackson-core 2.12.0 API) - + @@ -164,6 +164,10 @@

    version

    Method called to detect version of the component that implements this interface; returned version should never be null, but may return specific "not available" instance (see Version for details).
    +
    +
    Returns:
    +
    Version of the component
    +
    @@ -235,6 +239,6 @@

    version

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteArrayFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteArrayFeeder.html index 590ece2096..e2ed5410f8 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteArrayFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteArrayFeeder.html @@ -2,10 +2,10 @@ - + ByteArrayFeeder (Jackson-core 2.12.0 API) - + @@ -261,6 +261,6 @@

    feedInput

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteBufferFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteBufferFeeder.html index ede934653f..d99d13532d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteBufferFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/ByteBufferFeeder.html @@ -2,10 +2,10 @@ - + ByteBufferFeeder (Jackson-core 2.12.0 API) - + @@ -249,6 +249,6 @@

    feedInput

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/NonBlockingInputFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/NonBlockingInputFeeder.html index 58460b5104..a9369df60c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/NonBlockingInputFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/NonBlockingInputFeeder.html @@ -2,10 +2,10 @@ - + NonBlockingInputFeeder (Jackson-core 2.12.0 API) - + @@ -145,7 +145,8 @@

    Method Summary

    void endOfInput()
    Method that should be called after last chunk of data to parse has been fed - (with feedInput in sub-class); can be called regardless of what needMoreInput() + (with feedInput in sub-class); can be called regardless of what + needMoreInput() returns.
    @@ -182,6 +183,11 @@

    needMoreInput

    Method called to check whether it is ok to feed more data: parser returns true if it has no more content to parse (and it is ok to feed more); otherwise false (and no data should yet be fed).
    +
    +
    Returns:
    +
    True if more input is needed (and can be fed); false if + there is still some input to decode
    +
    @@ -192,7 +198,8 @@

    needMoreInput

    endOfInput

    void endOfInput()
    Method that should be called after last chunk of data to parse has been fed - (with feedInput in sub-class); can be called regardless of what needMoreInput() + (with feedInput in sub-class); can be called regardless of what + needMoreInput() returns. After calling this method, no more data can be fed; and parser assumes no more data will be available.
    @@ -266,6 +273,6 @@

    endOfInput

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteArrayFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteArrayFeeder.html index 95f2968967..4828029e9b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteArrayFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteArrayFeeder.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.async.ByteArrayFeeder (Jackson-core 2.12.0 API) - + @@ -178,6 +178,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteBufferFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteBufferFeeder.html index 6e3aa4baa7..f70450cfff 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteBufferFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/ByteBufferFeeder.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.async.ByteBufferFeeder (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/NonBlockingInputFeeder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/NonBlockingInputFeeder.html index 74e2a9b1f9..31eecfddd7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/NonBlockingInputFeeder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/class-use/NonBlockingInputFeeder.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.async.NonBlockingInputFeeder (Jackson-core 2.12.0 API) - + @@ -234,6 +234,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-frame.html index 90b75f4908..d52800103a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.async (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-summary.html index c9f64787bf..6319483e4e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.async (Jackson-core 2.12.0 API) - + @@ -175,6 +175,6 @@

    Package com.fas -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-tree.html index 790219e5e0..ac7a471e1b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.async Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -135,6 +135,6 @@

    Interface Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-use.html index 7d78acc605..94f088e281 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/async/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.async (Jackson-core 2.12.0 API) - + @@ -220,6 +220,6 @@

    Uses -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/GeneratorBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/GeneratorBase.html index 5b052b9e2f..43cb7e520e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/GeneratorBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/GeneratorBase.html @@ -2,10 +2,10 @@ - + GeneratorBase (Jackson-core 2.12.0 API) - + @@ -349,14 +349,14 @@

    Method Summary

    JsonGenerator disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    JsonGenerator enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -842,6 +842,9 @@

    version

    version in interface Versioned
    Specified by:
    version in class JsonGenerator
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -858,13 +861,15 @@

    getCurrentValue

    getOutputContext().getCurrentValue();

    - Note that "current value" is NOT populated (or used) by Streaming parser; + Note that "current value" is NOT populated (or used) by Streaming parser or generators; 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.

    Overrides:
    getCurrentValue in class JsonGenerator
    +
    Returns:
    +
    "Current value" associated with the current context (state) of this generator
    @@ -883,6 +888,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonGenerator
    +
    Parameters:
    +
    v - Current value to assign for the current context of this generator
    @@ -899,6 +906,10 @@

    isEnabled

    Specified by:
    isEnabled in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled; false if not
    @@ -928,13 +939,15 @@

    getFeatureMask

    enable

    public JsonGenerator enable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    Specified by:
    enable in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to enable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -946,13 +959,15 @@

    enable

    disable

    public JsonGenerator disable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    Specified by:
    disable in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to disable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -974,7 +989,7 @@

    setFeatureMask

    newMask - Bitmask that defines which JsonGenerator.Features are enabled and which disabled
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This generator, to allow call chaining
    @@ -1001,6 +1016,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1038,7 +1055,7 @@

    useDefaultPrettyPrinter

    Specified by:
    useDefaultPrettyPrinter in class JsonGenerator
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1056,8 +1073,10 @@

    setCodec

    Specified by:
    setCodec in class JsonGenerator
    +
    Parameters:
    +
    oc - Codec to assign, if any; null if none
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1075,6 +1094,8 @@

    getCodec

    Specified by:
    getCodec in class JsonGenerator
    +
    Returns:
    +
    Codec assigned to this generator, if any; null if none
    @@ -1092,8 +1113,7 @@

    getOutputContext

    Specified by:
    getOutputContext in class JsonGenerator
    Returns:
    -
    Context object that can give information about logical - position within generated json content.
    +
    Stream output context (JsonStreamContext) associated with this generator
    @@ -1118,8 +1138,11 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGenerator
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1144,8 +1167,11 @@

    writeFieldName

    Specified by:
    writeFieldName in class JsonGenerator
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1169,8 +1195,11 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1192,8 +1221,11 @@

    writeRawValue

    Specified by:
    writeRawValue in class JsonGenerator
    +
    Parameters:
    +
    text - Textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1248,8 +1280,11 @@

    writeRawValue

    Overrides:
    writeRawValue in class JsonGenerator
    +
    Parameters:
    +
    text - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1285,7 +1320,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1310,8 +1346,11 @@

    writeObject

    Specified by:
    writeObject in class JsonGenerator
    +
    Parameters:
    +
    value - General POJO value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1333,8 +1372,11 @@

    writeTree

    Specified by:
    writeTree in class JsonGenerator
    +
    Parameters:
    +
    rootNode - TreeNode to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1356,7 +1398,8 @@

    flush

    Specified by:
    flush in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1387,7 +1430,7 @@

    close

    Specified by:
    close in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -1404,6 +1447,8 @@

    isClosed

    Specified by:
    isClosed in class JsonGenerator
    +
    Returns:
    +
    True if this generator instance has been closed
    @@ -1434,7 +1479,8 @@

    _verifyValueWrite

    typeMsg - Additional message used for generating exception message if value output is NOT legal in current generator output state.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1448,6 +1494,8 @@

    _constructDefaultPrettyPrinter

    Overridable factory method called to instantiate an appropriate PrettyPrinter for case of "just use the default one", when useDefaultPrettyPrinter() is called.
    +
    Returns:
    +
    Instance of "default" pretty printer to use
    Since:
    2.6
    @@ -1464,8 +1512,12 @@

    _asString

    Helper method used to serialize a BigDecimal as a String, for serialization, taking into account configuration settings
    +
    Parameters:
    +
    value - BigDecimal value to convert to String
    +
    Returns:
    +
    String representation of value
    Throws:
    -
    IOException
    +
    IOException - if there is a problem serializing value as String
    Since:
    2.7.7
    @@ -1483,8 +1535,6 @@

    _decodeSurrogate

    Throws:
    IOException
    -
    Since:
    -
    2.5
    @@ -1557,6 +1607,6 @@

    _decodeSurrogate

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserBase.html index 535ab9ea7e..6f1d290476 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserBase.html @@ -2,10 +2,10 @@ - + ParserBase (Jackson-core 2.12.0 API) - + @@ -1170,6 +1170,9 @@

    version

    version in interface Versioned
    Specified by:
    version in class JsonParser
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -1193,6 +1196,8 @@

    getCurrentValue

    Overrides:
    getCurrentValue in class JsonParser
    +
    Returns:
    +
    "Current value" associated with the current input context (state) of this parser
    @@ -1211,6 +1216,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonParser
    +
    Parameters:
    +
    v - Current value to assign for the current input context of this parser
    @@ -1227,6 +1234,10 @@

    enable

    Overrides:
    enable in class JsonParser
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -1243,6 +1254,10 @@

    disable

    Overrides:
    disable in class JsonParser
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -1260,8 +1275,10 @@

    setFeatureMask

    Overrides:
    setFeatureMask in class JsonParser
    +
    Parameters:
    +
    newMask - Bit mask that defines set of features to enable
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This parser, to allow call chaining
    @@ -1288,6 +1305,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -1323,8 +1342,11 @@

    getCurrentName

    Specified by:
    getCurrentName in class ParserMinimalBase
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1381,7 +1403,7 @@

    close

    Specified by:
    close in class ParserMinimalBase
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -1402,6 +1424,8 @@

    isClosed

    Specified by:
    isClosed in class ParserMinimalBase
    +
    Returns:
    +
    True if this parser instance has been closed
    @@ -1424,6 +1448,8 @@

    getParsingContext

    Specified by:
    getParsingContext in class ParserMinimalBase
    +
    Returns:
    +
    Stream input context (JsonStreamContext) associated with this parser
    @@ -1440,6 +1466,8 @@

    getTokenLocation

    Specified by:
    getTokenLocation in class JsonParser
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -1455,6 +1483,8 @@

    getCurrentLocation

    Specified by:
    getCurrentLocation in class JsonParser
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1520,7 +1550,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1688,6 +1719,10 @@

    isNaN

    Overrides:
    isNaN in class JsonParser
    +
    Returns:
    +
    True if the current token is of type JsonToken.VALUE_NUMBER_FLOAT + but represents a "Not a Number"; false for other tokens and regular + floating-point numbers
    @@ -1764,8 +1799,11 @@

    getNumberType

    Specified by:
    getNumberType in class JsonParser
    +
    Returns:
    +
    Type of current number, if parser points to numeric token; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1787,13 +1825,17 @@

    getIntValue

    exception.

    Note: if the resulting integer value falls outside range of - Java int, a InputCoercionException + Java int, a InputCoercionException may be thrown to indicate numeric overflow/underflow.

    Specified by:
    getIntValue in class JsonParser
    +
    Returns:
    +
    Current number value as int (if numeric token within + Java 32-bit signed int range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1820,8 +1862,12 @@

    getLongValue

    Specified by:
    getLongValue in class JsonParser
    +
    Returns:
    +
    Current number value as long (if numeric token within + Java 32-bit signed long range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1844,8 +1890,12 @@

    getBigIntegerValue

    Specified by:
    getBigIntegerValue in class JsonParser
    +
    Returns:
    +
    Current number value as BigInteger (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1872,8 +1922,12 @@

    getFloatValue

    Specified by:
    getFloatValue in class JsonParser
    +
    Returns:
    +
    Current number value as float (if numeric token within + Java float range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1900,8 +1954,12 @@

    getDoubleValue

    Specified by:
    getDoubleValue in class JsonParser
    +
    Returns:
    +
    Current number value as double (if numeric token within + Java double range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1921,8 +1979,12 @@

    getDecimalValue

    Specified by:
    getDecimalValue in class JsonParser
    +
    Returns:
    +
    Current number value as BigDecimal (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2375,6 +2437,6 @@

    _finishString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserMinimalBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserMinimalBase.html index 5a0e151ebe..5d32aa0680 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserMinimalBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/ParserMinimalBase.html @@ -2,10 +2,10 @@ - + ParserMinimalBase (Jackson-core 2.12.0 API) - + @@ -587,11 +587,7 @@

    Method Summary

    abstract String getCurrentName() -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    @@ -670,7 +666,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value. @@ -1553,7 +1549,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1616,6 +1613,9 @@

    getCurrentToken

    Specified by:
    getCurrentToken in class JsonParser
    +
    Returns:
    +
    Type of the token this parser currently points to, + if any: null before any tokens have been read, and
    @@ -1633,6 +1633,8 @@

    getCurrentTokenId

    Specified by:
    getCurrentTokenId in class JsonParser
    +
    Returns:
    +
    int matching one of constants from JsonTokenId.
    @@ -1679,6 +1681,10 @@

    hasTokenId

    Specified by:
    hasTokenId in class JsonParser
    +
    Parameters:
    +
    id - Token id to match (from (@link JsonTokenId})
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1702,6 +1708,10 @@

    hasToken

    Specified by:
    hasToken in class JsonParser
    +
    Parameters:
    +
    t - Token to match
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1732,7 +1742,7 @@

    isExpectedStartArrayToken

    Returns:
    True if the current token can be considered as a start-array marker (such JsonToken.START_ARRAY); - false if not.
    + false if not @@ -1749,6 +1759,10 @@

    isExpectedStartObjectToken

    Overrides:
    isExpectedStartObjectToken in class JsonParser
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.START_OBJECT); + false if not
    @@ -1768,6 +1782,10 @@

    isExpectedNumberIntToken

    Overrides:
    isExpectedNumberIntToken in class JsonParser
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.VALUE_NUMBER_INT); + false if not
    @@ -1799,7 +1817,8 @@

    nextValue

    parsers, JsonToken.NOT_AVAILABLE if no tokens were available yet)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1827,8 +1846,11 @@

    skipChildren

    Specified by:
    skipChildren in class JsonParser
    +
    Returns:
    +
    This parser, to allow call chaining
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1856,16 +1878,15 @@

    getCurrentName

    public abstract String getCurrentName()
                                throws IOException
    Description copied from class: JsonParser
    -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    Specified by:
    getCurrentName in class JsonParser
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1899,7 +1920,7 @@

    close

    Specified by:
    close in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -1920,6 +1941,8 @@

    isClosed

    Specified by:
    isClosed in class JsonParser
    +
    Returns:
    +
    True if this parser instance has been closed
    @@ -1942,6 +1965,8 @@

    getParsingContext

    Specified by:
    getParsingContext in class JsonParser
    +
    Returns:
    +
    Stream input context (JsonStreamContext) associated with this parser
    @@ -1985,6 +2010,8 @@

    getLastClearedToken

    Specified by:
    getLastClearedToken in class JsonParser
    +
    Returns:
    +
    Last cleared token, if any; null otherwise
    @@ -2027,8 +2054,12 @@

    getText

    Specified by:
    getText in class JsonParser
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2067,8 +2098,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class JsonParser
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2120,7 +2155,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2143,7 +2179,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2180,7 +2217,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2205,8 +2243,13 @@

    getValueAsBoolean

    Overrides:
    getValueAsBoolean in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to boolean is not possible
    +
    Returns:
    +
    boolean value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2220,7 +2263,7 @@

    getValueAsInt

    throws IOException
    Description copied from class: JsonParser
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -2231,8 +2274,12 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParser
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2257,8 +2304,13 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2283,8 +2335,12 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParser
    +
    Returns:
    +
    long value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2309,8 +2365,13 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to long is not possible
    +
    Returns:
    +
    long value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2335,8 +2396,13 @@

    getValueAsDouble

    Overrides:
    getValueAsDouble in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to double is not possible
    +
    Returns:
    +
    double value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2359,8 +2425,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class JsonParser
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2383,8 +2452,13 @@

    getValueAsString

    Specified by:
    getValueAsString in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2884,6 +2958,6 @@

    _ascii

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/GeneratorBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/GeneratorBase.html index a9f4291651..a13fec3841 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/GeneratorBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/GeneratorBase.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.base.GeneratorBase (Jackson-core 2.12.0 API) - + @@ -178,6 +178,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserBase.html index 162f177a37..bb5d5169c5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserBase.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.base.ParserBase (Jackson-core 2.12.0 API) - + @@ -214,6 +214,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserMinimalBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserMinimalBase.html index 759aa3627e..43b0db9f08 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserMinimalBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/class-use/ParserMinimalBase.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.base.ParserMinimalBase (Jackson-core 2.12.0 API) - + @@ -243,6 +243,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-frame.html index c9269ea459..233f6f713f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.base (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-summary.html index 2056e7835b..d67fa536c7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.base (Jackson-core 2.12.0 API) - + @@ -174,6 +174,6 @@

    Package com.fast -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-tree.html index 29b0b0f913..2bf651eb74 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.base Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -147,6 +147,6 @@

    Class Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-use.html index 45f7ae1eb1..9e8cfaa4d9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/base/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.base (Jackson-core 2.12.0 API) - + @@ -232,6 +232,6 @@

    Uses o -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.PaddingReadBehaviour.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.PaddingReadBehaviour.html index fe37dc54d6..404c76df08 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.PaddingReadBehaviour.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.PaddingReadBehaviour.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.Base64Variant.PaddingReadBehaviour (Jackson-core 2.12.0 API) - + @@ -195,6 +195,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.html index 1e4a9afb6f..3ac66b8525 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variant.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.Base64Variant (Jackson-core 2.12.0 API) - + @@ -647,6 +647,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variants.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variants.html index 13ccb72916..fc198c3e2c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variants.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Base64Variants.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.Base64Variants (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatFeature.html index 86a7ab54c3..b14cf6415b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatFeature.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.FormatFeature (Jackson-core 2.12.0 API) - + @@ -222,6 +222,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatSchema.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatSchema.html index 598e642785..b351929301 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatSchema.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/FormatSchema.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.FormatSchema (Jackson-core 2.12.0 API) - + @@ -126,7 +126,7 @@

    Uses of FormatSchema JsonGenerator.getSchema() -
    Method for accessing Schema that this parser uses, if any.
    +
    Method for accessing Schema that this generator uses, if any; null if none.
    @@ -281,6 +281,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JacksonException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JacksonException.html index 763bff5e5d..2c5614f2f9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JacksonException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JacksonException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JacksonException (Jackson-core 2.12.0 API) - + @@ -253,6 +253,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonEncoding.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonEncoding.html index c510642aec..f3742d442a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonEncoding.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonEncoding.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonEncoding (Jackson-core 2.12.0 API) - + @@ -323,6 +323,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.Feature.html index 4b42b8995a..8e4b140aad 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.Feature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonFactory.Feature (Jackson-core 2.12.0 API) - + @@ -231,6 +231,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.html index 87581cd17c..3accee1502 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactory.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonFactory (Jackson-core 2.12.0 API) - + @@ -227,7 +227,7 @@

    Uses of JsonFactory ObjectCodec.getJsonFactory()
    Deprecated.  -
    Since 2.1: Use ObjectCodec.getFactory() instead.
    +
    Use ObjectCodec.getFactory() instead.
    @@ -259,7 +259,7 @@

    Uses of JsonFactory JsonFactory.setOutputDecorator(OutputDecorator d)
    Deprecated.  -
    Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    +
    Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
    @@ -431,6 +431,6 @@

    Uses of -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactoryBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactoryBuilder.html index 6be55340cf..7d9f8ae2e1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactoryBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonFactoryBuilder.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonFactoryBuilder (Jackson-core 2.12.0 API) - + @@ -263,6 +263,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerationException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerationException.html index 1146f84b4c..3126e8572b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerationException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerationException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonGenerationException (Jackson-core 2.12.0 API) - + @@ -275,6 +275,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.Feature.html index fa3f60b68b..d1ea7eeda2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.Feature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonGenerator.Feature (Jackson-core 2.12.0 API) - + @@ -185,7 +185,7 @@

    Uses of abstract JsonGenerator JsonGenerator.disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    @@ -199,7 +199,7 @@

    Uses of abstract JsonGenerator JsonGenerator.enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -367,6 +367,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.html index 0854c0aff0..481e9523df 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonGenerator.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonGenerator (Jackson-core 2.12.0 API) - + @@ -274,14 +274,14 @@

    Uses of abstract JsonGenerator JsonGenerator.disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    abstract JsonGenerator JsonGenerator.enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -416,7 +416,7 @@

    Uses of void PrettyPrinter.writeObjectEntrySeparator(JsonGenerator gen) -
    Method called after an object entry (field:value) has been completely +
    Method called after an Object entry (field:value) has been completely output, and before another value is to be output.
    @@ -456,7 +456,10 @@

    Uses of abstract void ObjectCodec.writeTree(JsonGenerator gen, - TreeNode tree)  + TreeNode tree) +
    Method for serializing JSON content from given Tree instance, using + specified generator.
    + abstract void @@ -996,6 +999,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonLocation.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonLocation.html index 339d8112fb..ce3ecdd4e6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonLocation.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonLocation.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonLocation (Jackson-core 2.12.0 API) - + @@ -463,6 +463,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParseException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParseException.html index 310d5d88bc..a7ce07e70e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParseException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParseException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonParseException (Jackson-core 2.12.0 API) - + @@ -152,7 +152,7 @@

    Uses of JsonParseException -JsonParseException.withRequestPayload(RequestPayload p) +JsonParseException.withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -469,7 +469,11 @@

    Uses of boolean -DupDetector.isDup(String name)  +DupDetector.isDup(String name) +
    Method called to check whether a newly encountered property name would + be a duplicate within this context, and if not, update the state to remember + having seen the property name for checking more property names
    + @@ -583,6 +587,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.Feature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.Feature.html index 9ca01f94c3..98caa2ba4b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.Feature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.Feature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonParser.Feature (Jackson-core 2.12.0 API) - + @@ -223,7 +223,7 @@

    Uses of boolean JsonFactory.isEnabled(JsonParser.Feature f) -
    Checked whether specified parser feature is enabled.
    +
    Method for checking if the specified parser feature is enabled.
    @@ -346,6 +346,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.NumberType.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.NumberType.html index bba7ce43bd..2e0d4d132e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.NumberType.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.NumberType.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonParser.NumberType (Jackson-core 2.12.0 API) - + @@ -267,6 +267,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.html index 7e9231fb86..51229c9411 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonParser.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonParser (Jackson-core 2.12.0 API) - + @@ -515,7 +515,7 @@

    Uses of abstract <T extends TreeNode>
    T     ObjectCodec.readTree(JsonParser p) -
    Method to deserialize JSON content as tree expressed +
    Method for deserializing JSON content as tree expressed using set of TreeNode instances.
    @@ -1089,7 +1089,7 @@

    Uses of JsonParserSequence.createFlattened(boolean checkForExistingToken, JsonParser first, JsonParser second) -
    Method that will construct a parser (possibly a sequence) that +
    Method that will construct a sequence (possibly a sequence) that contains all given sub-parsers.
    @@ -1097,10 +1097,7 @@

    Uses of static JsonParserSequence JsonParserSequence.createFlattened(JsonParser first, JsonParser second) -
    Deprecated.  -
    Since 2.8 use JsonParserSequence.createFlattened(boolean, JsonParser, JsonParser) - instead
    -
    +
    Deprecated. 
    @@ -1190,6 +1187,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonPointer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonPointer.html index 0178ec62cb..e6a21ac5fb 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonPointer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonPointer.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonPointer (Jackson-core 2.12.0 API) - + @@ -183,7 +183,7 @@

    Uses of static JsonPointer -JsonPointer.compile(String input) +JsonPointer.compile(String expr)
    Factory method that parses given input and construct matching pointer instance, if it represents a valid JSON Pointer: if not, a IllegalArgumentException is thrown.
    @@ -213,17 +213,23 @@

    Uses of JsonPointer -JsonPointer.last() -
    Returns the leaf of current JSON Pointer expression.
    - +JsonPointer.last()  JsonPointer -JsonPointer.matchElement(int index)  +JsonPointer.matchElement(int index) +
    Method that may be called to check whether the pointer head (first segment) + matches specified Array index and if so, return + JsonPointer that represents rest of the path after match.
    + JsonPointer -JsonPointer.matchProperty(String name)  +JsonPointer.matchProperty(String name) +
    Method that may be called to check whether the pointer head (first segment) + matches specified Object property (by name) and if so, return + JsonPointer that represents rest of the path after match.
    + JsonPointer @@ -244,13 +250,13 @@

    Uses of JsonPointer JsonPointer.tail() -
    Accessor for getting a "sub-pointer", instance where current segment - has been removed and pointer includes rest of segments.
    +
    Accessor for getting a "sub-pointer" (or sub-path), instance where current segment + has been removed and pointer includes rest of the segments.
    static JsonPointer -JsonPointer.valueOf(String input) +JsonPointer.valueOf(String expr)
    Alias for compile(java.lang.String); added to make instances automatically deserializable by Jackson databind.
    @@ -305,9 +311,7 @@

    Uses of JsonPointer(String fullString, String segment, - JsonPointer next) -
    Constructor used for creating non-empty Segments
    - + JsonPointer next)  @@ -392,6 +396,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonProcessingException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonProcessingException.html index f2903c93a5..58c6fb1408 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonProcessingException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonProcessingException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonProcessingException (Jackson-core 2.12.0 API) - + @@ -350,6 +350,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonStreamContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonStreamContext.html index 640db5adea..59d0f65f4d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonStreamContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonStreamContext.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonStreamContext (Jackson-core 2.12.0 API) - + @@ -138,7 +138,10 @@

    Uses of abstract JsonStreamContext -JsonGenerator.getOutputContext()  +JsonGenerator.getOutputContext() +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    + abstract JsonStreamContext @@ -363,6 +366,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonToken.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonToken.html index 1c8b0203e0..8e24a7ad94 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonToken.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonToken.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonToken (Jackson-core 2.12.0 API) - + @@ -1079,6 +1079,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonTokenId.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonTokenId.html index 8899e0315b..7eefa59a74 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonTokenId.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonTokenId.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.JsonTokenId (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonpCharacterEscapes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonpCharacterEscapes.html index a66f03f251..9a4e713bb3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonpCharacterEscapes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/JsonpCharacterEscapes.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.JsonpCharacterEscapes (Jackson-core 2.12.0 API) - + @@ -169,6 +169,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/ObjectCodec.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/ObjectCodec.html index 8c1f8b1d95..0229095d94 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/ObjectCodec.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/ObjectCodec.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.ObjectCodec (Jackson-core 2.12.0 API) - + @@ -188,7 +188,7 @@

    Uses of abstract void -JsonParser.setCodec(ObjectCodec c) +JsonParser.setCodec(ObjectCodec oc)
    Setter that allows defining ObjectCodec associated with this parser, if any.
    @@ -627,6 +627,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/PrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/PrettyPrinter.html index dea786ca86..3ef2079bd5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/PrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/PrettyPrinter.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.PrettyPrinter (Jackson-core 2.12.0 API) - + @@ -297,6 +297,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/SerializableString.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/SerializableString.html index 8aceca44a5..c4495f1962 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/SerializableString.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/SerializableString.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.SerializableString (Jackson-core 2.12.0 API) - + @@ -539,6 +539,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadCapability.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadCapability.html index f5be441fe0..0972afeb39 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadCapability.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadCapability.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.StreamReadCapability (Jackson-core 2.12.0 API) - + @@ -318,6 +318,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadFeature.html index e3f8dd4fb9..08d415bbad 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamReadFeature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.StreamReadFeature (Jackson-core 2.12.0 API) - + @@ -174,7 +174,9 @@

    Uses of boolean -JsonFactory.isEnabled(StreamReadFeature f)  +JsonFactory.isEnabled(StreamReadFeature f) +
    Method for checking if the specified stream read feature is enabled.
    + @@ -230,6 +232,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteCapability.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteCapability.html index 2b607296e1..6f4b465d36 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteCapability.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteCapability.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.StreamWriteCapability (Jackson-core 2.12.0 API) - + @@ -180,7 +180,7 @@

    Uses of JacksonFeatureSet<StreamWriteCapability> JsonGenerator.getWriteCapabilities() -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    @@ -290,6 +290,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteFeature.html index ac16cb3a27..576091daf9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/StreamWriteFeature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.StreamWriteFeature (Jackson-core 2.12.0 API) - + @@ -168,11 +168,15 @@

    Uses of boolean -JsonGenerator.isEnabled(StreamWriteFeature f)  +JsonGenerator.isEnabled(StreamWriteFeature f) +
    Method for checking whether given feature is enabled.
    + boolean -JsonFactory.isEnabled(StreamWriteFeature f)  +JsonFactory.isEnabled(StreamWriteFeature f) +
    Check whether specified stream write feature is enabled.
    + @@ -228,6 +232,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TSFBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TSFBuilder.html index 636d788923..0cb9690220 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TSFBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TSFBuilder.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.TSFBuilder (Jackson-core 2.12.0 API) - + @@ -230,6 +230,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TokenStreamFactory.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TokenStreamFactory.html index b6064eb814..fa561ea2a7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TokenStreamFactory.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TokenStreamFactory.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.TokenStreamFactory (Jackson-core 2.12.0 API) - + @@ -174,6 +174,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeCodec.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeCodec.html index e8271ab21d..51bbd17a55 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeCodec.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeCodec.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.TreeCodec (Jackson-core 2.12.0 API) - + @@ -173,6 +173,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeNode.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeNode.html index 81462ec2a2..043a3d0e88 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeNode.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/TreeNode.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.TreeNode (Jackson-core 2.12.0 API) - + @@ -132,7 +132,7 @@

    Uses of abstract <T extends TreeNode>
    T     ObjectCodec.readTree(JsonParser p) -
    Method to deserialize JSON content as tree expressed +
    Method for deserializing JSON content as tree expressed using set of TreeNode instances.
    @@ -259,7 +259,10 @@

    Uses of abstract void ObjectCodec.writeTree(JsonGenerator gen, - TreeNode tree)  + TreeNode tree) +
    Method for serializing JSON content from given Tree instance, using + specified generator.
    + abstract void @@ -358,6 +361,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Version.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Version.html index 3acc57f4c0..fc3c824939 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Version.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Version.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.Version (Jackson-core 2.12.0 API) - + @@ -269,8 +269,9 @@

    Uses of static Version VersionUtil.packageVersionFor(Class<?> cls) -
    Loads version information by introspecting a class named - "PackageVersion" in the same package as the given class.
    +
    Deprecated.  +
    Since 2.12 simply use VersionUtil.versionFor(Class) instead
    +
    @@ -298,8 +299,8 @@

    Uses of static Version VersionUtil.versionFor(Class<?> cls) -
    Helper method that will try to load version information for specified - class.
    +
    Loads version information by introspecting a class named + "PackageVersion" in the same package as the given class.
    @@ -356,6 +357,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Versioned.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Versioned.html index a81d560447..926c87e50f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Versioned.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/class-use/Versioned.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.Versioned (Jackson-core 2.12.0 API) - + @@ -421,6 +421,6 @@

    Uses of

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/InputCoercionException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/InputCoercionException.html index 4af590c03f..cc7c05242f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/InputCoercionException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/InputCoercionException.html @@ -2,10 +2,10 @@ - + InputCoercionException (Jackson-core 2.12.0 API) - + @@ -376,6 +376,10 @@

    withParser

    Specified by:
    withParser in class StreamReadException
    +
    Parameters:
    +
    p - Parser instance to assign to this exception
    +
    Returns:
    +
    This exception instance to allow call chaining
    @@ -394,6 +398,10 @@

    withRequestPayload

    Specified by:
    withRequestPayload in class StreamReadException
    +
    Parameters:
    +
    p - Payload to assign to this exception
    +
    Returns:
    +
    This exception instance to allow call chaining
    @@ -488,6 +496,6 @@

    getTargetType

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/StreamReadException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/StreamReadException.html index 51960986c7..6acbce7424 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/StreamReadException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/StreamReadException.html @@ -2,10 +2,10 @@ - + StreamReadException (Jackson-core 2.12.0 API) - + @@ -279,7 +279,7 @@

    Method Summary

    abstract StreamReadException -withRequestPayload(RequestPayload p) +withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -412,6 +412,12 @@

    withParser

    to be accessed using getProcessor().

    NOTE: `this` instance is modified and no new instance is constructed. +

    +
    Parameters:
    +
    p - Parser instance to assign to this exception
    +
    Returns:
    +
    This exception instance to allow call chaining
    +
    @@ -420,11 +426,17 @@

    withParser

     @@ -492,6 +504,9 @@

    getMessage

    Overrides:
    getMessage in class JsonProcessingException
    +
    Returns:
    +
    Original message preceded by optional prefix and followed by + location information, message and location information separated by a linefeed
    @@ -564,6 +579,6 @@

    getMessage

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/InputCoercionException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/InputCoercionException.html index 52c65a5e36..3a432df7d6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/InputCoercionException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/InputCoercionException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.exc.InputCoercionException (Jackson-core 2.12.0 API) - + @@ -199,6 +199,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/StreamReadException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/StreamReadException.html index 0179bb90e8..078102d002 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/StreamReadException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/class-use/StreamReadException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.exc.StreamReadException (Jackson-core 2.12.0 API) - + @@ -171,7 +171,7 @@

    Uses of abstract StreamReadException -StreamReadException.withRequestPayload(RequestPayload p) +StreamReadException.withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -253,6 +253,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-frame.html index 1d48dbbc22..093767362c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.exc (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-summary.html index 0669680a74..05c45f2d2e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.exc (Jackson-core 2.12.0 API) - + @@ -162,6 +162,6 @@

    Package com.faste -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-tree.html index 570c9ce229..300b280947 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.exc Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -158,6 +158,6 @@

    Class Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-use.html index e5aa478ed3..4e5b6c37b3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/exc/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.exc (Jackson-core 2.12.0 API) - + @@ -248,6 +248,6 @@

    Uses of -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringGeneratorDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringGeneratorDelegate.html index 791b608d01..1967526666 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringGeneratorDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringGeneratorDelegate.html @@ -2,10 +2,10 @@ - + FilteringGeneratorDelegate (Jackson-core 2.12.0 API) - + @@ -312,7 +312,10 @@

    Method Summary

    JsonStreamContext -getOutputContext()  +getOutputContext() +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    + void @@ -559,19 +562,31 @@

    Method Summary

    void writeStartArray(int size)
    Method for writing start marker of an Array value, similar - to JsonGenerator.writeStartArray(), but also specifying how many + to JsonGenerator.writeStartArray(), + but also specifying how many elements will be written for the array before calling JsonGenerator.writeEndArray().
    void -writeStartArray(Object forValue)  +writeStartArray(Object forValue) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    + void writeStartArray(Object forValue, - int size)  + int size) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    + void @@ -835,12 +850,14 @@

    getMatchCount

  • getOutputContext

    public JsonStreamContext getOutputContext()
    +
    Description copied from class: JsonGenerator
    +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    Overrides:
    getOutputContext in class JsonGeneratorDelegate
    Returns:
    -
    Context object that can give information about logical - position within generated json content.
    +
    Stream output context (JsonStreamContext) associated with this generator
    • @@ -864,7 +881,8 @@

    writeStartArray

    Overrides:
    writeStartArray in class JsonGeneratorDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -878,7 +896,8 @@

    writeStartArray

    throws IOException
    Description copied from class: JsonGenerator
    Method for writing start marker of an Array value, similar - to JsonGenerator.writeStartArray(), but also specifying how many + to JsonGenerator.writeStartArray(), + but also specifying how many elements will be written for the array before calling JsonGenerator.writeEndArray().

    @@ -890,9 +909,10 @@

    writeStartArray

    size - Number of elements this array will have: actual number of values written (before matching call to JsonGenerator.writeEndArray() MUST match; generator MAY verify - this is the case.
    + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -904,11 +924,19 @@

    writeStartArray

    writeStartArray

    public void writeStartArray(Object forValue)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    Overrides:
    writeStartArray in class JsonGeneratorDelegate
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -921,11 +949,24 @@

    writeStartArray

    public void writeStartArray(Object forValue,
                             int size)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    Overrides:
    writeStartArray in class JsonGeneratorDelegate
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    +
    size - Number of elements this Array will have: actual + number of values written (before matching call to + JsonGenerator.writeEndArray() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -948,7 +989,8 @@

    writeEndArray

    Overrides:
    writeEndArray in class JsonGeneratorDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -972,7 +1014,8 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGeneratorDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -997,8 +1040,11 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGeneratorDelegate
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1027,8 +1073,15 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGeneratorDelegate
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    +
    size - Number of key/value pairs this Object will have: actual + number of entries written (before matching call to + JsonGenerator.writeEndObject() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1053,7 +1106,8 @@

    writeEndObject

    Overrides:
    writeEndObject in class JsonGeneratorDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1076,8 +1130,11 @@

    writeFieldName

    Overrides:
    writeFieldName in class JsonGeneratorDelegate
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1102,8 +1159,11 @@

    writeFieldName

    Overrides:
    writeFieldName in class JsonGeneratorDelegate
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1125,8 +1185,11 @@

    writeFieldId

    Overrides:
    writeFieldId in class JsonGeneratorDelegate
    +
    Parameters:
    +
    id - Field id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1147,8 +1210,11 @@

    writeString

    Overrides:
    writeString in class JsonGeneratorDelegate
    +
    Parameters:
    +
    value - Text value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1171,8 +1237,13 @@

    writeString

    Overrides:
    writeString in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first character of String value to write
    +
    len - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1196,8 +1267,11 @@

    writeString

    Overrides:
    writeString in class JsonGeneratorDelegate
    +
    Parameters:
    +
    value - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1216,14 +1290,23 @@

    writeString

    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. - If the reader is null, then write a null. - If len is < 0, then write all contents of the reader. - Otherwise, write only len characters.
    + If len is < 0, then write all contents of the reader. + Otherwise, write only len characters. +

    + Note: actual length of content available may exceed len but + can not be less than it: if not enough content available, a + JsonGenerationException will be thrown.

    Overrides:
    writeString in class JsonGeneratorDelegate
    +
    Parameters:
    +
    reader - Reader to use for reading Text value to write
    +
    len - Maximum Length of Text value to read (in chars, non-negative) + if known; -1 to indicate "read and write it all"
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer; or if length (len) is specified but + reader does not provide enough content
    @@ -1253,8 +1336,13 @@

    writeRawUTF8String

    Overrides:
    writeRawUTF8String in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1288,8 +1376,13 @@

    writeUTF8String

    Overrides:
    writeUTF8String in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1315,8 +1408,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Textual contents to include as-is in output.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1344,8 +1440,13 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - String that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1376,8 +1477,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1405,8 +1509,13 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Buffer that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1432,8 +1541,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGeneratorDelegate
    +
    Parameters:
    +
    c - Character to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1455,8 +1567,11 @@

    writeRawValue

    Overrides:
    writeRawValue in class JsonGeneratorDelegate
    +
    Parameters:
    +
    text - Textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1530,8 +1645,12 @@

    writeBinary

    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. +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1567,7 +1686,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1591,7 +1711,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1615,7 +1736,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1639,7 +1761,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1663,7 +1786,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1687,7 +1811,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1711,7 +1836,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1735,7 +1861,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1766,12 +1893,15 @@

    writeNumber

    Overrides:
    writeNumber in class JsonGeneratorDelegate
    +
    Parameters:
    +
    encodedValue - Textual (possibly format) number representation to write
    Throws:
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    UnsupportedOperationException - If underlying data format does not support numbers serialized textually AND if generator is not allowed to just output a String instead (Schema-based formats may require actual number, for example)
    -
    IOException
    @@ -1792,8 +1922,13 @@

    writeNumber

    Overrides:
    writeNumber in class JsonGeneratorDelegate
    +
    Parameters:
    +
    encodedValueBuffer - Buffer that contains the textual number representation to write
    +
    offset - Offset of the first character of value to write
    +
    length - Length of the value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    UnsupportedOperationException
    @@ -1816,8 +1951,11 @@

    writeBoolean

    Overrides:
    writeBoolean in class JsonGeneratorDelegate
    +
    Parameters:
    +
    v - Boolean value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1839,7 +1977,8 @@

    writeNull

    Overrides:
    writeNull in class JsonGeneratorDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1860,8 +1999,11 @@

    writeOmittedField

    Overrides:
    writeOmittedField in class JsonGeneratorDelegate
    +
    Parameters:
    +
    fieldName - Name of the field omitted
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1884,8 +2026,13 @@

    writeObjectId

    Overrides:
    writeObjectId in class JsonGeneratorDelegate
    +
    Parameters:
    +
    id - Native Object Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Object ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -1908,8 +2055,13 @@

    writeObjectRef

    Overrides:
    writeObjectRef in class JsonGeneratorDelegate
    +
    Parameters:
    +
    id - Referenced value, for which Object Id is expected to be written
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Object ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -1932,8 +2084,13 @@

    writeTypeId

    Overrides:
    writeTypeId in class JsonGeneratorDelegate
    +
    Parameters:
    +
    id - Native Type Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Type ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -2079,6 +2236,6 @@

    _checkRawValueWrite

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringParserDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringParserDelegate.html index 3387e9426b..67f3b532bb 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringParserDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/FilteringParserDelegate.html @@ -2,10 +2,10 @@ - + FilteringParserDelegate (Jackson-core 2.12.0 API) - + @@ -352,7 +352,8 @@

    Method Summary

    getBooleanValue()
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE.
    + JsonToken.VALUE_FALSE, to return matching boolean + value. @@ -373,11 +374,7 @@

    Method Summary

    String getCurrentName() -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    @@ -560,7 +557,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value. @@ -906,6 +903,9 @@

    getCurrentToken

    Overrides:
    getCurrentToken in class JsonParserDelegate
    +
    Returns:
    +
    Type of the token this parser currently points to, + if any: null before any tokens have been read, and
    @@ -946,6 +946,8 @@

    getCurrentTokenId

    Overrides:
    getCurrentTokenId in class JsonParserDelegate
    +
    Returns:
    +
    int matching one of constants from JsonTokenId.
    @@ -1015,6 +1017,10 @@

    hasTokenId

    Overrides:
    hasTokenId in class JsonParserDelegate
    +
    Parameters:
    +
    id - Token id to match (from (@link JsonTokenId})
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1038,6 +1044,10 @@

    hasToken

    Overrides:
    hasToken in class JsonParserDelegate
    +
    Parameters:
    +
    t - Token to match
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1068,7 +1078,7 @@

    isExpectedStartArrayToken

    Returns:
    True if the current token can be considered as a start-array marker (such JsonToken.START_ARRAY); - false if not.
    + false if not @@ -1085,6 +1095,10 @@

    isExpectedStartObjectToken

    Overrides:
    isExpectedStartObjectToken in class JsonParserDelegate
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.START_OBJECT); + false if not
    @@ -1097,10 +1111,19 @@

    getCurrentLocation

    public JsonLocation getCurrentLocation()
    Description copied from class: JsonParser
    Method that returns location of the last processed character; - usually for error reporting purposes.
    + usually for error reporting purposes. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + report specific boundary locations (start or end locations of tokens) + and others only return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library)

    Overrides:
    getCurrentLocation in class JsonParserDelegate
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1123,6 +1146,8 @@

    getParsingContext

    Overrides:
    getParsingContext in class JsonParserDelegate
    +
    Returns:
    +
    Stream input context (JsonStreamContext) associated with this parser
    @@ -1135,16 +1160,15 @@

    getCurrentName

    public String getCurrentName()
                       throws IOException
    Description copied from class: JsonParser
    -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    Overrides:
    getCurrentName in class JsonParserDelegate
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1188,6 +1212,8 @@

    getLastClearedToken

    Overrides:
    getLastClearedToken in class JsonParserDelegate
    +
    Returns:
    +
    Last cleared token, if any; null otherwise
    @@ -1234,7 +1260,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1299,7 +1326,8 @@

    nextValue

    parsers, JsonToken.NOT_AVAILABLE if no tokens were available yet)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1317,8 +1345,11 @@

    skipChildren

    Overrides:
    skipChildren in class JsonParserDelegate
    +
    Returns:
    +
    This parser, to allow call chaining
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1338,8 +1369,12 @@

    getText

    Overrides:
    getText in class JsonParserDelegate
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1407,8 +1442,12 @@

    getTextCharacters

    Overrides:
    getTextCharacters in class JsonParserDelegate
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1431,7 +1470,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1454,7 +1494,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1477,8 +1518,12 @@

    getBigIntegerValue

    Overrides:
    getBigIntegerValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as BigInteger (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1493,17 +1538,20 @@

    getBooleanValue

    Description copied from class: JsonParser
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE. -

    - Note: if the token is not of above-mentioned boolean types, - an integer, but its value falls - outside of range of Java long, a JsonParseException - may be thrown to indicate numeric overflow/underflow.

    + JsonToken.VALUE_FALSE, to return matching boolean + value. + If the current token is of some other type, JsonParseException + will be thrown
    Overrides:
    getBooleanValue in class JsonParserDelegate
    +
    Returns:
    +
    True if current token is JsonToken.VALUE_TRUE, + false if current token is JsonToken.VALUE_FALSE; + otherwise throws JsonParseException
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1519,19 +1567,29 @@

    getByteValue

    Numeric accessor that can be called when the current token is of type JsonToken.VALUE_NUMBER_INT and it can be expressed as a value of Java byte primitive type. + Note that in addition to "natural" input range of [-128, 127], + this also allows "unsigned 8-bit byte" values [128, 255]: + but for this range value will be translated by truncation, leading + to sign change. +

    It can also be called for JsonToken.VALUE_NUMBER_FLOAT; if so, it is equivalent to calling JsonParser.getDoubleValue() and then casting; except for possible overflow/underflow exception.

    Note: if the resulting integer value falls outside range of - Java byte, a InputCoercionException + [-128, 255], + a InputCoercionException will be thrown to indicate numeric overflow/underflow.

    Overrides:
    getByteValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as byte (if numeric token within + range of [-128, 255]); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1558,8 +1616,12 @@

    getShortValue

    Overrides:
    getShortValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as short (if numeric token within + Java 16-bit signed short range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1579,8 +1641,12 @@

    getDecimalValue

    Overrides:
    getDecimalValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as BigDecimal (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1607,8 +1673,12 @@

    getDoubleValue

    Overrides:
    getDoubleValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as double (if numeric token within + Java double range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1635,8 +1705,12 @@

    getFloatValue

    Overrides:
    getFloatValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as float (if numeric token within + Java float range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1658,13 +1732,17 @@

    getIntValue

    exception.

    Note: if the resulting integer value falls outside range of - Java int, a InputCoercionException + Java int, a InputCoercionException may be thrown to indicate numeric overflow/underflow.

    Overrides:
    getIntValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as int (if numeric token within + Java 32-bit signed int range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1691,8 +1769,12 @@

    getLongValue

    Overrides:
    getLongValue in class JsonParserDelegate
    +
    Returns:
    +
    Current number value as long (if numeric token within + Java 32-bit signed long range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1712,8 +1794,11 @@

    getNumberType

    Overrides:
    getNumberType in class JsonParserDelegate
    +
    Returns:
    +
    Type of current number, if parser points to numeric token; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1754,7 +1839,7 @@

    getValueAsInt

    throws IOException
    Description copied from class: JsonParser
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -1765,8 +1850,12 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParserDelegate
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1791,8 +1880,13 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParserDelegate
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1817,8 +1911,12 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParserDelegate
    +
    Returns:
    +
    long value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1843,8 +1941,13 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParserDelegate
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to long is not possible
    +
    Returns:
    +
    long value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1869,8 +1972,12 @@

    getValueAsDouble

    Overrides:
    getValueAsDouble in class JsonParserDelegate
    +
    Returns:
    +
    double value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1895,8 +2002,13 @@

    getValueAsDouble

    Overrides:
    getValueAsDouble in class JsonParserDelegate
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to double is not possible
    +
    Returns:
    +
    double value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1921,8 +2033,12 @@

    getValueAsBoolean

    Overrides:
    getValueAsBoolean in class JsonParserDelegate
    +
    Returns:
    +
    boolean value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1947,8 +2063,13 @@

    getValueAsBoolean

    Overrides:
    getValueAsBoolean in class JsonParserDelegate
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to boolean is not possible
    +
    Returns:
    +
    boolean value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1971,8 +2092,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class JsonParserDelegate
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1995,8 +2119,13 @@

    getValueAsString

    Overrides:
    getValueAsString in class JsonParserDelegate
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2022,8 +2151,12 @@

    getEmbeddedObject

    Overrides:
    getEmbeddedObject in class JsonParserDelegate
    +
    Returns:
    +
    Embedded value (usually of "native" type supported by format) + for the current token, if any; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2060,7 +2193,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2085,7 +2219,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2099,10 +2234,18 @@

    getTokenLocation

    Description copied from class: JsonParser
    Method that return the starting location of the current token; that is, position of the first character from input - that starts the current token.
    + that starts the current token. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library)

    Overrides:
    getTokenLocation in class JsonParserDelegate
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -2184,6 +2327,6 @@

    _filterContext

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/JsonPointerBasedFilter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/JsonPointerBasedFilter.html index 213e634a48..91e9d5ebd2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/JsonPointerBasedFilter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/JsonPointerBasedFilter.html @@ -2,10 +2,10 @@ - + JsonPointerBasedFilter (Jackson-core 2.12.0 API) - + @@ -552,6 +552,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.Inclusion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.Inclusion.html index e3255a573d..8ec5f0abe1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.Inclusion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.Inclusion.html @@ -2,10 +2,10 @@ - + TokenFilter.Inclusion (Jackson-core 2.12.0 API) - + @@ -373,6 +373,6 @@

    valueOf

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.html index dbc25a6101..f7c8825f69 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilter.html @@ -2,10 +2,10 @@ - + TokenFilter (Jackson-core 2.12.0 API) - + @@ -909,6 +909,6 @@

    _includeScalar

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilterContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilterContext.html index 6989ceabc8..c5d4f37437 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilterContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/TokenFilterContext.html @@ -2,10 +2,10 @@ - + TokenFilterContext (Jackson-core 2.12.0 API) - + @@ -634,6 +634,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonStreamContext
    +
    Parameters:
    +
    v - Current value to assign to this context
    @@ -650,6 +652,8 @@

    getParent

    Specified by:
    getParent in class JsonStreamContext
    +
    Returns:
    +
    Parent context of this context, if any; null for Root contexts
    @@ -667,6 +671,8 @@

    getCurrentName

    Specified by:
    getCurrentName in class JsonStreamContext
    +
    Returns:
    +
    Current field name within context, if any; null if none
    @@ -680,6 +686,9 @@

    hasCurrentName

    Overrides:
    hasCurrentName in class JsonStreamContext
    +
    Returns:
    +
    True if a call to JsonStreamContext.getCurrentName() would return non-null + name; false otherwise
    @@ -740,6 +749,9 @@

    toString

    Overrides:
    toString in class JsonStreamContext
    +
    Returns:
    +
    Simple developer-readable description this context layer + (note: NOT constructed with parents, unlike JsonStreamContext.pathAsPointer())
    @@ -812,6 +824,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringGeneratorDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringGeneratorDelegate.html index 1c16865597..4e7d202bc0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringGeneratorDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringGeneratorDelegate.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.FilteringGeneratorDelegate (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringParserDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringParserDelegate.html index 05c03c54e4..00b2eafa85 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringParserDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/FilteringParserDelegate.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.FilteringParserDelegate (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/JsonPointerBasedFilter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/JsonPointerBasedFilter.html index facb9a0445..7a3d59c0f7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/JsonPointerBasedFilter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/JsonPointerBasedFilter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.JsonPointerBasedFilter (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.Inclusion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.Inclusion.html index d7959d8370..b975176292 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.Inclusion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.Inclusion.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.TokenFilter.Inclusion (Jackson-core 2.12.0 API) - + @@ -213,6 +213,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.html index f9e0b4e9e0..18e56779a0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.TokenFilter (Jackson-core 2.12.0 API) - + @@ -378,6 +378,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilterContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilterContext.html index 241df1ca1b..1554c2efd2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilterContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/class-use/TokenFilterContext.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.filter.TokenFilterContext (Jackson-core 2.12.0 API) - + @@ -268,6 +268,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-frame.html index 690eed237e..371b634494 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.filter (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-summary.html index 9b6188b507..e3f15e763d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.filter (Jackson-core 2.12.0 API) - + @@ -189,6 +189,6 @@

    Package com.fasterxml.jackson.core.filter -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-tree.html index 631f9d0b6d..d42cb547f9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.filter Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -173,6 +173,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-use.html index a61d21fdb7..faeb5022f1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/filter/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.filter (Jackson-core 2.12.0 API) - + @@ -168,6 +168,6 @@

    Uses -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatDetector.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatDetector.html index cd2bf1bc1c..b0d766b20d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatDetector.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatDetector.html @@ -2,10 +2,10 @@ - + DataFormatDetector (Jackson-core 2.12.0 API) - + @@ -556,6 +556,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatMatcher.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatMatcher.html index d94b2e2c20..3e17bfda0d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatMatcher.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/DataFormatMatcher.html @@ -2,10 +2,10 @@ - + DataFormatMatcher (Jackson-core 2.12.0 API) - + @@ -502,6 +502,6 @@

    getDataStream

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.Std.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.Std.html index 95a978b2a1..cfa4d50458 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.Std.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.Std.html @@ -2,10 +2,10 @@ - + InputAccessor.Std (Jackson-core 2.12.0 API) - + @@ -514,6 +514,6 @@

    createMatcher

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.html index d5c34084bd..a7cc1ed1e5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/InputAccessor.html @@ -2,10 +2,10 @@ - + InputAccessor (Jackson-core 2.12.0 API) - + @@ -297,6 +297,6 @@

    reset

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/MatchStrength.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/MatchStrength.html index d799378256..d89952d2c3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/MatchStrength.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/MatchStrength.html @@ -2,10 +2,10 @@ - + MatchStrength (Jackson-core 2.12.0 API) - + @@ -422,6 +422,6 @@

    valueOf

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatDetector.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatDetector.html index e02472e606..2c956507ce 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatDetector.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatDetector.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.format.DataFormatDetector (Jackson-core 2.12.0 API) - + @@ -184,6 +184,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatMatcher.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatMatcher.html index 3c2fa5f024..5531c86dc9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatMatcher.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/DataFormatMatcher.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.format.DataFormatMatcher (Jackson-core 2.12.0 API) - + @@ -190,6 +190,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.Std.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.Std.html index 4ca397c9a0..a8846f743e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.Std.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.Std.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.format.InputAccessor.Std (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.html index ee1c0f38e2..d8333630ed 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/InputAccessor.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.format.InputAccessor (Jackson-core 2.12.0 API) - + @@ -128,17 +128,11 @@

    Uses of MatchStrength -JsonFactory.hasFormat(InputAccessor acc) -
    Convenience method for trying to determine whether input via given accessor - is of format type supported by this factory.
    - +JsonFactory.hasFormat(InputAccessor acc)  protected MatchStrength -JsonFactory.hasJSONFormat(InputAccessor acc) -
    Helper method that can be called to determine if content accessed - using given accessor seems to be JSON content.
    - +JsonFactory.hasJSONFormat(InputAccessor acc)  @@ -237,6 +231,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/MatchStrength.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/MatchStrength.html index 73288d55ea..2081e969e2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/MatchStrength.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/class-use/MatchStrength.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.format.MatchStrength (Jackson-core 2.12.0 API) - + @@ -128,17 +128,11 @@

    Uses of MatchStrength -JsonFactory.hasFormat(InputAccessor acc) -
    Convenience method for trying to determine whether input via given accessor - is of format type supported by this factory.
    - +JsonFactory.hasFormat(InputAccessor acc)  protected MatchStrength -JsonFactory.hasJSONFormat(InputAccessor acc) -
    Helper method that can be called to determine if content accessed - using given accessor seems to be JSON content.
    - +JsonFactory.hasJSONFormat(InputAccessor acc)  @@ -325,6 +319,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-frame.html index 15b0e952c3..7d6c5e375c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.format (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-summary.html index 99402d436f..284015b03d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.format (Jackson-core 2.12.0 API) - + @@ -206,6 +206,6 @@

    Package com.fa -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-tree.html index 17af7ccf08..b48f51f7fc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.format Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -152,6 +152,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-use.html index d447f022f9..1a9aafd456 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/format/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.format (Jackson-core 2.12.0 API) - + @@ -247,6 +247,6 @@

    Uses -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharTypes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharTypes.html index 7d80881a3c..54d0d0e131 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharTypes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharTypes.html @@ -2,10 +2,10 @@ - + CharTypes (Jackson-core 2.12.0 API) - + @@ -508,6 +508,10 @@

    get7BitOutputEscapes

    Value of 0 means "no escaping"; other positive values that value is character to use after backslash; and negative values that generic (backslash - u) escaping is to be used. +
    +
    Returns:
    +
    128-entry int[] that contains escape definitions
    +
    @@ -520,6 +524,11 @@

    get7BitOutputEscapes

    Alternative to get7BitOutputEscapes() when a non-standard quote character is used.
    +
    Parameters:
    +
    quoteChar - Character used for quoting textual values and property names; + usually double-quote but sometimes changed to single-quote (apostrophe)
    +
    Returns:
    +
    128-entry int[] that contains escape definitions
    Since:
    2.10
    @@ -631,6 +640,6 @@

    copyHexBytes

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharacterEscapes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharacterEscapes.html index 9d5e4cd6f8..0aa30875b7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharacterEscapes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/CharacterEscapes.html @@ -2,10 +2,10 @@ - + CharacterEscapes (Jackson-core 2.12.0 API) - + @@ -353,6 +353,12 @@

    getEscapeSequence

    It can be called for any character, but typically is called for either for ASCII characters for which custom escape sequence is needed; or for any non-ASCII character. +
    +
    Parameters:
    +
    ch - Character to look escape sequence for
    +
    Returns:
    +
    Escape sequence to use for the character, if any; null if not
    +
    @@ -366,6 +372,11 @@

    standardAsciiEscapesForJSON

    escape definitions; this is useful when just wanting to slightly customize definitions. Caller can modify this array as it sees fit and usually returns modified instance via     getEscapeCodesForAscii() +
    +
    Returns:
    +
    Set of escapes, similar to getEscapeCodesForAscii() (array of + 128 ints), but a copy that caller owns and is free to modify
    +
    @@ -437,6 +448,6 @@

    standardAsciiEscapesForJSON

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/DataOutputAsStream.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/DataOutputAsStream.html index 7d18bfd99c..bb76ad3bbc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/DataOutputAsStream.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/DataOutputAsStream.html @@ -2,10 +2,10 @@ - + DataOutputAsStream (Jackson-core 2.12.0 API) - + @@ -377,6 +377,6 @@

    write

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/IOContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/IOContext.html index 81882194d7..eeee937afa 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/IOContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/IOContext.html @@ -2,10 +2,10 @@ - + IOContext (Jackson-core 2.12.0 API) - + @@ -257,11 +257,16 @@

    Method Summary

    byte[] -allocBase64Buffer()  +allocBase64Buffer() +
    Method for recycling or allocation byte buffer of "base 64 encode/decode" type.
    + byte[] -allocBase64Buffer(int minSize)  +allocBase64Buffer(int minSize) +
    Variant of allocBase64Buffer() that specifies smallest acceptable + buffer size.
    + char[] @@ -274,13 +279,15 @@

    Method Summary

    byte[] allocReadIOBuffer() -
    - Note: the method can only be called once during its life cycle.
    +
    Method for recycling or allocation byte buffer of "read I/O" type.
    byte[] -allocReadIOBuffer(int minSize)  +allocReadIOBuffer(int minSize) +
    Variant of allocReadIOBuffer() that specifies smallest acceptable + buffer size.
    + char[] @@ -292,11 +299,16 @@

    Method Summary

    byte[] -allocWriteEncodingBuffer()  +allocWriteEncodingBuffer() +
    Method for recycling or allocation byte buffer of "write encoding" type.
    + byte[] -allocWriteEncodingBuffer(int minSize)  +allocWriteEncodingBuffer(int minSize) +
    Variant of allocWriteEncodingBuffer() that specifies smallest acceptable + buffer size.
    + TextBuffer @@ -530,10 +542,6 @@

    setEncoding

  • withEncoding

    public IOContext withEncoding(JsonEncoding enc)
    -
    -
    Since:
    -
    1.6
    -
    • @@ -579,9 +587,14 @@

    constructTextBuffer

  • allocReadIOBuffer

    public byte[] allocReadIOBuffer()
    -

    +

    Method for recycling or allocation byte buffer of "read I/O" type. +

    Note: the method can only be called once during its life cycle. This is to protect against accidental sharing.

    +
    +
    Returns:
    +
    Allocated or recycled byte buffer
    +
    •  @@ -591,7 +604,13 @@

    allocReadIOBuffer

  • allocReadIOBuffer

    public byte[] allocReadIOBuffer(int minSize)
    +
    Variant of allocReadIOBuffer() that specifies smallest acceptable + buffer size.
    +
    Parameters:
    +
    minSize - Minimum size of the buffer to recycle or allocate
    +
    Returns:
    +
    Allocated or recycled byte buffer
    Since:
    2.4
    @@ -604,6 +623,14 @@

    allocReadIOBuffer

  • allocWriteEncodingBuffer

    public byte[] allocWriteEncodingBuffer()
    +
    Method for recycling or allocation byte buffer of "write encoding" type. +

    + Note: the method can only be called once during its life cycle. + This is to protect against accidental sharing.

    +
    +
    Returns:
    +
    Allocated or recycled byte buffer
    +
    • @@ -613,7 +640,13 @@

    allocWriteEncodingBuffer

  • allocWriteEncodingBuffer

    public byte[] allocWriteEncodingBuffer(int minSize)
    +
    Variant of allocWriteEncodingBuffer() that specifies smallest acceptable + buffer size.
    +
    Parameters:
    +
    minSize - Minimum size of the buffer to recycle or allocate
    +
    Returns:
    +
    Allocated or recycled byte buffer
    Since:
    2.4
    @@ -626,9 +659,13 @@

    allocWriteEncodingBuffer

  • allocBase64Buffer

    public byte[] allocBase64Buffer()
    +
    Method for recycling or allocation byte buffer of "base 64 encode/decode" type. +

    + Note: the method can only be called once during its life cycle. + This is to protect against accidental sharing.

    -
    Since:
    -
    2.1
    +
    Returns:
    +
    Allocated or recycled byte buffer
    • @@ -639,7 +676,13 @@

    allocBase64Buffer

  • allocBase64Buffer

    public byte[] allocBase64Buffer(int minSize)
    +
    Variant of allocBase64Buffer() that specifies smallest acceptable + buffer size.
    +
    Parameters:
    +
    minSize - Minimum size of the buffer to recycle or allocate
    +
    Returns:
    +
    Allocated or recycled byte buffer
    Since:
    2.9
    @@ -661,10 +704,6 @@

    allocTokenBuffer

  • allocTokenBuffer

    public char[] allocTokenBuffer(int minSize)
    -
    -
    Since:
    -
    2.4
    -
    • @@ -694,6 +733,10 @@

    releaseReadIOBuffer

    public void releaseReadIOBuffer(byte[] buf)
    Method to call when all the processing buffers can be safely recycled.
    +
    +
    Parameters:
    +
    buf - Buffer instance to release (return for recycling)
    +
     @@ -839,6 +882,6 @@

    _verifyRelease

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/InputDecorator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/InputDecorator.html index 93c698b75e..fe2fc9a1ad 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/InputDecorator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/InputDecorator.html @@ -2,10 +2,10 @@ - + InputDecorator (Jackson-core 2.12.0 API) - + @@ -259,7 +259,7 @@

    decorate

    InputStream to use; either 'in' as is, or decorator version that typically delogates to 'in'
    Throws:
    -
    IOException
    +
    IOException - if construction of InputStream fails
    @@ -291,7 +291,7 @@

    decorate

    Either InputStream to use as input source; or null to indicate that contents are to be processed as-is by caller
    Throws:
    -
    IOException
    +
    IOException - if construction of InputStream fails
    @@ -320,7 +320,7 @@

    decorate

    InputStream to use; either 'input' as is, or decorator version that typically delogates to 'input'
    Throws:
    -
    IOException
    +
    IOException - if construction of DataInput fails
    Since:
    2.8
    @@ -349,7 +349,7 @@

    decorate

    Reader to use; either passed in argument, or something that calls it (for example, a FilterReader)
    Throws:
    -
    IOException
    +
    IOException - if construction of Reader fails
    @@ -422,6 +422,6 @@

    decorate

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonEOFException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonEOFException.html index ef8d258ad4..ab6de2fea6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonEOFException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonEOFException.html @@ -2,10 +2,10 @@ - + JsonEOFException (Jackson-core 2.12.0 API) - + @@ -331,6 +331,10 @@

    getTokenBeingDecoded

    public JsonToken getTokenBeingDecoded()
    Accessor for possibly available information about token that was being decoded while encountering end of input.
    +
    +
    Returns:
    +
    JsonToken that was being decoded while encountering end-of-input
    +
    @@ -402,6 +406,6 @@

    getTokenBeingDecoded

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonStringEncoder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonStringEncoder.html index dbb0edb6b5..44f1b9de87 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonStringEncoder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/JsonStringEncoder.html @@ -2,10 +2,10 @@ - + JsonStringEncoder (Jackson-core 2.12.0 API) - + @@ -162,8 +162,8 @@

    Method Summary

    byte[] encodeAsUTF8(String text) -
    Will encode given String as UTF-8 (without any quoting), return - resulting byte array.
    +
    Will encode given String as UTF-8 (without any escaping) and return + the resulting byte array.
    @@ -190,15 +190,16 @@

    Method Summary

    char[] quoteAsString(String input) -
    Method that will quote text contents using JSON standard quoting, - and return results as a character array
    +
    Method that will escape text contents using JSON standard escaping, + and return results as a character array.
    byte[] quoteAsUTF8(String text) -
    Will quote given JSON String value using standard quoting, encode - results as UTF-8, and return result as a byte array.
    +
    Method that will escape text contents using JSON standard escaping, + encode resulting String as UTF-8 bytes + and return results as a byte array.
    @@ -249,6 +250,10 @@

    getInstance

    public static JsonStringEncoder getInstance()
    Factory method for getting an instance; this is either recycled per-thread instance, or a newly constructed one.
    +
    +
    Returns:
    +
    Static stateless encoder instance
    +
    @@ -258,8 +263,14 @@

    getInstance

  • quoteAsString

    public char[] quoteAsString(String input)
    -
    Method that will quote text contents using JSON standard quoting, - and return results as a character array
    +
    Method that will escape text contents using JSON standard escaping, + and return results as a character array.
    +
    +
    Parameters:
    +
    input - Value String to process
    +
    Returns:
    +
    JSON-escaped String matching input
    +
    • @@ -271,6 +282,10 @@

    quoteAsString

    public char[] quoteAsString(CharSequence input)
    Overloaded variant of quoteAsString(String).
    +
    Parameters:
    +
    input - Value CharSequence to process
    +
    Returns:
    +
    JSON-escaped String matching input
    Since:
    2.10
    @@ -288,6 +303,9 @@

    quoteAsString

    and append results to a supplied StringBuilder. Use this variant if you have e.g. a StringBuilder and want to avoid superfluous copying of it.
    +
    Parameters:
    +
    input - Value CharSequence to process
    +
    output - StringBuilder to append escaped contents to
    Since:
    2.8
    @@ -300,8 +318,15 @@

    quoteAsString

  • quoteAsUTF8

    public byte[] quoteAsUTF8(String text)
    -
    Will quote given JSON String value using standard quoting, encode - results as UTF-8, and return result as a byte array.
    +
    Method that will escape text contents using JSON standard escaping, + encode resulting String as UTF-8 bytes + and return results as a byte array.
    +
    +
    Parameters:
    +
    text - Value String to process
    +
    Returns:
    +
    UTF-8 encoded bytes of JSON-escaped text
    +
    • @@ -311,8 +336,14 @@

    quoteAsUTF8

  • encodeAsUTF8

    public byte[] encodeAsUTF8(String text)
    -
    Will encode given String as UTF-8 (without any quoting), return - resulting byte array.
    +
    Will encode given String as UTF-8 (without any escaping) and return + the resulting byte array.
    +
    +
    Parameters:
    +
    text - Value String to process
    +
    Returns:
    +
    UTF-8 encoded bytes of text (without any escaping)
    +
    • @@ -324,6 +355,10 @@

    encodeAsUTF8

    public byte[] encodeAsUTF8(CharSequence text)
    Overloaded variant of encodeAsUTF8(String).
    +
    Parameters:
    +
    text - Value CharSequence to process
    +
    Returns:
    +
    UTF-8 encoded bytes of text (without any escaping)
    Since:
    2.11
    @@ -398,6 +433,6 @@

    encodeAsUTF8

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/MergedStream.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/MergedStream.html index d8684a9a6a..f9d346e627 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/MergedStream.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/MergedStream.html @@ -2,10 +2,10 @@ - + MergedStream (Jackson-core 2.12.0 API) - + @@ -460,6 +460,6 @@

    skip

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberInput.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberInput.html index 91ab6a3bc1..caea99cbfd 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberInput.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberInput.html @@ -2,10 +2,10 @@ - + NumberInput (Jackson-core 2.12.0 API) - + @@ -225,7 +225,7 @@

    Method Summary

    parseInt(char[] ch, int off, int len) -
    Fast method for parsing integers that are known to fit into +
    Fast method for parsing unsigned integers that are known to fit into regular 32-bit signed int type.
    @@ -244,7 +244,9 @@

    Method Summary

    static long -parseLong(String s)  +parseLong(String s) +
    Similar to parseInt(String) but for long values.
    + @@ -332,7 +343,18 @@

    parseInt

    parseInt

    public static int parseInt(String s)
    Helper method to (more) efficiently parse integer numbers from - String values.
    + String values. Input String must be simple Java integer value. + No range checks are made to verify that the value fits in 32-bit Java int: + caller is expected to only calls this in cases where this can be guaranteed + (basically: number of digits does not exceed 9) +

    + NOTE: semantics differ significantly from parseInt(char[], int, int).

    +
    +
    Parameters:
    +
    s - String that contains integer value to decode
    +
    Returns:
    +
    Decoded int value
    +
    @@ -353,6 +375,13 @@

    parseLong

  • parseLong

    public static long parseLong(String s)
    +
    Similar to parseInt(String) but for long values.
    +
    +
    Parameters:
    +
    s - String that contains long value to decode
    +
    Returns:
    +
    Decoded long value
    +
    • @@ -371,8 +400,14 @@

    inLongRange

    if 'negative' is set to true).
    Parameters:
    +
    ch - Buffer that contains long value to check
    +
    off - Offset of the first digit character in buffer
    +
    len - Length of the number to decode (in characters)
    negative - Whether original number had a minus sign (which is NOT passed to this method) or not
    +
    Returns:
    +
    True if specified String representation is within Java + long range; false if not.
    @@ -388,8 +423,12 @@

    inLongRange

    with String argument
    Parameters:
    +
    s - String that contains long value to check
    negative - Whether original number had a minus sign (which is NOT passed to this method) or not
    +
    Returns:
    +
    True if specified String representation is within Java + long range; false if not.
    @@ -550,6 +589,6 @@

    parseBigDecimal

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberOutput.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberOutput.html index f2dc058c6e..5e7f532ad0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberOutput.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/NumberOutput.html @@ -2,10 +2,10 @@ - + NumberOutput (Jackson-core 2.12.0 API) - + @@ -171,7 +171,10 @@

    Method Summary

    static int outputInt(int v, char[] b, - int off)  + int off) +
    Method for appending value of given int value into + specified char[].
    + static int @@ -183,7 +186,10 @@

    Method Summary

    static int outputLong(long v, char[] b, - int off)  + int off) +
    Method for appending value of given long value into + specified char[].
    + static String @@ -249,9 +255,18 @@

    outputInt

    public static int outputInt(int v,
                             char[] b,
                             int off)
    +
    Method for appending value of given int value into + specified char[]. +

    + NOTE: caller must guarantee that the output buffer has enough room + for String representation of the value.

    +
    Parameters:
    +
    v - Value to append to buffer
    +
    b - Buffer to append value to: caller must guarantee there is enough room
    +
    off - Offset within output buffer (b) to append number at
    Returns:
    -
    Offset within buffer after outputting int
    +
    Offset within buffer after outputting int
    @@ -275,9 +290,18 @@

    outputLong

    public static int outputLong(long v,
                              char[] b,
                              int off)
    +
    Method for appending value of given long value into + specified char[]. +

    + NOTE: caller must guarantee that the output buffer has enough room + for String representation of the value.

    +
    Parameters:
    +
    v - Value to append to buffer
    +
    b - Buffer to append value to: caller must guarantee there is enough room
    +
    off - Offset within output buffer (b) to append number at
    Returns:
    -
    Offset within buffer after outputting int
    +
    Offset within buffer after outputting long
    @@ -326,10 +350,6 @@

    toString

  • toString

    public static String toString(float v)
    -
    -
    Since:
    -
    2.6.0
    -
    • @@ -342,6 +362,8 @@

    notFinite

    Helper method to verify whether given double value is finite (regular rational number} or not (NaN or Infinity).
    +
    Parameters:
    +
    value - double value to check
    Returns:
    True if number is NOT finite (is Infinity or NaN); false otherwise @@ -359,6 +381,8 @@

    notFinite

    Helper method to verify whether given float value is finite (regular rational number} or not (NaN or Infinity).
    +
    Parameters:
    +
    value - float value to check
    Returns:
    True if number is NOT finite (is Infinity or NaN); false otherwise @@ -435,6 +459,6 @@

    notFinite

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/OutputDecorator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/OutputDecorator.html index a26f2fc131..ba27b746c7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/OutputDecorator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/OutputDecorator.html @@ -2,10 +2,10 @@ - + OutputDecorator (Jackson-core 2.12.0 API) - + @@ -237,7 +237,7 @@

    decorate

    OutputStream to use; either passed in argument, or something that calls it
    Throws:
    -
    IOException
    +
    IOException - if construction of decorated OutputStream fails
    @@ -260,7 +260,7 @@

    decorate

    Returns:
    Writer to use; either passed in argument, or something that calls it
    Throws:
    -
    IOException
    +
    IOException - if construction of decorated Writer fails
    @@ -333,6 +333,6 @@

    decorate

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SegmentedStringWriter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SegmentedStringWriter.html index 576a28f439..24d07bd0c6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SegmentedStringWriter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SegmentedStringWriter.html @@ -2,10 +2,10 @@ - + SegmentedStringWriter (Jackson-core 2.12.0 API) - + @@ -430,6 +430,10 @@

    getAndClear

    and return result String. Note that the method is not idempotent -- if called second time, will just return an empty String. +
    +
    Returns:
    +
    String that contains all aggregated content
    +
    @@ -501,6 +505,6 @@

    getAndClear

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SerializedString.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SerializedString.html index e85b62729a..58affb9ad3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SerializedString.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/SerializedString.html @@ -2,10 +2,10 @@ - + SerializedString (Jackson-core 2.12.0 API) - + @@ -278,11 +278,17 @@

    Method Summary

    int -putQuotedUTF8(ByteBuffer buffer)  +putQuotedUTF8(ByteBuffer buffer) +
    Method for appending JSON-escaped UTF-8 encoded String value into given + ByteBuffer, if it fits.
    + int -putUnquotedUTF8(ByteBuffer buffer)  +putUnquotedUTF8(ByteBuffer buffer) +
    Method for appending unquoted ('raw') UTF-8 encoded String value into given + ByteBuffer, if it fits.
    + protected Object @@ -294,11 +300,17 @@

    Method Summary

    int -writeQuotedUTF8(OutputStream out)  +writeQuotedUTF8(OutputStream out) +
    Method for writing JSON-escaped UTF-8 encoded String value using given + OutputStream.
    + int -writeUnquotedUTF8(OutputStream out)  +writeUnquotedUTF8(OutputStream out) +
    Method for writing unescaped UTF-8 encoded String value using given + OutputStream.
    + @@ -434,6 +448,8 @@

    charLength

    Specified by:
    charLength in interface SerializableString
    +
    Returns:
    +
    Length of the String in characters
    @@ -449,6 +465,8 @@

    asQuotedChars

    Specified by:
    asQuotedChars in interface SerializableString
    +
    Returns:
    +
    JSON quoted form of the String as char[]
    @@ -465,6 +483,8 @@

    asQuotedUTF8

    Specified by:
    asQuotedUTF8 in interface SerializableString
    +
    Returns:
    +
    UTF-8 encoded version of JSON-escaped String
    @@ -480,6 +500,8 @@

    asUnquotedUTF8

    Specified by:
    asUnquotedUTF8 in interface SerializableString
    +
    Returns:
    +
    UTF-8 encoded version of String, without any escaping
    @@ -502,6 +524,9 @@

    appendQuoted

    Specified by:
    appendQuoted in interface SerializableString
    +
    Parameters:
    +
    buffer - Buffer to append JSON-escaped String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of characters appended, if successful, otherwise -1
    @@ -527,6 +552,9 @@

    appendQuotedUTF8

    Specified by:
    appendQuotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    buffer - Buffer to append JSON-escaped String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of bytes appended, if successful, otherwise -1
    @@ -551,6 +579,9 @@

    appendUnquoted

    Specified by:
    appendUnquoted in interface SerializableString
    +
    Parameters:
    +
    buffer - Buffer to append literal (unescaped) String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of characters appended, if successful, otherwise -1
    @@ -575,6 +606,9 @@

    appendUnquotedUTF8

    Specified by:
    appendUnquotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    buffer - Buffer to append literal (unescaped) String into
    +
    offset - Offset in buffer to append String at
    Returns:
    Number of bytes appended, if successful, otherwise -1
    @@ -588,13 +622,18 @@

    appendUnquotedUTF8

    writeQuotedUTF8

    public int writeQuotedUTF8(OutputStream out)
                     throws IOException
    +
    Description copied from interface: SerializableString
    +
    Method for writing JSON-escaped UTF-8 encoded String value using given + OutputStream.
    Specified by:
    writeQuotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    out - OutputStream to write String into
    Returns:
    Number of bytes written
    Throws:
    -
    IOException
    +
    IOException - if underlying stream write fails
    @@ -606,13 +645,18 @@

    writeQuotedUTF8

    writeUnquotedUTF8

    public int writeUnquotedUTF8(OutputStream out)
                       throws IOException
    +
    Description copied from interface: SerializableString
    +
    Method for writing unescaped UTF-8 encoded String value using given + OutputStream.
    Specified by:
    writeUnquotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    out - OutputStream to write String into
    Returns:
    Number of bytes written
    Throws:
    -
    IOException
    +
    IOException - if underlying stream write fails
    @@ -623,11 +667,16 @@

    writeUnquotedUTF8

  • putQuotedUTF8

    public int putQuotedUTF8(ByteBuffer buffer)
    +
    Description copied from interface: SerializableString
    +
    Method for appending JSON-escaped UTF-8 encoded String value into given + ByteBuffer, if it fits.
    Specified by:
    putQuotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    buffer - ByteBuffer to append String into
    Returns:
    -
    Number of bytes put, if successful, otherwise -1
    +
    Number of bytes put, if contents fit, otherwise -1
    • @@ -638,11 +687,16 @@

    putQuotedUTF8

  • putUnquotedUTF8

    public int putUnquotedUTF8(ByteBuffer buffer)
    +
    Description copied from interface: SerializableString
    +
    Method for appending unquoted ('raw') UTF-8 encoded String value into given + ByteBuffer, if it fits.
    Specified by:
    putUnquotedUTF8 in interface SerializableString
    +
    Parameters:
    +
    buffer - ByteBuffer to append String into
    Returns:
    -
    Number of bytes put, if successful, otherwise -1
    +
    Number of bytes put, if contents fit, otherwise -1
    • @@ -754,6 +808,6 @@

    equals

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF32Reader.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF32Reader.html index a64530ed6f..3fba13b094 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF32Reader.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF32Reader.html @@ -2,10 +2,10 @@ - + UTF32Reader (Jackson-core 2.12.0 API) - + @@ -585,6 +585,6 @@

    read

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF8Writer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF8Writer.html index 8b997380ab..8e1e7e6832 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF8Writer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/UTF8Writer.html @@ -2,10 +2,10 @@ - + UTF8Writer (Jackson-core 2.12.0 API) - + @@ -183,7 +183,7 @@

    Method Summary

    protected int convertSurrogate(int secondPart) -
    Method called to calculate UTF codepoint, from a surrogate pair.
    +
    Method called to calculate Unicode code-point, from a surrogate pair.
    @@ -417,10 +417,14 @@

    write

    convertSurrogate

    protected int convertSurrogate(int secondPart)
                         throws IOException
    -
    Method called to calculate UTF codepoint, from a surrogate pair.
    +
    Method called to calculate Unicode code-point, from a surrogate pair.
    +
    Parameters:
    +
    secondPart - Second UTF-16 unit of surrogate (first part stored in _surrogate)
    +
    Returns:
    +
    Decoded Unicode point
    Throws:
    -
    IOException
    +
    IOException - If surrogate pair is invalid
    @@ -516,6 +520,6 @@

    illegalSurrogateDesc

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharTypes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharTypes.html index 8e1ba824a2..9d10f5268e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharTypes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharTypes.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.CharTypes (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharacterEscapes.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharacterEscapes.html index 8c736fa8f3..430045071c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharacterEscapes.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/CharacterEscapes.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.CharacterEscapes (Jackson-core 2.12.0 API) - + @@ -346,6 +346,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/DataOutputAsStream.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/DataOutputAsStream.html index 5ea04b5e59..8afabb08c7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/DataOutputAsStream.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/DataOutputAsStream.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.DataOutputAsStream (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/IOContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/IOContext.html index 109ffee400..fa24f1e7c0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/IOContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/IOContext.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.IOContext (Jackson-core 2.12.0 API) - + @@ -634,6 +634,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/InputDecorator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/InputDecorator.html index c7e8f9dc06..b3bc08bfcc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/InputDecorator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/InputDecorator.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.InputDecorator (Jackson-core 2.12.0 API) - + @@ -220,6 +220,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonEOFException.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonEOFException.html index 0591fc004c..2d153ac8b2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonEOFException.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonEOFException.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.JsonEOFException (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonStringEncoder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonStringEncoder.html index a0a5d73844..5598c18456 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonStringEncoder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/JsonStringEncoder.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.JsonStringEncoder (Jackson-core 2.12.0 API) - + @@ -164,6 +164,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/MergedStream.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/MergedStream.html index fd167c1c94..96583a51ce 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/MergedStream.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/MergedStream.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.MergedStream (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberInput.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberInput.html index 008c501f92..2e300cf1ef 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberInput.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberInput.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.NumberInput (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberOutput.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberOutput.html index 7158af2663..390c036311 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberOutput.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/NumberOutput.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.NumberOutput (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/OutputDecorator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/OutputDecorator.html index 21f1fb01df..c2c9426be2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/OutputDecorator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/OutputDecorator.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.OutputDecorator (Jackson-core 2.12.0 API) - + @@ -162,7 +162,7 @@

    Uses of JsonFactory JsonFactory.setOutputDecorator(OutputDecorator d)
    Deprecated.  -
    Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    +
    Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
    @@ -220,6 +220,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SegmentedStringWriter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SegmentedStringWriter.html index fa069dcc14..e4f923caf1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SegmentedStringWriter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SegmentedStringWriter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.SegmentedStringWriter (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SerializedString.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SerializedString.html index 9eee43696b..82ee897617 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SerializedString.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/SerializedString.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.SerializedString (Jackson-core 2.12.0 API) - + @@ -198,6 +198,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF32Reader.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF32Reader.html index 3986c683e5..c6de74c41f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF32Reader.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF32Reader.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.UTF32Reader (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF8Writer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF8Writer.html index 480b641bdb..fdda46c289 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF8Writer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/class-use/UTF8Writer.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.io.UTF8Writer (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-frame.html index cb1d53c1b5..bd3b592a9e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.io (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-summary.html index b1f60d777e..977f792f28 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.io (Jackson-core 2.12.0 API) - + @@ -242,6 +242,6 @@

    Package com.fasterxml.jackson.core.io

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-tree.html index db048805c5..a612e04345 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.io Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -192,6 +192,6 @@

    Class Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-use.html index 0dc6e02669..d05eecc122 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/io/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.io (Jackson-core 2.12.0 API) - + @@ -331,6 +331,6 @@

    Uses of -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ByteSourceJsonBootstrapper.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ByteSourceJsonBootstrapper.html index 9064c69efa..e3151144ba 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ByteSourceJsonBootstrapper.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ByteSourceJsonBootstrapper.html @@ -2,10 +2,10 @@ - + ByteSourceJsonBootstrapper (Jackson-core 2.12.0 API) - + @@ -334,8 +334,10 @@

    detectEncoding

    It will figure out encoding that content uses, to allow for instantiating a proper scanner object.
    +
    Returns:
    +
    JsonEncoding detected, if any; JsonEncoding.UTF8 otherwise
    Throws:
    -
    IOException
    +
    IOException - If read from underlying input source fails
    @@ -350,8 +352,12 @@

    skipUTF8BOM

    Helper method that may be called to see if given DataInput has BOM marker, and if so, to skip it.
    +
    Parameters:
    +
    input - DataInput to read content from
    +
    Returns:
    +
    Byte (as unsigned int) read after possible UTF-8 BOM
    Throws:
    -
    IOException
    +
    IOException - If read from underlying input source fails
    Since:
    2.8
    @@ -402,8 +408,12 @@

    hasJSONFormat

    supports UTF-8, for example. But it should work, for now, and can be improved as necessary.
    +
    Parameters:
    +
    acc - InputAccessor to use for accessing content to check
    +
    Returns:
    +
    Strength of match (never null)
    Throws:
    -
    IOException
    +
    IOException - if input access fails due to read problem
    @@ -490,6 +500,6 @@

    ensureLoaded

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/DupDetector.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/DupDetector.html index 4c63d88f52..955884f676 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/DupDetector.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/DupDetector.html @@ -2,10 +2,10 @@ - + DupDetector (Jackson-core 2.12.0 API) - + @@ -192,7 +192,11 @@

    Method Summary

    boolean -isDup(String name)  +isDup(String name) +
    Method called to check whether a newly encountered property name would + be a duplicate within this context, and if not, update the state to remember + having seen the property name for checking more property names
    + void @@ -327,6 +331,8 @@

    findLocation

    getSource

    public Object getSource()
    +
    Returns:
    +
    Source object (parser / generator) used to construct this detector
    Since:
    2.7
    @@ -340,9 +346,17 @@

    getSource

    isDup

    public boolean isDup(String name)
               throws JsonParseException
    +
    Method called to check whether a newly encountered property name would + be a duplicate within this context, and if not, update the state to remember + having seen the property name for checking more property names
    +
    Parameters:
    +
    name - Property seen
    +
    Returns:
    +
    True if the property had already been seen before in this context
    Throws:
    -
    JsonParseException
    +
    JsonParseException - to report possible operation problem (default implementation + never throws it)
    @@ -415,6 +429,6 @@

    isDup

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonGeneratorImpl.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonGeneratorImpl.html index 73fc4cadbf..8c9b375ac2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonGeneratorImpl.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonGeneratorImpl.html @@ -2,10 +2,10 @@ - + JsonGeneratorImpl (Jackson-core 2.12.0 API) - + @@ -290,14 +290,14 @@

    Method Summary

    JsonGenerator disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    JsonGenerator enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -318,7 +318,7 @@

    Method Summary

    JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities() -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    @@ -537,6 +537,9 @@

    version

    version in interface Versioned
    Overrides:
    version in class GeneratorBase
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -548,13 +551,15 @@

    version

    enable

    public JsonGenerator enable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    Overrides:
    enable in class GeneratorBase
    +
    Parameters:
    +
    f - Feature to enable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -566,13 +571,15 @@

    enable

    disable

    public JsonGenerator disable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    Overrides:
    disable in class GeneratorBase
    +
    Parameters:
    +
    f - Feature to disable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -626,6 +633,8 @@

    setHighestNonEscapedChar

    charCode - Either -1 to indicate that no additional escaping is to be done; or highest code point not to escape (meaning higher ones will be), if positive value.
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -668,6 +677,10 @@

    setCharacterEscapes

    Overrides:
    setCharacterEscapes in class JsonGenerator
    +
    Parameters:
    +
    esc - CharacterEscapes to configure this generator to use, if any; null if none
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -683,6 +696,8 @@

    getCharacterEscapes

    Overrides:
    getCharacterEscapes in class JsonGenerator
    +
    Returns:
    +
    CharacterEscapes configured for this generator, if any; null if none
    @@ -704,6 +719,8 @@

    setRootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -715,13 +732,13 @@

    setRootValueSeparator

    getWriteCapabilities

    public JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities()
    Description copied from class: JsonGenerator
    -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    Overrides:
    getWriteCapabilities in class JsonGenerator
    Returns:
    -
    Set of read capabilities for content to read via this parser
    +
    Set of write capabilities for content written using this generator
    @@ -823,6 +840,6 @@

    _reportCantWriteValueExpectName

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadContext.html index 7f62b798ab..0708a9be7c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadContext.html @@ -2,10 +2,10 @@ - + JsonReadContext (Jackson-core 2.12.0 API) - + @@ -497,6 +497,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonStreamContext
    +
    Parameters:
    +
    v - Current value to assign to this context
    @@ -554,6 +556,8 @@

    getCurrentName

    Specified by:
    getCurrentName in class JsonStreamContext
    +
    Returns:
    +
    Current field name within context, if any; null if none
    @@ -567,6 +571,9 @@

    hasCurrentName

    Overrides:
    hasCurrentName in class JsonStreamContext
    +
    Returns:
    +
    True if a call to JsonStreamContext.getCurrentName() would return non-null + name; false otherwise
    @@ -583,6 +590,8 @@

    getParent

    Specified by:
    getParent in class JsonStreamContext
    +
    Returns:
    +
    Parent context of this context, if any; null for Root contexts
    @@ -598,16 +607,18 @@

    getStartLocation

    for example, in case of JSON `Object` context, offset at which `[` token was read or written. Often used for error reporting purposes. Implementations that do not keep track of such location are expected to return - JsonLocation.NA; this is what the default implementation does.
    + JsonLocation.NA; this is what the default implementation does. +

    + NOTE: demoted from JsonReadContext in 2.9, to allow use for + "non-standard" read contexts.

    Overrides:
    getStartLocation in class JsonStreamContext
    +
    Parameters:
    +
    srcRef - Source reference needed to construct location instance
    Returns:
    Location pointing to the point where the context - start marker was found (or written); never `null`. -

    - NOTE: demoted from JsonReadContext in 2.9, to allow use for - "non-standard" read contexts.

    + start marker was found (or written); never `null`.
    @@ -731,6 +742,6 @@

    setCurrentName

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadFeature.html index 2d4b4fe5fe..2946bb9f6e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonReadFeature.html @@ -2,10 +2,10 @@ - + JsonReadFeature (Jackson-core 2.12.0 API) - + @@ -584,6 +584,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit mask of all features that are enabled by default
    +
    @@ -600,6 +604,8 @@

    enabledByDefault

    enabledByDefault in interface FormatFeature
    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -618,6 +624,8 @@

    getMask

    getMask in interface FormatFeature
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -635,6 +643,10 @@

    enabledIn

    enabledIn in interface FormatFeature
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -716,6 +728,6 @@

    mappedFeature

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteContext.html index 4b650faccf..e9cf3d2178 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteContext.html @@ -2,10 +2,10 @@ - + JsonWriteContext (Jackson-core 2.12.0 API) - + @@ -640,6 +640,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonStreamContext
    +
    Parameters:
    +
    v - Current value to assign to this context
    @@ -712,6 +714,8 @@

    getParent

    Specified by:
    getParent in class JsonStreamContext
    +
    Returns:
    +
    Parent context of this context, if any; null for Root contexts
    @@ -729,6 +733,8 @@

    getCurrentName

    Specified by:
    getCurrentName in class JsonStreamContext
    +
    Returns:
    +
    Current field name within context, if any; null if none
    @@ -742,6 +748,9 @@

    hasCurrentName

    Overrides:
    hasCurrentName in class JsonStreamContext
    +
    Returns:
    +
    True if a call to JsonStreamContext.getCurrentName() would return non-null + name; false otherwise
    @@ -868,6 +877,6 @@

    writeValue

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteFeature.html index ff83a9d51f..56ce32176a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/JsonWriteFeature.html @@ -2,10 +2,10 @@ - + JsonWriteFeature (Jackson-core 2.12.0 API) - + @@ -389,6 +389,10 @@

    collectDefaults

    public static int collectDefaults()
    Method that calculates bit set (flags) of all features that are enabled by default.
    +
    +
    Returns:
    +
    Bit mask of all features that are enabled by default
    +
    @@ -405,6 +409,8 @@

    enabledByDefault

    enabledByDefault in interface FormatFeature
    Specified by:
    enabledByDefault in interface JacksonFeature
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    @@ -423,6 +429,8 @@

    getMask

    getMask in interface FormatFeature
    Specified by:
    getMask in interface JacksonFeature
    +
    Returns:
    +
    Bit mask of this feature
    @@ -440,6 +448,10 @@

    enabledIn

    enabledIn in interface FormatFeature
    Specified by:
    enabledIn in interface JacksonFeature
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    @@ -521,6 +533,6 @@

    mappedFeature

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/PackageVersion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/PackageVersion.html index afc0e7b040..c26cffc761 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/PackageVersion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/PackageVersion.html @@ -2,10 +2,10 @@ - + PackageVersion (Jackson-core 2.12.0 API) - + @@ -252,6 +252,8 @@

    version

    Specified by:
    version in interface Versioned
    +
    Returns:
    +
    Version of the component
    @@ -324,6 +326,6 @@

    version

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ReaderBasedJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ReaderBasedJsonParser.html index 1ce32eb673..9857882132 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ReaderBasedJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/ReaderBasedJsonParser.html @@ -2,10 +2,10 @@ - + ReaderBasedJsonParser (Jackson-core 2.12.0 API) - + @@ -872,6 +872,8 @@

    getCodec

    Specified by:
    getCodec in class JsonParser
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    @@ -889,6 +891,8 @@

    setCodec

    Specified by:
    setCodec in class JsonParser
    +
    Parameters:
    +
    c - Codec to assign, if any; null if none
    @@ -929,6 +933,8 @@

    releaseBuffered

    Overrides:
    releaseBuffered in class JsonParser
    +
    Parameters:
    +
    w - Writer to which buffered but unprocessed content is written to
    Returns:
    -1 if the underlying content source is not char-based (that is, input can not be sent to Writer; @@ -962,6 +968,8 @@

    getInputSource

    Overrides:
    getInputSource in class JsonParser
    +
    Returns:
    +
    Input source this parser was configured with
    @@ -1075,8 +1083,12 @@

    getText

    Specified by:
    getText in class ParserMinimalBase
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1101,10 +1113,14 @@

    getText

    Overrides:
    getText in class JsonParser
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    @@ -1127,8 +1143,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1151,8 +1170,13 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1200,8 +1224,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class ParserMinimalBase
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1224,7 +1252,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1247,7 +1276,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1284,7 +1314,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1309,7 +1340,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1349,7 +1381,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1376,7 +1409,8 @@

    finishToken

    Overrides:
    finishToken in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1404,8 +1438,12 @@

    nextFieldName

    Parameters:
    sstr - Property name to compare next token to (if next token is JsonToken.FIELD_NAME)
    +
    Returns:
    +
    True if parser advanced to JsonToken.FIELD_NAME with + specified name; false otherwise (different token or non-matching name)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1424,8 +1462,12 @@

    nextFieldName

    Overrides:
    nextFieldName in class JsonParser
    +
    Returns:
    +
    Name of the the JsonToken.FIELD_NAME parser advanced to, if any; + null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1465,8 +1507,12 @@

    nextTextValue

    Overrides:
    nextTextValue in class JsonParser
    +
    Returns:
    +
    Text value of the JsonToken.VALUE_STRING token parser advanced + to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1487,12 +1533,21 @@

    nextIntValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getIntValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get an int value next from input. + expects to get an int value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getIntValue()

    Overrides:
    nextIntValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    Integer (int) value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java int
    @@ -1513,12 +1568,21 @@

    nextLongValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getLongValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get a long value next from input. + expects to get a long value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getLongValue()

    Overrides:
    nextLongValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    long value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java long
    @@ -1546,8 +1610,12 @@

    nextBooleanValue

    Overrides:
    nextBooleanValue in class JsonParser
    +
    Returns:
    +
    Boolean value of the JsonToken.VALUE_TRUE or JsonToken.VALUE_FALSE + token parser advanced to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1828,6 +1896,8 @@

    getTokenLocation

    Overrides:
    getTokenLocation in class ParserBase
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -1844,6 +1914,8 @@

    getCurrentLocation

    Overrides:
    getCurrentLocation in class ParserBase
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1945,6 +2017,6 @@

    _reportInvalidToken

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8DataInputJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8DataInputJsonParser.html index 23bf2bfcb8..cef9f427b7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8DataInputJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8DataInputJsonParser.html @@ -2,10 +2,10 @@ - + UTF8DataInputJsonParser (Jackson-core 2.12.0 API) - + @@ -507,7 +507,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value. @@ -774,6 +774,8 @@

    getCodec

    Specified by:
    getCodec in class JsonParser
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    @@ -791,6 +793,8 @@

    setCodec

    Specified by:
    setCodec in class JsonParser
    +
    Parameters:
    +
    c - Codec to assign, if any; null if none
    @@ -830,6 +834,8 @@

    releaseBuffered

    Overrides:
    releaseBuffered in class JsonParser
    +
    Parameters:
    +
    out - OutputStream to which buffered, undecoded content is written to
    Returns:
    -1 if the underlying content source is not byte based (that is, input can not be sent to OutputStream; @@ -863,6 +869,8 @@

    getInputSource

    Overrides:
    getInputSource in class JsonParser
    +
    Returns:
    +
    Input source this parser was configured with
    @@ -918,8 +926,12 @@

    getText

    Specified by:
    getText in class ParserMinimalBase
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -944,10 +956,14 @@

    getText

    Overrides:
    getText in class JsonParser
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    @@ -970,8 +986,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -994,8 +1013,13 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1009,7 +1033,7 @@

    getValueAsInt

    throws IOException
    Description copied from class: JsonParser
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -1020,8 +1044,12 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class ParserMinimalBase
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1046,8 +1074,13 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1095,8 +1128,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class ParserMinimalBase
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1119,7 +1156,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1142,7 +1180,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1179,7 +1218,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1204,7 +1244,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1244,7 +1285,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1271,7 +1313,8 @@

    finishToken

    Overrides:
    finishToken in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1290,8 +1333,12 @@

    nextFieldName

    Overrides:
    nextFieldName in class JsonParser
    +
    Returns:
    +
    Name of the the JsonToken.FIELD_NAME parser advanced to, if any; + null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1316,8 +1363,12 @@

    nextTextValue

    Overrides:
    nextTextValue in class JsonParser
    +
    Returns:
    +
    Text value of the JsonToken.VALUE_STRING token parser advanced + to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1338,12 +1389,21 @@

    nextIntValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getIntValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get an int value next from input. + expects to get an int value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getIntValue()

    Overrides:
    nextIntValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    Integer (int) value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java int
    @@ -1364,12 +1424,21 @@

    nextLongValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getLongValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get a long value next from input. + expects to get a long value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getLongValue()

    Overrides:
    nextLongValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    long value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java long
    @@ -1397,8 +1466,12 @@

    nextBooleanValue

    Overrides:
    nextBooleanValue in class JsonParser
    +
    Returns:
    +
    Boolean value of the JsonToken.VALUE_TRUE or JsonToken.VALUE_FALSE + token parser advanced to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1744,6 +1817,8 @@

    getTokenLocation

    Overrides:
    getTokenLocation in class ParserBase
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -1760,6 +1835,8 @@

    getCurrentLocation

    Overrides:
    getCurrentLocation in class ParserBase
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1832,6 +1909,6 @@

    getCurrentLocation

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8JsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8JsonGenerator.html index 929bf23034..81ee7ba134 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8JsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8JsonGenerator.html @@ -2,10 +2,10 @@ - + UTF8JsonGenerator (Jackson-core 2.12.0 API) - + @@ -608,12 +608,23 @@

    Method Summary

    void -writeStartArray(Object currentValue)  +writeStartArray(Object currentValue) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    + void writeStartArray(Object currentValue, - int size)  + int size) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    + void @@ -934,6 +945,8 @@

    getOutputTarget

    Overrides:
    getOutputTarget in class JsonGenerator
    +
    Returns:
    +
    Output target this generator was configured with
    @@ -984,8 +997,11 @@

    writeFieldName

    Specified by:
    writeFieldName in class JsonGenerator
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1010,8 +1026,11 @@

    writeFieldName

    Overrides:
    writeFieldName in class GeneratorBase
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1035,7 +1054,8 @@

    writeStartArray

    Specified by:
    writeStartArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1047,11 +1067,19 @@

    writeStartArray

    writeStartArray

    public final void writeStartArray(Object currentValue)
                            throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    currentValue - "Current value" to assign for the Array context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1064,11 +1092,24 @@

    writeStartArray

    public void writeStartArray(Object currentValue,
                             int size)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    currentValue - "Current value" to assign for the Array context being created
    +
    size - Number of elements this Array will have: actual + number of values written (before matching call to + JsonGenerator.writeEndArray() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1091,7 +1132,8 @@

    writeEndArray

    Specified by:
    writeEndArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1115,7 +1157,8 @@

    writeStartObject

    Specified by:
    writeStartObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1140,8 +1183,11 @@

    writeStartObject

    Overrides:
    writeStartObject in class GeneratorBase
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1166,7 +1212,8 @@

    writeEndObject

    Specified by:
    writeEndObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1217,8 +1264,11 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Text value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1237,14 +1287,23 @@

    writeString

    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. - If the reader is null, then write a null. - If len is < 0, then write all contents of the reader. - Otherwise, write only len characters. + If len is < 0, then write all contents of the reader. + Otherwise, write only len characters. +

    + Note: actual length of content available may exceed len but + can not be less than it: if not enough content available, a + JsonGenerationException will be thrown.

    Overrides:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    reader - Reader to use for reading Text value to write
    +
    len - Maximum Length of Text value to read (in chars, non-negative) + if known; -1 to indicate "read and write it all"
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer; or if length (len) is specified but + reader does not provide enough content
    @@ -1267,8 +1326,13 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first character of String value to write
    +
    len - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1292,8 +1356,11 @@

    writeString

    Overrides:
    writeString in class GeneratorBase
    +
    Parameters:
    +
    text - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1323,8 +1390,13 @@

    writeRawUTF8String

    Specified by:
    writeRawUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1358,8 +1430,13 @@

    writeUTF8String

    Specified by:
    writeUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    len - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1385,8 +1462,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Textual contents to include as-is in output.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1414,8 +1494,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - String that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1446,8 +1531,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1466,8 +1554,11 @@

    writeRawValue

    Overrides:
    writeRawValue in class GeneratorBase
    +
    Parameters:
    +
    text - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1495,8 +1586,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    cbuf - Buffer that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1522,8 +1618,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    ch - Character to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1562,8 +1661,12 @@

    writeBinary

    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. +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    JsonGenerationException
    @@ -1601,7 +1704,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    JsonGenerationException
    @@ -1626,7 +1730,8 @@

    writeNumber

    Parameters:
    s - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1650,7 +1755,8 @@

    writeNumber

    Parameters:
    i - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1674,7 +1780,8 @@

    writeNumber

    Parameters:
    l - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1698,7 +1805,8 @@

    writeNumber

    Parameters:
    value - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1722,7 +1830,8 @@

    writeNumber

    Parameters:
    d - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1746,7 +1855,8 @@

    writeNumber

    Parameters:
    f - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1770,7 +1880,8 @@

    writeNumber

    Parameters:
    value - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1800,8 +1911,11 @@

    writeNumber

    Specified by:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValue - Textual (possibly format) number representation to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1821,8 +1935,13 @@

    writeNumber

    Overrides:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValueBuffer - Buffer that contains the textual number representation to write
    +
    offset - Offset of the first character of value to write
    +
    length - Length of the value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1844,8 +1963,11 @@

    writeBoolean

    Specified by:
    writeBoolean in class JsonGenerator
    +
    Parameters:
    +
    state - Boolean value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1867,7 +1989,8 @@

    writeNull

    Specified by:
    writeNull in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1890,7 +2013,8 @@

    _verifyValueWrite

    typeMsg - Additional message used for generating exception message if value output is NOT legal in current generator output state.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1912,7 +2036,8 @@

    flush

    Specified by:
    flush in class GeneratorBase
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1943,7 +2068,7 @@

    close

    Overrides:
    close in class GeneratorBase
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -2117,6 +2242,6 @@

    _flushBuffer

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8StreamJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8StreamJsonParser.html index f8f59adbff..a8b38826a4 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8StreamJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/UTF8StreamJsonParser.html @@ -2,10 +2,10 @@ - + UTF8StreamJsonParser (Jackson-core 2.12.0 API) - + @@ -571,7 +571,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value. @@ -949,6 +949,8 @@

    getCodec

    Specified by:
    getCodec in class JsonParser
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    @@ -966,6 +968,8 @@

    setCodec

    Specified by:
    setCodec in class JsonParser
    +
    Parameters:
    +
    c - Codec to assign, if any; null if none
    @@ -1005,6 +1009,8 @@

    releaseBuffered

    Overrides:
    releaseBuffered in class JsonParser
    +
    Parameters:
    +
    out - OutputStream to which buffered, undecoded content is written to
    Returns:
    -1 if the underlying content source is not byte based (that is, input can not be sent to OutputStream; @@ -1038,6 +1044,8 @@

    getInputSource

    Overrides:
    getInputSource in class JsonParser
    +
    Returns:
    +
    Input source this parser was configured with
    @@ -1107,8 +1115,12 @@

    getText

    Specified by:
    getText in class ParserMinimalBase
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1133,10 +1145,14 @@

    getText

    Overrides:
    getText in class JsonParser
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    @@ -1159,8 +1175,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1183,8 +1202,13 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1198,7 +1222,7 @@

    getValueAsInt

    throws IOException
    Description copied from class: JsonParser
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -1209,8 +1233,12 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class ParserMinimalBase
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1235,8 +1263,13 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1284,8 +1317,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class ParserMinimalBase
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1308,7 +1345,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1331,7 +1369,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1368,7 +1407,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1393,7 +1433,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1433,7 +1474,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1460,7 +1502,8 @@

    finishToken

    Overrides:
    finishToken in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1488,8 +1531,12 @@

    nextFieldName

    Parameters:
    str - Property name to compare next token to (if next token is JsonToken.FIELD_NAME)
    +
    Returns:
    +
    True if parser advanced to JsonToken.FIELD_NAME with + specified name; false otherwise (different token or non-matching name)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1508,8 +1555,12 @@

    nextFieldName

    Overrides:
    nextFieldName in class JsonParser
    +
    Returns:
    +
    Name of the the JsonToken.FIELD_NAME parser advanced to, if any; + null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1534,8 +1585,12 @@

    nextTextValue

    Overrides:
    nextTextValue in class JsonParser
    +
    Returns:
    +
    Text value of the JsonToken.VALUE_STRING token parser advanced + to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1556,12 +1611,21 @@

    nextIntValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getIntValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get an int value next from input. + expects to get an int value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getIntValue()

    Overrides:
    nextIntValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    Integer (int) value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java int
    @@ -1582,12 +1646,21 @@

    nextLongValue

    return (nextToken() == JsonToken.VALUE_NUMBER_INT) ? getLongValue() : defaultValue; but may be faster for parser to process, and can therefore be used if caller - expects to get a long value next from input. + expects to get a long value next from input. +

    + NOTE: value checks are performed similar to JsonParser.getLongValue()

    Overrides:
    nextLongValue in class JsonParser
    +
    Parameters:
    +
    defaultValue - Value to return if next token is NOT of type JsonToken.VALUE_NUMBER_INT
    +
    Returns:
    +
    long value of the JsonToken.VALUE_NUMBER_INT token parser advanced + to; or defaultValue if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    +
    InputCoercionException - if integer number does not fit in Java long
    @@ -1615,8 +1688,12 @@

    nextBooleanValue

    Overrides:
    nextBooleanValue in class JsonParser
    +
    Returns:
    +
    Boolean value of the JsonToken.VALUE_TRUE or JsonToken.VALUE_FALSE + token parser advanced to; or null if next token is of some other type
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2155,6 +2232,8 @@

    getTokenLocation

    Overrides:
    getTokenLocation in class ParserBase
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -2171,6 +2250,8 @@

    getCurrentLocation

    Overrides:
    getCurrentLocation in class ParserBase
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -2243,6 +2324,6 @@

    getCurrentLocation

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/WriterBasedJsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/WriterBasedJsonGenerator.html index 51ae648148..ab56efc066 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/WriterBasedJsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/WriterBasedJsonGenerator.html @@ -2,10 +2,10 @@ - + WriterBasedJsonGenerator (Jackson-core 2.12.0 API) - + @@ -595,12 +595,23 @@

    Method Summary

    void -writeStartArray(Object currentValue)  +writeStartArray(Object currentValue) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    + void writeStartArray(Object currentValue, - int size)  + int size) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    + void @@ -894,6 +905,8 @@

    getOutputTarget

    Overrides:
    getOutputTarget in class JsonGenerator
    +
    Returns:
    +
    Output target this generator was configured with
    @@ -944,6 +957,11 @@

    canWriteFormattedNumbers

    Overrides:
    canWriteFormattedNumbers in class JsonGenerator
    +
    Returns:
    +
    True if this generator is capable of writing "formatted" + numbers (and if so, need to be passed using + JsonGenerator.writeNumber(String), that is, passed as String); + false if not
    @@ -966,8 +984,11 @@

    writeFieldName

    Specified by:
    writeFieldName in class JsonGenerator
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -992,8 +1013,11 @@

    writeFieldName

    Overrides:
    writeFieldName in class GeneratorBase
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1047,7 +1071,8 @@

    writeStartArray

    Specified by:
    writeStartArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1059,11 +1084,19 @@

    writeStartArray

    writeStartArray

    public void writeStartArray(Object currentValue)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    currentValue - "Current value" to assign for the Array context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1076,11 +1109,24 @@

    writeStartArray

    public void writeStartArray(Object currentValue,
                             int size)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    currentValue - "Current value" to assign for the Array context being created
    +
    size - Number of elements this Array will have: actual + number of values written (before matching call to + JsonGenerator.writeEndArray() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1103,7 +1149,8 @@

    writeEndArray

    Specified by:
    writeEndArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1127,7 +1174,8 @@

    writeStartObject

    Specified by:
    writeStartObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1152,8 +1200,11 @@

    writeStartObject

    Overrides:
    writeStartObject in class GeneratorBase
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1178,7 +1229,8 @@

    writeEndObject

    Specified by:
    writeEndObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1231,8 +1283,11 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Text value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1251,14 +1306,23 @@

    writeString

    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. - If the reader is null, then write a null. - If len is < 0, then write all contents of the reader. - Otherwise, write only len characters. + If len is < 0, then write all contents of the reader. + Otherwise, write only len characters. +

    + Note: actual length of content available may exceed len but + can not be less than it: if not enough content available, a + JsonGenerationException will be thrown.

    Overrides:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    reader - Reader to use for reading Text value to write
    +
    len - Maximum Length of Text value to read (in chars, non-negative) + if known; -1 to indicate "read and write it all"
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer; or if length (len) is specified but + reader does not provide enough content
    @@ -1281,8 +1345,13 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first character of String value to write
    +
    len - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1306,8 +1375,11 @@

    writeString

    Overrides:
    writeString in class GeneratorBase
    +
    Parameters:
    +
    sstr - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1337,8 +1409,13 @@

    writeRawUTF8String

    Specified by:
    writeRawUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1372,8 +1449,13 @@

    writeUTF8String

    Specified by:
    writeUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1399,8 +1481,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Textual contents to include as-is in output.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1428,8 +1513,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - String that has contents to include as-is in output
    +
    start - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1460,8 +1550,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1489,8 +1582,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1516,8 +1614,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    c - Character to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1556,8 +1657,12 @@

    writeBinary

    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. +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    JsonGenerationException
    @@ -1595,7 +1700,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    JsonGenerationException
    @@ -1620,7 +1726,8 @@

    writeNumber

    Parameters:
    s - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1644,7 +1751,8 @@

    writeNumber

    Parameters:
    i - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1668,7 +1776,8 @@

    writeNumber

    Parameters:
    l - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1692,7 +1801,8 @@

    writeNumber

    Parameters:
    value - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1716,7 +1826,8 @@

    writeNumber

    Parameters:
    d - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1740,7 +1851,8 @@

    writeNumber

    Parameters:
    f - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1764,7 +1876,8 @@

    writeNumber

    Parameters:
    value - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1794,8 +1907,11 @@

    writeNumber

    Specified by:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValue - Textual (possibly format) number representation to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1815,8 +1931,13 @@

    writeNumber

    Overrides:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValueBuffer - Buffer that contains the textual number representation to write
    +
    offset - Offset of the first character of value to write
    +
    length - Length of the value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1838,8 +1959,11 @@

    writeBoolean

    Specified by:
    writeBoolean in class JsonGenerator
    +
    Parameters:
    +
    state - Boolean value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1861,7 +1985,8 @@

    writeNull

    Specified by:
    writeNull in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1884,7 +2009,8 @@

    _verifyValueWrite

    typeMsg - Additional message used for generating exception message if value output is NOT legal in current generator output state.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1906,7 +2032,8 @@

    flush

    Specified by:
    flush in class GeneratorBase
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1937,7 +2064,7 @@

    close

    Overrides:
    close in class GeneratorBase
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -2096,6 +2223,6 @@

    _flushBuffer

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParser.html index 1cad46e7a6..0aac9e3cc0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParser.html @@ -2,10 +2,10 @@ - + NonBlockingJsonParser (Jackson-core 2.12.0 API) - + @@ -391,7 +391,8 @@

    Method Summary

    void endOfInput()
    Method that should be called after last chunk of data to parse has been fed - (with feedInput in sub-class); can be called regardless of what NonBlockingInputFeeder.needMoreInput() + (with feedInput in sub-class); can be called regardless of what + NonBlockingInputFeeder.needMoreInput() returns.
    @@ -557,6 +558,8 @@

    getNonBlockingInputFeeder

    Overrides:
    getNonBlockingInputFeeder in class JsonParser
    +
    Returns:
    +
    Input feeder to use with non-blocking (async) parsing
    @@ -574,6 +577,9 @@

    needMoreInput

    Specified by:
    needMoreInput in interface NonBlockingInputFeeder
    +
    Returns:
    +
    True if more input is needed (and can be fed); false if + there is still some input to decode
    @@ -614,7 +620,8 @@

    endOfInput

    public void endOfInput()
    Description copied from interface: NonBlockingInputFeeder
    Method that should be called after last chunk of data to parse has been fed - (with feedInput in sub-class); can be called regardless of what NonBlockingInputFeeder.needMoreInput() + (with feedInput in sub-class); can be called regardless of what + NonBlockingInputFeeder.needMoreInput() returns. After calling this method, no more data can be fed; and parser assumes no more data will be available.
    @@ -641,6 +648,8 @@

    releaseBuffered

    Specified by:
    releaseBuffered in class NonBlockingJsonParserBase
    +
    Parameters:
    +
    out - OutputStream to which buffered, undecoded content is written to
    Returns:
    -1 if the underlying content source is not byte based (that is, input can not be sent to OutputStream; @@ -690,7 +699,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1159,6 +1169,6 @@

    _startAposString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParserBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParserBase.html index 2ced503954..c389e6765e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParserBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/NonBlockingJsonParserBase.html @@ -2,10 +2,10 @@ - + NonBlockingJsonParserBase (Jackson-core 2.12.0 API) - + @@ -1704,6 +1704,8 @@

    getCodec

    Specified by:
    getCodec in class JsonParser
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    @@ -1721,6 +1723,8 @@

    setCodec

    Specified by:
    setCodec in class JsonParser
    +
    Parameters:
    +
    c - Codec to assign, if any; null if none
    @@ -1744,6 +1748,8 @@

    canParseAsync

    Overrides:
    canParseAsync in class JsonParser
    +
    Returns:
    +
    True if this is a non-blocking ("asynchronous") parser
    @@ -1792,6 +1798,8 @@

    releaseBuffered

    Overrides:
    releaseBuffered in class JsonParser
    +
    Parameters:
    +
    out - OutputStream to which buffered, undecoded content is written to
    Returns:
    -1 if the underlying content source is not byte based (that is, input can not be sent to OutputStream; @@ -1846,6 +1854,8 @@

    getInputSource

    Overrides:
    getInputSource in class JsonParser
    +
    Returns:
    +
    Input source this parser was configured with
    @@ -1907,6 +1917,8 @@

    getCurrentLocation

    Overrides:
    getCurrentLocation in class ParserBase
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1924,6 +1936,8 @@

    getTokenLocation

    Overrides:
    getTokenLocation in class ParserBase
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -1942,8 +1956,12 @@

    getText

    Specified by:
    getText in class ParserMinimalBase
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1977,10 +1995,14 @@

    getText

    Overrides:
    getText in class JsonParser
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    @@ -2003,8 +2025,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2027,8 +2052,13 @@

    getValueAsString

    Overrides:
    getValueAsString in class ParserMinimalBase
    +
    Parameters:
    +
    defValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2067,8 +2097,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class ParserMinimalBase
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2091,7 +2125,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2114,7 +2149,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2151,7 +2187,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2176,7 +2213,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2202,8 +2240,12 @@

    getEmbeddedObject

    Overrides:
    getEmbeddedObject in class JsonParser
    +
    Returns:
    +
    Embedded value (usually of "native" type supported by format) + for the current token, if any; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2559,6 +2601,6 @@

    _reportInvalidOther

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParser.html index 117c566d4e..cc77812fcf 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParser.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.async.NonBlockingJsonParser (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParserBase.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParserBase.html index 37160e7964..2f329b7e4f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParserBase.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/class-use/NonBlockingJsonParserBase.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.async.NonBlockingJsonParserBase (Jackson-core 2.12.0 API) - + @@ -165,6 +165,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-frame.html index f64c0c4f66..174f49c6c4 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json.async (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-summary.html index cabe1f198f..7119b10023 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json.async (Jackson-core 2.12.0 API) - + @@ -160,6 +160,6 @@

    Package co -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-tree.html index 572435b105..9e5799a7a3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json.async Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -150,6 +150,6 @@

    Class Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-use.html index 24fedbaa31..bf3b9c4ab6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/async/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.json.async (Jackson-core 2.12.0 API) - + @@ -158,6 +158,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ByteSourceJsonBootstrapper.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ByteSourceJsonBootstrapper.html index 82c9ffbf96..ecd1f2bddf 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ByteSourceJsonBootstrapper.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ByteSourceJsonBootstrapper.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.ByteSourceJsonBootstrapper (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/DupDetector.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/DupDetector.html index 8852c68ed7..93d8cc41f7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/DupDetector.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/DupDetector.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.DupDetector (Jackson-core 2.12.0 API) - + @@ -254,6 +254,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonGeneratorImpl.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonGeneratorImpl.html index 680e4b0889..7a68801d76 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonGeneratorImpl.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonGeneratorImpl.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.JsonGeneratorImpl (Jackson-core 2.12.0 API) - + @@ -171,6 +171,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadContext.html index d1f94510f8..09836383a1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadContext.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.JsonReadContext (Jackson-core 2.12.0 API) - + @@ -273,6 +273,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadFeature.html index 210832df02..abed3092a2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonReadFeature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.JsonReadFeature (Jackson-core 2.12.0 API) - + @@ -265,6 +265,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteContext.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteContext.html index 358d379130..f79ffd809d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteContext.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteContext.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.JsonWriteContext (Jackson-core 2.12.0 API) - + @@ -300,6 +300,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteFeature.html index c1710efffb..6928ebe8eb 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/JsonWriteFeature.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.JsonWriteFeature (Jackson-core 2.12.0 API) - + @@ -265,6 +265,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/PackageVersion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/PackageVersion.html index b86acdf70c..3685e3c40a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/PackageVersion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/PackageVersion.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.PackageVersion (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ReaderBasedJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ReaderBasedJsonParser.html index e49645c343..95f23e3dcc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ReaderBasedJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/ReaderBasedJsonParser.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.ReaderBasedJsonParser (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8DataInputJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8DataInputJsonParser.html index 3174ac6ce9..bf19daf0a9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8DataInputJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8DataInputJsonParser.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.UTF8DataInputJsonParser (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8JsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8JsonGenerator.html index 77f28c3ce5..601ad4eec2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8JsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8JsonGenerator.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.UTF8JsonGenerator (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8StreamJsonParser.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8StreamJsonParser.html index 7e0223e2ad..800b2809d1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8StreamJsonParser.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/UTF8StreamJsonParser.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.UTF8StreamJsonParser (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/WriterBasedJsonGenerator.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/WriterBasedJsonGenerator.html index 025f0f27ad..70ebc47bc9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/WriterBasedJsonGenerator.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/class-use/WriterBasedJsonGenerator.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.json.WriterBasedJsonGenerator (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-frame.html index d15c73ed57..9bbf8fd5df 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-summary.html index 47cc709df4..f31d994da2 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json (Jackson-core 2.12.0 API) - + @@ -250,6 +250,6 @@

    Package com.fast -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-tree.html index d36662febe..12f4ce6f3f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.json Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -184,6 +184,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-use.html index 374a0cb6b3..ee1a1aa8aa 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/json/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.json (Jackson-core 2.12.0 API) - + @@ -259,6 +259,6 @@

    Uses o -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-frame.html index 3cc04498fc..5583479345 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-summary.html index d6e0ece42c..bca8d0ff51 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core (Jackson-core 2.12.0 API) - + @@ -475,6 +475,6 @@

    Package com.fasterxml -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-tree.html index 2860323eb3..236c174a29 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -223,6 +223,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-use.html index 8377e84efc..c5143a116c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core (Jackson-core 2.12.0 API) - + @@ -1074,6 +1074,6 @@

    Uses of Pac -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/ByteQuadsCanonicalizer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/ByteQuadsCanonicalizer.html index 3ab45c2319..45ca732a14 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/ByteQuadsCanonicalizer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/ByteQuadsCanonicalizer.html @@ -2,10 +2,10 @@ - + ByteQuadsCanonicalizer (Jackson-core 2.12.0 API) - + @@ -307,9 +307,7 @@

    Method Summary

    int -bucketCount() -
    Returns number of primary slots table has currently
    - +bucketCount()  int @@ -408,7 +406,7 @@

    Method Summary

    int spilloverCount()
    Method mostly needed by unit tests; calculates number of entries - in shared spillover area
    + in shared spill-over area @@ -662,6 +660,10 @@

    createRoot

    public static ByteQuadsCanonicalizer createRoot()
    Factory method to call to create a symbol table instance with a randomized seed value.
    +
    +
    Returns:
    +
    Root instance to use for constructing new child instances
    +
    @@ -682,6 +684,12 @@

    makeChild

    public ByteQuadsCanonicalizer makeChild(int flags)
    Factory method used to create actual symbol table instance to use for parsing.
    +
    +
    Parameters:
    +
    flags - Bit flags of active JsonFactory.Features enabled.
    +
    Returns:
    +
    Actual canonicalizer instance that can be used by a parser
    +
    @@ -704,6 +712,10 @@

    release

  • size

    public int size()
    +
    +
    Returns:
    +
    Number of symbol entries contained by this canonicalizer instance
    +
    •  @@ -713,7 +725,10 @@

    size

  • bucketCount

    public int bucketCount()
    -
    Returns number of primary slots table has currently
    +
    +
    Returns:
    +
    number of primary slots table has currently
    +
    •  @@ -726,6 +741,10 @@

    maybeDirty

    Method called to check to quickly see if a child symbol table may have gotten additional entries. Used for checking to see if a child table should be merged into shared table.
    +
    +
    Returns:
    +
    Whether main hash area has been modified
    +
     @@ -747,6 +766,10 @@

    primaryCount

    Method mostly needed by unit tests; calculates number of entries that are in the primary slot set. These are "perfect" entries, accessible with a single lookup
    +
    +
    Returns:
    +
    Number of entries in the primary hash area
    +
     @@ -758,6 +781,10 @@

    secondaryCount

    public int secondaryCount()
    Method mostly needed by unit tests; calculates number of entries in secondary buckets
    +
    +
    Returns:
    +
    Number of entries in the secondary hash area
    +
     @@ -769,6 +796,10 @@

    tertiaryCount

    public int tertiaryCount()
    Method mostly needed by unit tests; calculates number of entries in tertiary buckets
    +
    +
    Returns:
    +
    Number of entries in the tertiary hash area
    +
     @@ -779,7 +810,11 @@

    tertiaryCount

    spilloverCount

    public int spilloverCount()
    Method mostly needed by unit tests; calculates number of entries - in shared spillover area
    + in shared spill-over area +
    +
    Returns:
    +
    Number of entries in the linear spill-over areay
    +
     @@ -1006,6 +1041,6 @@

    _reportTooManyCollisions

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/CharsToNameCanonicalizer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/CharsToNameCanonicalizer.html index 0fcda6da57..3fe6e65459 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/CharsToNameCanonicalizer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/CharsToNameCanonicalizer.html @@ -2,10 +2,10 @@ - + CharsToNameCanonicalizer (Jackson-core 2.12.0 API) - + @@ -601,6 +601,10 @@

    createRoot

    Method called to create root canonicalizer for a JsonFactory instance. Root instance is never used directly; its main use is for storing and sharing underlying symbol arrays as needed.
    +
    +
    Returns:
    +
    Root instance to use for constructing new child instances
    +
    @@ -629,6 +633,12 @@

    makeChild

    actively. Instead, a separate 'root' instance should be used on which only makeChild/mergeChild are called, but instance itself is not used as a symbol table. +
    +
    Parameters:
    +
    flags - Bit flags of active JsonFactory.Features enabled.
    +
    Returns:
    +
    Actual canonicalizer instance that can be used by a parser
    +
    @@ -651,6 +661,10 @@

    release

  • size

    public int size()
    +
    +
    Returns:
    +
    Number of symbol entries contained by this canonicalizer instance
    +
    •  @@ -663,8 +677,8 @@

    bucketCount

    Method for checking number of primary hash buckets this symbol table uses.
    -
    Since:
    -
    2.1
    +
    Returns:
    +
    number of primary slots table has currently
    @@ -697,6 +711,8 @@

    collisionCount

    entries that are in collision list. Value can be at most (    size() - 1), but should usually be much lower, ideally 0.
    +
    Returns:
    +
    Number of collisions in the primary hash area
    Since:
    2.1
    @@ -713,6 +729,8 @@

    maxCollisionLength

    longest collision chain. This should typically be a low number, but may be up to size() - 1 in the pathological case
    +
    Returns:
    +
    Length of the collision chain
    Since:
    2.1
    @@ -739,6 +757,12 @@

    _hashToIndex

    public int _hashToIndex(int rawHash)
    Helper method that takes in a "raw" hash value, shuffles it as necessary, and truncates to be used as the index.
    +
    +
    Parameters:
    +
    rawHash - Raw hash value to use for calculating index
    +
    Returns:
    +
    Index value calculated
    +
    @@ -756,8 +780,11 @@

    calcHash

    it needs to be done for parsed "String" too.
    Parameters:
    -
    len - Length of String; has to be at least 1 (caller guarantees - this pre-condition)
    +
    buffer - Input buffer that contains name to decode
    +
    start - Pointer to the first character of the name
    +
    len - Length of String; has to be at least 1 (caller guarantees)
    +
    Returns:
    +
    Hash code calculated
    @@ -778,6 +805,8 @@

    calcHash

    reportTooManyCollisions

    protected void reportTooManyCollisions(int maxLen)
    +
    Parameters:
    +
    maxLen - Maximum allowed length of collision chain
    Since:
    2.1
    @@ -867,6 +896,6 @@

    verifyInternalConsistency

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name.html index ae009e9122..7ca034c6f0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name.html @@ -2,10 +2,10 @@ - + Name (Jackson-core 2.12.0 API) - + @@ -323,10 +323,6 @@

    equals

    public abstract boolean equals(int q1,
                                int q2,
                                int q3)
    -
    -
    Since:
    -
    2.6
    -
    @@ -447,6 +443,6 @@

    equals

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name1.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name1.html index d415c64cac..33795d80a7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name1.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name1.html @@ -2,10 +2,10 @@ - + Name1 (Jackson-core 2.12.0 API) - + @@ -344,6 +344,6 @@

    equals

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name2.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name2.html index 207ecbcb3b..3891ba797b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name2.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name2.html @@ -2,10 +2,10 @@ - + Name2 (Jackson-core 2.12.0 API) - + @@ -331,6 +331,6 @@

    equals

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name3.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name3.html index 7e87f93e4c..3eb5c3cc8c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name3.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/Name3.html @@ -2,10 +2,10 @@ - + Name3 (Jackson-core 2.12.0 API) - + @@ -327,6 +327,6 @@

    equals

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/NameN.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/NameN.html index 5bff5118ed..a5927678dd 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/NameN.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/NameN.html @@ -2,10 +2,10 @@ - + NameN (Jackson-core 2.12.0 API) - + @@ -345,6 +345,6 @@

    equals

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/ByteQuadsCanonicalizer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/ByteQuadsCanonicalizer.html index 190d2e178d..5e40067531 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/ByteQuadsCanonicalizer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/ByteQuadsCanonicalizer.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.ByteQuadsCanonicalizer (Jackson-core 2.12.0 API) - + @@ -377,6 +377,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/CharsToNameCanonicalizer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/CharsToNameCanonicalizer.html index 40ae648976..3260e3a687 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/CharsToNameCanonicalizer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/CharsToNameCanonicalizer.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.CharsToNameCanonicalizer (Jackson-core 2.12.0 API) - + @@ -300,6 +300,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name.html index d4cb05ee75..5b1025cd47 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.Name (Jackson-core 2.12.0 API) - + @@ -188,6 +188,6 @@

    Uses of -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name1.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name1.html index 7dbbc36e86..790381e1df 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name1.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name1.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.Name1 (Jackson-core 2.12.0 API) - + @@ -164,6 +164,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name2.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name2.html index e56dc3b63c..29c36d8947 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name2.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name2.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.Name2 (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Use -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name3.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name3.html index 6a71916b0f..3052b5a154 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name3.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/Name3.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.Name3 (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Use -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/NameN.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/NameN.html index 6bda1867c8..c2c3db17b6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/NameN.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/class-use/NameN.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.sym.NameN (Jackson-core 2.12.0 API) - + @@ -167,6 +167,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-frame.html index 6a4437bd6a..730397a620 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.sym (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-summary.html index 37717196d1..3737f15e20 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.sym (Jackson-core 2.12.0 API) - + @@ -196,6 +196,6 @@

    Package com.faste -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-tree.html index acf9a3ee89..0bf8cfd4c0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.sym Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -143,6 +143,6 @@

    Class Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-use.html index 23cd616c53..6347940a18 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/sym/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.sym (Jackson-core 2.12.0 API) - + @@ -276,6 +276,6 @@

    Uses of -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/ResolvedType.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/ResolvedType.html index 5606db9c5e..f876443edf 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/ResolvedType.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/ResolvedType.html @@ -2,10 +2,10 @@ - + ResolvedType (Jackson-core 2.12.0 API) - + @@ -675,6 +675,6 @@

    toCanonical

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/TypeReference.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/TypeReference.html index 94db945e6f..ea20b2ba56 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/TypeReference.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/TypeReference.html @@ -2,10 +2,10 @@ - + TypeReference (Jackson-core 2.12.0 API) - + @@ -354,6 +354,6 @@

    compareTo

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.Inclusion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.Inclusion.html index 5962d134fb..0f6ab99329 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.Inclusion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.Inclusion.html @@ -2,10 +2,10 @@ - + WritableTypeId.Inclusion (Jackson-core 2.12.0 API) - + @@ -455,6 +455,6 @@

    requiresObjectContext

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.html index 57222bf867..645c8e02a4 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/WritableTypeId.html @@ -2,10 +2,10 @@ - + WritableTypeId (Jackson-core 2.12.0 API) - + @@ -515,6 +515,6 @@

    WritableTypeId

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/ResolvedType.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/ResolvedType.html index 3f69dc2877..8da860831b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/ResolvedType.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/ResolvedType.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.type.ResolvedType (Jackson-core 2.12.0 API) - + @@ -233,6 +233,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/TypeReference.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/TypeReference.html index 74f13e995d..0a898f7e4c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/TypeReference.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/TypeReference.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.type.TypeReference (Jackson-core 2.12.0 API) - + @@ -224,6 +224,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.Inclusion.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.Inclusion.html index a4fd0367e2..6fe87778c0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.Inclusion.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.Inclusion.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.type.WritableTypeId.Inclusion (Jackson-core 2.12.0 API) - + @@ -190,6 +190,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.html index c3420520bf..10c55c9db7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/class-use/WritableTypeId.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.type.WritableTypeId (Jackson-core 2.12.0 API) - + @@ -113,11 +113,17 @@

    Uses of WritableTypeId -JsonGenerator.writeTypePrefix(WritableTypeId typeIdDef)  +JsonGenerator.writeTypePrefix(WritableTypeId typeIdDef) +
    Replacement method for JsonGenerator.writeTypeId(Object) which is called + regardless of whether format has native type ids.
    + WritableTypeId -JsonGenerator.writeTypeSuffix(WritableTypeId typeIdDef)  +JsonGenerator.writeTypeSuffix(WritableTypeId typeIdDef) +
    Method to call along with JsonGenerator.writeTypePrefix(com.fasterxml.jackson.core.type.WritableTypeId), but after actual value + that has type id has been completely written.
    + @@ -130,11 +136,17 @@

    Uses of WritableTypeId -JsonGenerator.writeTypePrefix(WritableTypeId typeIdDef)  +JsonGenerator.writeTypePrefix(WritableTypeId typeIdDef) +
    Replacement method for JsonGenerator.writeTypeId(Object) which is called + regardless of whether format has native type ids.
    + WritableTypeId -JsonGenerator.writeTypeSuffix(WritableTypeId typeIdDef)  +JsonGenerator.writeTypeSuffix(WritableTypeId typeIdDef) +
    Method to call along with JsonGenerator.writeTypePrefix(com.fasterxml.jackson.core.type.WritableTypeId), but after actual value + that has type id has been completely written.
    + @@ -190,6 +202,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-frame.html index 4bbeebe7cb..7f93df1799 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.type (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-summary.html index 837110e500..df0e83f348 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.type (Jackson-core 2.12.0 API) - + @@ -195,6 +195,6 @@

    Package com.fast -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-tree.html index 4cc58e6db2..fee4b93f24 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.type Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -148,6 +148,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-use.html index 145c0be853..cae633c801 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/type/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.type (Jackson-core 2.12.0 API) - + @@ -218,6 +218,6 @@

    Uses o -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecycler.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecycler.html index 6ac23542eb..725ae1e309 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecycler.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecycler.html @@ -2,10 +2,10 @@ - + BufferRecycler (Jackson-core 2.12.0 API) - + @@ -494,6 +494,9 @@

    BufferRecycler

    Alternate constructor to be used by sub-classes, to allow customization of number of low-level buffers in use.
    +
    Parameters:
    +
    bbCount - Number of byte[] buffers to allocate
    +
    cbCount - Number of char[] buffers to allocate
    Since:
    2.4
    @@ -517,6 +520,8 @@

    allocByteBuffer

    Parameters:
    ix - One of READ_IO_BUFFER constants.
    +
    Returns:
    +
    Buffer allocated (possibly recycled)
    @@ -674,6 +679,6 @@

    calloc

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecyclers.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecyclers.html index f5766a1ed8..586f9ef3e6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecyclers.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/BufferRecyclers.html @@ -2,10 +2,10 @@ - + BufferRecyclers (Jackson-core 2.12.0 API) - + @@ -285,6 +285,10 @@

    Method Detail

    getBufferRecycler

    public static BufferRecycler getBufferRecycler()
    Main accessor to call for accessing possibly recycled BufferRecycler instance.
    +
    +
    Returns:
    +
    BufferRecycler to use
    +
    @@ -378,6 +382,6 @@

    releaseBuffers

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/ByteArrayBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/ByteArrayBuilder.html index ba1c67327e..babc9d8b8d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/ByteArrayBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/ByteArrayBuilder.html @@ -2,10 +2,10 @@ - + ByteArrayBuilder (Jackson-core 2.12.0 API) - + @@ -411,6 +411,8 @@

    reset

    size

    public int size()
    +
    Returns:
    +
    Number of bytes aggregated so far
    Since:
    2.9
    @@ -462,10 +464,6 @@

    appendThreeBytes

  • appendFourBytes

    public void appendFourBytes(int b32)
    -
    -
    Since:
    -
    2.9
    -
    • @@ -477,6 +475,10 @@

    toByteArray

    public byte[] toByteArray()
    Method called when results are finalized and we can get the full aggregated result buffer to return to the caller
    +
    +
    Returns:
    +
    Aggregated contents as a byte[]
    +
     @@ -488,6 +490,10 @@

    resetAndGetFirstSegment

    public byte[] resetAndGetFirstSegment()
    Method called when starting "manual" output: will clear out current state and return the first segment buffer to fill
    +
    +
    Returns:
    +
    Segment to use for writing
    +
     @@ -500,6 +506,10 @@

    finishCurrentSegment

    Method called when the current segment buffer is full; will append to current contents, allocate a new segment buffer and return it
    +
    +
    Returns:
    +
    Segment to use for writing
    +
     @@ -689,6 +699,6 @@

    flush

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultIndenter.html index 1384eaf939..c4beb01182 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultIndenter.html @@ -2,10 +2,10 @@ - + DefaultIndenter (Jackson-core 2.12.0 API) - + @@ -185,7 +185,7 @@

    Constructor Summary

    DefaultIndenter(String indent, String eol)
    Create an indenter which uses the indent string to indent one level - and the eol string to separate lines.
    + and the eol string to separate lines. @@ -295,7 +295,12 @@

    DefaultIndenter

    public DefaultIndenter(String indent,
                        String eol)
    Create an indenter which uses the indent string to indent one level - and the eol string to separate lines.
    + and the eol string to separate lines. +
    +
    Parameters:
    +
    indent - Indentation String to prepend for a single level of indentation
    +
    eol - End-of-line marker to use after indented line
    +
    @@ -448,6 +453,6 @@

    getIndent

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.FixedSpaceIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.FixedSpaceIndenter.html index 0d40f329a5..d6535b6881 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.FixedSpaceIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.FixedSpaceIndenter.html @@ -2,10 +2,10 @@ - + DefaultPrettyPrinter.FixedSpaceIndenter (Jackson-core 2.12.0 API) - + @@ -357,6 +357,6 @@

    isInline

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.Indenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.Indenter.html index 17c794d217..1bbd3f2a4d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.Indenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.Indenter.html @@ -2,10 +2,10 @@ - + DefaultPrettyPrinter.Indenter (Jackson-core 2.12.0 API) - + @@ -255,6 +255,6 @@

    isInline

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.NopIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.NopIndenter.html index 8326f79dc7..f7e17d291e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.NopIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.NopIndenter.html @@ -2,10 +2,10 @@ - + DefaultPrettyPrinter.NopIndenter (Jackson-core 2.12.0 API) - + @@ -351,6 +351,6 @@

    isInline

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.html index d7b24c9093..4c50094dd0 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/DefaultPrettyPrinter.html @@ -2,10 +2,10 @@ - + DefaultPrettyPrinter (Jackson-core 2.12.0 API) - + @@ -346,7 +346,9 @@

    Method Summary

    DefaultPrettyPrinter -withSeparators(Separators separators)  +withSeparators(Separators separators) +
    Method for configuring separators for this pretty-printer to use
    + DefaultPrettyPrinter @@ -565,9 +567,7 @@

    DefaultPrettyPrinter

    calls DefaultPrettyPrinter(SerializableString)
    Parameters:
    -
    rootSeparator -
    -
    Since:
    -
    2.1
    +
    rootSeparator - String to use as root value separator
    @@ -582,9 +582,7 @@

    DefaultPrettyPrinter

    if null, no separator is printed.
    Parameters:
    -
    rootSeparator -
    -
    Since:
    -
    2.1
    +
    rootSeparator - String to use as root value separator
    @@ -632,6 +630,10 @@

    withRootSeparator

    withRootSeparator

    public DefaultPrettyPrinter withRootSeparator(String rootSeparator)
    +
    Parameters:
    +
    rootSeparator - Root-level value separator to use
    +
    Returns:
    +
    This pretty-printer instance (for call chaining)
    Since:
    2.6
    @@ -662,10 +664,6 @@

    indentObjectsWith

  • withArrayIndenter

    public DefaultPrettyPrinter withArrayIndenter(DefaultPrettyPrinter.Indenter i)
    -
    -
    Since:
    -
    2.3
    -
    • @@ -675,10 +673,6 @@

    withArrayIndenter

  • withObjectIndenter

    public DefaultPrettyPrinter withObjectIndenter(DefaultPrettyPrinter.Indenter i)
    -
    -
    Since:
    -
    2.3
    -
    • @@ -693,6 +687,8 @@

    withSpacesInObjectEntries

    does this, it is returned; if not, a new instance will be constructed and returned.
    +
    Returns:
    +
    This pretty-printer instance (for call chaining)
    Since:
    2.3
    @@ -710,6 +706,8 @@

    withoutSpacesInObjectEntries

    does this, it is returned; if not, a new instance will be constructed and returned.
    +
    Returns:
    +
    This pretty-printer instance (for call chaining)
    Since:
    2.3
    @@ -731,7 +729,12 @@

    _withSpaces

  • withSeparators

    public DefaultPrettyPrinter withSeparators(Separators separators)
    +
    Method for configuring separators for this pretty-printer to use
    +
    Parameters:
    +
    separators - Separator definitions to use
    +
    Returns:
    +
    This pretty-printer instance (for call chaining)
    Since:
    2.9
    @@ -751,6 +754,8 @@

    createInstance

    Specified by:
    createInstance in interface Instantiatable<DefaultPrettyPrinter>
    +
    Returns:
    +
    Actual instance to use
    • @@ -766,16 +771,18 @@

    writeRootValueSeparator

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

    - Default - handling (without pretty-printing) will output a space, to + Default handling (without pretty-printing) will output a space, to allow values to be parsed correctly. Pretty-printer is to output some other suitable and nice-looking separator (tab(s), space(s), linefeed(s) or any combination thereof).

    Specified by:
    writeRootValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -799,8 +806,11 @@

    writeStartObject

    Specified by:
    writeStartObject in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -823,8 +833,11 @@

    beforeObjectEntries

    Specified by:
    beforeObjectEntries in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -846,8 +859,11 @@

    writeObjectFieldValueSeparator

    Specified by:
    writeObjectFieldValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -869,8 +885,11 @@

    writeObjectEntrySeparator

    Specified by:
    writeObjectEntrySeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -895,10 +914,13 @@

    writeEndObject

    Specified by:
    writeEndObject in interface PrettyPrinter
    -
    nrOfEntries - Number of direct members of the array that +
    Parameters:
    +
    g - Generator used for output
    +
    nrOfEntries - Number of direct members of the Object that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -922,8 +944,11 @@

    writeStartArray

    Specified by:
    writeStartArray in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -945,8 +970,11 @@

    beforeArrayValues

    Specified by:
    beforeArrayValues in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -968,8 +996,11 @@

    writeArrayValueSeparator

    Specified by:
    writeArrayValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -994,10 +1025,13 @@

    writeEndArray

    Specified by:
    writeEndArray in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    nrOfValues - Number of direct members of the array that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1070,6 +1104,6 @@

    writeEndArray

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Instantiatable.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Instantiatable.html index 540cee0e15..9f5f3422ef 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Instantiatable.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Instantiatable.html @@ -2,10 +2,10 @@ - + Instantiatable (Jackson-core 2.12.0 API) - + @@ -171,6 +171,10 @@

    createInstance

    Method called to ensure that we have a non-blueprint object to use; it is either this object (if stateless), or a newly created object with separate state.
    +
    +
    Returns:
    +
    Actual instance to use
    +
    @@ -242,6 +246,6 @@

    createInstance

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/InternCache.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/InternCache.html index df5eaf49b0..cbab6e23c8 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/InternCache.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/InternCache.html @@ -2,10 +2,10 @@ - + InternCache (Jackson-core 2.12.0 API) - + @@ -338,6 +338,6 @@

    intern

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeature.html index e069f46f54..6b9e1ed8fa 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeature.html @@ -2,10 +2,10 @@ - + JacksonFeature (Jackson-core 2.12.0 API) - + @@ -146,14 +146,14 @@

    Method Summary

    boolean enabledIn(int flags) -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. @@ -179,6 +179,10 @@

    Method Detail

    enabledByDefault

    boolean enabledByDefault()
    Accessor for checking whether this feature is enabled by default.
    +
    +
    Returns:
    +
    Whether this instance is enabled by default or not
    +
    @@ -189,7 +193,11 @@

    enabledByDefault

    getMask

    int getMask()
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N. +
    +
    Returns:
    +
    Bit mask of this feature
    +
     @@ -199,7 +207,13 @@

    getMask

  • enabledIn

    boolean enabledIn(int flags)
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    +
    +
    Parameters:
    +
    flags - Bit field that contains a set of enabled features of this type
    +
    Returns:
    +
    True if this feature is enabled in passed bit field
    +
    • @@ -271,6 +285,6 @@

    enabledIn

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeatureSet.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeatureSet.html index 834a85577f..23b7bf751c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeatureSet.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JacksonFeatureSet.html @@ -2,10 +2,10 @@ - + JacksonFeatureSet (Jackson-core 2.12.0 API) - + @@ -268,6 +268,10 @@

    JacksonFeatureSet

    Constructor for creating instance with specific bitmask, wherein 1 bit means matching JacksonFeature is enabled and 0 disabled.
    +
    +
    Parameters:
    +
    bitmask - Bitmask for features that are enabled
    +
    @@ -290,8 +294,13 @@

    fromDefaults

    "Default" factory which will calculate settings based on default-enabled status of all features.
    +
    Type Parameters:
    +
    F - Self-reference type for convenience
    Parameters:
    -
    allFeatures - Set of all features (enabled or disabled): usually from Enum.values()
    +
    allFeatures - Set of all features (enabled or disabled): usually from + Enum.values()
    +
    Returns:
    +
    Feature set instance constructed
    @@ -445,6 +454,6 @@

    asBitmask

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonGeneratorDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonGeneratorDelegate.html index 2aaa77dd4b..5fcfb0f604 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonGeneratorDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonGeneratorDelegate.html @@ -2,10 +2,10 @@ - + JsonGeneratorDelegate (Jackson-core 2.12.0 API) - + @@ -290,14 +290,14 @@

    Method Summary

    JsonGenerator disable(JsonGenerator.Feature f) -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    JsonGenerator enable(JsonGenerator.Feature f) -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    @@ -364,7 +364,10 @@

    Method Summary

    JsonStreamContext -getOutputContext()  +getOutputContext() +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    + Object @@ -385,13 +388,13 @@

    Method Summary

    FormatSchema getSchema() -
    Method for accessing Schema that this parser uses, if any.
    +
    Method for accessing Schema that this generator uses, if any; null if none.
    JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities() -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    @@ -567,8 +570,9 @@

    Method Summary

    void writeEmbeddedObject(Object object) -
    Method that can be called on backends that support passing opaque datatypes of - non-JSON formats
    +
    Method that can be called on backends that support passing opaque native + values that some data formats support; not used with JSON backend, + more common with binary formats.
    @@ -795,19 +799,31 @@

    Method Summary

    void writeStartArray(int size)
    Method for writing start marker of an Array value, similar - to JsonGenerator.writeStartArray(), but also specifying how many + to JsonGenerator.writeStartArray(), + but also specifying how many elements will be written for the array before calling JsonGenerator.writeEndArray().
    void -writeStartArray(Object forValue)  +writeStartArray(Object forValue) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    + void writeStartArray(Object forValue, - int size)  + int size) +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    + void @@ -964,6 +980,7 @@

    JsonGeneratorDelegate

    boolean delegateCopyMethods)
    Parameters:
    +
    d - Underlying generator to delegate calls to
    delegateCopyMethods - Flag assigned to delagateCopyMethod and which defines whether copy methods are handled locally (false), or delegated to configured
    @@ -991,13 +1008,15 @@

    getCurrentValue

    getOutputContext().getCurrentValue();

    - Note that "current value" is NOT populated (or used) by Streaming parser; + Note that "current value" is NOT populated (or used) by Streaming parser or generators; 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.

    Overrides:
    getCurrentValue in class JsonGenerator
    +
    Returns:
    +
    "Current value" associated with the current context (state) of this generator
    @@ -1016,6 +1035,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonGenerator
    +
    Parameters:
    +
    v - Current value to assign for the current context of this generator
    @@ -1033,6 +1054,8 @@

    getCodec

    Specified by:
    getCodec in class JsonGenerator
    +
    Returns:
    +
    Codec assigned to this generator, if any; null if none
    @@ -1050,8 +1073,10 @@

    setCodec

    Specified by:
    setCodec in class JsonGenerator
    +
    Parameters:
    +
    oc - Codec to assign, if any; null if none
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1088,11 +1113,13 @@

    setSchema

    getSchema

    public FormatSchema getSchema()
    Description copied from class: JsonGenerator
    -
    Method for accessing Schema that this parser uses, if any. +
    Method for accessing Schema that this generator uses, if any; null if none. Default implementation returns null.
    Overrides:
    getSchema in class JsonGenerator
    +
    Returns:
    +
    Schema in use by this generator, if any; null if none
    @@ -1110,6 +1137,9 @@

    version

    version in interface Versioned
    Specified by:
    version in class JsonGenerator
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -1137,6 +1167,8 @@

    getOutputTarget

    Overrides:
    getOutputTarget in class JsonGenerator
    +
    Returns:
    +
    Output target this generator was configured with
    @@ -1209,6 +1241,10 @@

    canWriteTypeId

    Overrides:
    canWriteTypeId in class JsonGenerator
    +
    Returns:
    +
    True if this generator is capable of writing "native" Type Ids + (which is typically determined by capabilities of the underlying format), + false if not
    @@ -1233,6 +1269,10 @@

    canWriteObjectId

    Overrides:
    canWriteObjectId in class JsonGenerator
    +
    Returns:
    +
    True if this generator is capable of writing "native" Object Ids + (which is typically determined by capabilities of the underlying format), + false if not
    @@ -1253,6 +1293,11 @@

    canWriteBinaryNatively

    Overrides:
    canWriteBinaryNatively in class JsonGenerator
    +
    Returns:
    +
    True if this generator is capable of writing "raw" Binary + Content + (this is typically determined by capabilities of the underlying format); + false if not
    @@ -1271,6 +1316,9 @@

    canOmitFields

    Overrides:
    canOmitFields in class JsonGenerator
    +
    Returns:
    +
    True if this generator is allowed to only write values + of some Object fields and omit the rest; false if not
    @@ -1293,6 +1341,11 @@

    canWriteFormattedNumbers

    Overrides:
    canWriteFormattedNumbers in class JsonGenerator
    +
    Returns:
    +
    True if this generator is capable of writing "formatted" + numbers (and if so, need to be passed using + JsonGenerator.writeNumber(String), that is, passed as String); + false if not
    @@ -1304,13 +1357,13 @@

    canWriteFormattedNumbers

    getWriteCapabilities

    public JacksonFeatureSet<StreamWriteCapability> getWriteCapabilities()
    Description copied from class: JsonGenerator
    -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    Overrides:
    getWriteCapabilities in class JsonGenerator
    Returns:
    -
    Set of read capabilities for content to read via this parser
    +
    Set of write capabilities for content written using this generator
    @@ -1322,13 +1375,15 @@

    getWriteCapabilities

    enable

    public JsonGenerator enable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    Specified by:
    enable in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to enable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1340,13 +1395,15 @@

    enable

    disable

    public JsonGenerator disable(JsonGenerator.Feature f)
    Description copied from class: JsonGenerator
    -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    Specified by:
    disable in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to disable
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1363,6 +1420,10 @@

    isEnabled

    Specified by:
    isEnabled in class JsonGenerator
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if specified feature is enabled; false if not
    @@ -1402,7 +1463,7 @@

    setFeatureMask

    mask - Bitmask that defines which JsonGenerator.Features are enabled and which disabled
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This generator, to allow call chaining
    @@ -1429,6 +1490,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1453,6 +1516,8 @@

    overrideFormatFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1474,8 +1539,10 @@

    setPrettyPrinter

    Overrides:
    setPrettyPrinter in class JsonGenerator
    +
    Parameters:
    +
    pp - PrettyPrinter to assign, if any; null if none
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1492,6 +1559,8 @@

    getPrettyPrinter

    Overrides:
    getPrettyPrinter in class JsonGenerator
    +
    Returns:
    +
    PrettyPrinter configured for this generator, if any; null if none
    @@ -1510,7 +1579,7 @@

    useDefaultPrettyPrinter

    Specified by:
    useDefaultPrettyPrinter in class JsonGenerator
    Returns:
    -
    Generator itself (this), to allow chaining
    +
    This generator, to allow call chaining
    @@ -1544,6 +1613,8 @@

    setHighestNonEscapedChar

    charCode - Either -1 to indicate that no additional escaping is to be done; or highest code point not to escape (meaning higher ones will be), if positive value.
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1584,6 +1655,8 @@

    getCharacterEscapes

    Overrides:
    getCharacterEscapes in class JsonGenerator
    +
    Returns:
    +
    CharacterEscapes configured for this generator, if any; null if none
    @@ -1602,6 +1675,10 @@

    setCharacterEscapes

    Overrides:
    setCharacterEscapes in class JsonGenerator
    +
    Parameters:
    +
    esc - CharacterEscapes to configure this generator to use, if any; null if none
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1623,6 +1700,8 @@

    setRootValueSeparator

    Parameters:
    sep - Separator to use, if any; null means that no separator is automatically added
    +
    Returns:
    +
    This generator, to allow call chaining
    @@ -1646,7 +1725,8 @@

    writeStartArray

    Specified by:
    writeStartArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1660,7 +1740,8 @@

    writeStartArray

    throws IOException
    Description copied from class: JsonGenerator
    Method for writing start marker of an Array value, similar - to JsonGenerator.writeStartArray(), but also specifying how many + to JsonGenerator.writeStartArray(), + but also specifying how many elements will be written for the array before calling JsonGenerator.writeEndArray().

    @@ -1672,9 +1753,10 @@

    writeStartArray

    size - Number of elements this array will have: actual number of values written (before matching call to JsonGenerator.writeEndArray() MUST match; generator MAY verify - this is the case.
    + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1686,11 +1768,19 @@

    writeStartArray

    writeStartArray

    public void writeStartArray(Object forValue)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1703,11 +1793,24 @@

    writeStartArray

    public void writeStartArray(Object forValue,
                             int size)
                      throws IOException
    +
    Description copied from class: JsonGenerator
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    Overrides:
    writeStartArray in class JsonGenerator
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Array context being created
    +
    size - Number of elements this Array will have: actual + number of values written (before matching call to + JsonGenerator.writeEndArray() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1730,7 +1833,8 @@

    writeEndArray

    Specified by:
    writeEndArray in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1754,7 +1858,8 @@

    writeStartObject

    Specified by:
    writeStartObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1779,8 +1884,11 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGenerator
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1809,8 +1917,15 @@

    writeStartObject

    Overrides:
    writeStartObject in class JsonGenerator
    +
    Parameters:
    +
    forValue - "Current value" to assign for the Object context being created
    +
    size - Number of key/value pairs this Object will have: actual + number of entries written (before matching call to + JsonGenerator.writeEndObject() MUST match; generator MAY verify + this is the case (and SHOULD if format itself encodes length)
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1835,7 +1950,8 @@

    writeEndObject

    Specified by:
    writeEndObject in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1858,8 +1974,11 @@

    writeFieldName

    Specified by:
    writeFieldName in class JsonGenerator
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1884,8 +2003,11 @@

    writeFieldName

    Specified by:
    writeFieldName in class JsonGenerator
    +
    Parameters:
    +
    name - Field name to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1907,8 +2029,11 @@

    writeFieldId

    Overrides:
    writeFieldId in class JsonGenerator
    +
    Parameters:
    +
    id - Field id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1934,7 +2059,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1960,7 +2086,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -1986,7 +2113,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2012,7 +2140,8 @@

    writeArray

    offset - Offset of the first element to write, within array
    length - Number of elements in array to write, from `offset` to `offset + len - 1`
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2033,8 +2162,11 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Text value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2053,14 +2185,23 @@

    writeString

    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. - If the reader is null, then write a null. - If len is < 0, then write all contents of the reader. - Otherwise, write only len characters.
    + If len is < 0, then write all contents of the reader. + Otherwise, write only len characters. +

    + Note: actual length of content available may exceed len but + can not be less than it: if not enough content available, a + JsonGenerationException will be thrown.

    Overrides:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    reader - Reader to use for reading Text value to write
    +
    len - Maximum Length of Text value to read (in chars, non-negative) + if known; -1 to indicate "read and write it all"
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer; or if length (len) is specified but + reader does not provide enough content
    @@ -2083,8 +2224,13 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first character of String value to write
    +
    len - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2108,8 +2254,11 @@

    writeString

    Specified by:
    writeString in class JsonGenerator
    +
    Parameters:
    +
    text - Pre-encoded String value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2139,8 +2288,13 @@

    writeRawUTF8String

    Specified by:
    writeRawUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2174,8 +2328,13 @@

    writeUTF8String

    Specified by:
    writeUTF8String in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that contains String value to write
    +
    offset - Offset in buffer of the first byte of String value to write
    +
    length - Length of the String value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2201,8 +2360,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Textual contents to include as-is in output.
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2230,8 +2392,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - String that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2262,8 +2429,11 @@

    writeRaw

    Overrides:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    raw - Pre-encoded textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2291,8 +2461,13 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    text - Buffer that has contents to include as-is in output
    +
    offset - Offset within text of the first character to output
    +
    len - Length of content (from text, starting at offset offset) to output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2318,8 +2493,11 @@

    writeRaw

    Specified by:
    writeRaw in class JsonGenerator
    +
    Parameters:
    +
    c - Character to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2341,8 +2519,11 @@

    writeRawValue

    Specified by:
    writeRawValue in class JsonGenerator
    +
    Parameters:
    +
    text - Textual contents to included in output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2416,8 +2597,12 @@

    writeBinary

    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. +
    data - Buffer that contains binary data to write
    +
    offset - Offset in data of the first byte of data to write
    +
    len - Length of data to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2453,7 +2638,8 @@

    writeBinary

    Returns:
    Number of bytes read from data and written as binary payload
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2477,7 +2663,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2501,7 +2688,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2525,7 +2713,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2549,7 +2738,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2573,7 +2763,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2597,7 +2788,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2621,7 +2813,8 @@

    writeNumber

    Parameters:
    v - Number value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2652,12 +2845,15 @@

    writeNumber

    Specified by:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValue - Textual (possibly format) number representation to write
    Throws:
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    UnsupportedOperationException - If underlying data format does not support numbers serialized textually AND if generator is not allowed to just output a String instead (Schema-based formats may require actual number, for example)
    -
    IOException
    @@ -2678,8 +2874,13 @@

    writeNumber

    Overrides:
    writeNumber in class JsonGenerator
    +
    Parameters:
    +
    encodedValueBuffer - Buffer that contains the textual number representation to write
    +
    offset - Offset of the first character of value to write
    +
    length - Length of the value (in characters) to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    UnsupportedOperationException
    @@ -2702,8 +2903,11 @@

    writeBoolean

    Specified by:
    writeBoolean in class JsonGenerator
    +
    Parameters:
    +
    state - Boolean value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2725,7 +2929,8 @@

    writeNull

    Specified by:
    writeNull in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2746,8 +2951,11 @@

    writeOmittedField

    Overrides:
    writeOmittedField in class JsonGenerator
    +
    Parameters:
    +
    fieldName - Name of the field omitted
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2770,8 +2978,13 @@

    writeObjectId

    Overrides:
    writeObjectId in class JsonGenerator
    +
    Parameters:
    +
    id - Native Object Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Object ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -2794,8 +3007,13 @@

    writeObjectRef

    Overrides:
    writeObjectRef in class JsonGenerator
    +
    Parameters:
    +
    id - Referenced value, for which Object Id is expected to be written
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Object ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -2818,8 +3036,13 @@

    writeTypeId

    Overrides:
    writeTypeId in class JsonGenerator
    +
    Parameters:
    +
    id - Native Type Id to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    +
    JsonGenerationException - if Type ID output is not allowed + (either at all, or specifically in this position in output)
    @@ -2832,13 +3055,20 @@

    writeEmbeddedObject

    public void writeEmbeddedObject(Object object)
                          throws IOException
    Description copied from class: JsonGenerator
    -
    Method that can be called on backends that support passing opaque datatypes of - non-JSON formats
    +
    Method that can be called on backends that support passing opaque native + values that some data formats support; not used with JSON backend, + more common with binary formats. +

    + NOTE: this is NOT the method to call for serializing regular POJOs, + see JsonGenerator.writeObject(java.lang.Object) instead.

    Overrides:
    writeEmbeddedObject in class JsonGenerator
    +
    Parameters:
    +
    object - Native format-specific value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2863,8 +3093,11 @@

    writeObject

    Specified by:
    writeObject in class JsonGenerator
    +
    Parameters:
    +
    pojo - General POJO value to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2886,8 +3119,11 @@

    writeTree

    Specified by:
    writeTree in class JsonGenerator
    +
    Parameters:
    +
    tree - TreeNode to write
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2911,8 +3147,11 @@

    copyCurrentEvent

    Overrides:
    copyCurrentEvent in class JsonGenerator
    +
    Parameters:
    +
    p - Parser that points to event (token) to copy
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2956,8 +3195,11 @@

    copyCurrentStructure

    Overrides:
    copyCurrentStructure in class JsonGenerator
    +
    Parameters:
    +
    p - Parser that points to the value to copy
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -2968,12 +3210,14 @@

    copyCurrentStructure

  • getOutputContext

    public JsonStreamContext getOutputContext()
    +
    Description copied from class: JsonGenerator
    +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    Specified by:
    getOutputContext in class JsonGenerator
    Returns:
    -
    Context object that can give information about logical - position within generated json content.
    +
    Stream output context (JsonStreamContext) associated with this generator
    • @@ -2995,7 +3239,8 @@

    flush

    Specified by:
    flush in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -3026,7 +3271,7 @@

    close

    Specified by:
    close in class JsonGenerator
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -3043,6 +3288,8 @@

    isClosed

    Specified by:
    isClosed in class JsonGenerator
    +
    Returns:
    +
    True if this generator instance has been closed
    @@ -3065,6 +3312,8 @@

    getDelegate

    delegate

    public JsonGenerator delegate()
    +
    Returns:
    +
    Underlying generator that calls are delegated to
    Since:
    2.11
    @@ -3139,6 +3388,6 @@

    delegate

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserDelegate.html index b70f852980..3ba98b2809 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserDelegate.html @@ -2,10 +2,10 @@ - + JsonParserDelegate (Jackson-core 2.12.0 API) - + @@ -313,7 +313,8 @@

    Method Summary

    getBooleanValue()
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE.
    + JsonToken.VALUE_FALSE, to return matching boolean + value.
    @@ -341,11 +342,7 @@

    Method Summary

    String getCurrentName() -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    @@ -588,7 +585,7 @@

    Method Summary

    int getValueAsInt()
    Method that will try to convert value of current token to a - int.
    + Java int value.
    @@ -889,6 +886,8 @@

    getCurrentValue

    Overrides:
    getCurrentValue in class JsonParser
    +
    Returns:
    +
    "Current value" associated with the current input context (state) of this parser
    @@ -907,6 +906,8 @@

    setCurrentValue

    Overrides:
    setCurrentValue in class JsonParser
    +
    Parameters:
    +
    v - Current value to assign for the current input context of this parser
    @@ -924,6 +925,8 @@

    setCodec

    Specified by:
    setCodec in class JsonParser
    +
    Parameters:
    +
    c - Codec to assign, if any; null if none
    @@ -941,6 +944,8 @@

    getCodec

    Specified by:
    getCodec in class JsonParser
    +
    Returns:
    +
    Codec assigned to this parser, if any; null if none
    @@ -957,6 +962,10 @@

    enable

    Overrides:
    enable in class JsonParser
    +
    Parameters:
    +
    f - Feature to enable
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -973,6 +982,10 @@

    disable

    Overrides:
    disable in class JsonParser
    +
    Parameters:
    +
    f - Feature to disable
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -988,6 +1001,10 @@

    isEnabled

    Overrides:
    isEnabled in class JsonParser
    +
    Parameters:
    +
    f - Feature to check
    +
    Returns:
    +
    True if feature is enabled; false otherwise
    @@ -1022,8 +1039,10 @@

    setFeatureMask

    Overrides:
    setFeatureMask in class JsonParser
    +
    Parameters:
    +
    mask - Bit mask that defines set of features to enable
    Returns:
    -
    This parser object, to allow chaining of calls
    +
    This parser, to allow call chaining
    @@ -1050,6 +1069,8 @@

    overrideStdFeatures

    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -1067,13 +1088,15 @@

    overrideFormatFeatures

    which features to change, if any.

    Default implementation will simply throw an exception to indicate that - the generator implementation does not support any FormatFeatures.

    + the parser implementation does not support any FormatFeatures.
    Overrides:
    overrideFormatFeatures in class JsonParser
    Parameters:
    values - Bit mask of set/clear state for features to change
    mask - Bit mask of features to change
    +
    Returns:
    +
    This parser, to allow call chaining
    @@ -1090,6 +1113,8 @@

    getSchema

    Overrides:
    getSchema in class JsonParser
    +
    Returns:
    +
    Schema in use by this parser, if any; null if none
    @@ -1152,6 +1177,9 @@

    version

    version in interface Versioned
    Specified by:
    version in class JsonParser
    +
    Returns:
    +
    Version of this generator (derived from version declared for + jackson-core jar that contains the class
    @@ -1179,6 +1207,8 @@

    getInputSource

    Overrides:
    getInputSource in class JsonParser
    +
    Returns:
    +
    Input source this parser was configured with
    @@ -1199,8 +1229,7 @@

    requiresCustomCodec

    Overrides:
    requiresCustomCodec in class JsonParser
    Returns:
    -
    True if custom codec is needed with parsers and - generators created by this factory; false if a general +
    True if format-specific codec is needed with this parser; false if a general ObjectCodec is enough
    @@ -1253,7 +1282,7 @@

    close

    Specified by:
    close in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -1274,6 +1303,8 @@

    isClosed

    Specified by:
    isClosed in class JsonParser
    +
    Returns:
    +
    True if this parser instance has been closed
    @@ -1336,6 +1367,9 @@

    getCurrentToken

    Specified by:
    getCurrentToken in class JsonParser
    +
    Returns:
    +
    Type of the token this parser currently points to, + if any: null before any tokens have been read, and
    @@ -1353,6 +1387,8 @@

    getCurrentTokenId

    Specified by:
    getCurrentTokenId in class JsonParser
    +
    Returns:
    +
    int matching one of constants from JsonTokenId.
    @@ -1399,6 +1435,10 @@

    hasTokenId

    Specified by:
    hasTokenId in class JsonParser
    +
    Parameters:
    +
    id - Token id to match (from (@link JsonTokenId})
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1422,6 +1462,10 @@

    hasToken

    Specified by:
    hasToken in class JsonParser
    +
    Parameters:
    +
    t - Token to match
    +
    Returns:
    +
    True if the parser current points to specified token
    @@ -1434,16 +1478,15 @@

    getCurrentName

    public String getCurrentName()
                       throws IOException
    Description copied from class: JsonParser
    -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    Specified by:
    getCurrentName in class JsonParser
    +
    Returns:
    +
    Name of the current field in the parsing context
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1456,10 +1499,19 @@

    getCurrentLocation

    public JsonLocation getCurrentLocation()
    Description copied from class: JsonParser
    Method that returns location of the last processed character; - usually for error reporting purposes.
    + usually for error reporting purposes. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + report specific boundary locations (start or end locations of tokens) + and others only return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library)

    Specified by:
    getCurrentLocation in class JsonParser
    +
    Returns:
    +
    Location of the last processed input unit (byte or character)
    @@ -1482,6 +1534,8 @@

    getParsingContext

    Specified by:
    getParsingContext in class JsonParser
    +
    Returns:
    +
    Stream input context (JsonStreamContext) associated with this parser
    @@ -1512,7 +1566,7 @@

    isExpectedStartArrayToken

    Returns:
    True if the current token can be considered as a start-array marker (such JsonToken.START_ARRAY); - false if not.
    + false if not @@ -1529,6 +1583,10 @@

    isExpectedStartObjectToken

    Overrides:
    isExpectedStartObjectToken in class JsonParser
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.START_OBJECT); + false if not
    @@ -1548,6 +1606,10 @@

    isExpectedNumberIntToken

    Overrides:
    isExpectedNumberIntToken in class JsonParser
    +
    Returns:
    +
    True if the current token can be considered as a + start-array marker (such JsonToken.VALUE_NUMBER_INT); + false if not
    @@ -1569,8 +1631,13 @@

    isNaN

    Overrides:
    isNaN in class JsonParser
    +
    Returns:
    +
    True if the current token is of type JsonToken.VALUE_NUMBER_FLOAT + but represents a "Not a Number"; false for other tokens and regular + floating-point numbers
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1614,6 +1681,8 @@

    getLastClearedToken

    Specified by:
    getLastClearedToken in class JsonParser
    +
    Returns:
    +
    Last cleared token, if any; null otherwise
    @@ -1656,8 +1725,12 @@

    getText

    Specified by:
    getText in class JsonParser
    +
    Returns:
    +
    Textual value associated with the current token (one returned + by JsonParser.nextToken() or other iteration methods)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1725,8 +1798,12 @@

    getTextCharacters

    Specified by:
    getTextCharacters in class JsonParser
    +
    Returns:
    +
    Buffer that contains the current textual value (but not necessarily + at offset 0, and not necessarily until the end of buffer)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1749,7 +1826,8 @@

    getTextLength

    by JsonParser.getTextCharacters() that are part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1772,7 +1850,8 @@

    getTextOffset

    by JsonParser.getTextCharacters() that is part of textual content of the current token.
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1798,10 +1877,14 @@

    getText

    Overrides:
    getText in class JsonParser
    +
    Parameters:
    +
    writer - Writer to write textual content to
    Returns:
    The number of characters written to the Writer
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues or writes using passed + writer, or + JsonParseException for decoding problems
    UnsupportedOperationException
    @@ -1825,8 +1908,12 @@

    getBigIntegerValue

    Specified by:
    getBigIntegerValue in class JsonParser
    +
    Returns:
    +
    Current number value as BigInteger (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1841,17 +1928,20 @@

    getBooleanValue

    Description copied from class: JsonParser
    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE. -

    - Note: if the token is not of above-mentioned boolean types, - an integer, but its value falls - outside of range of Java long, a JsonParseException - may be thrown to indicate numeric overflow/underflow.

    + JsonToken.VALUE_FALSE, to return matching boolean + value. + If the current token is of some other type, JsonParseException + will be thrown
    Overrides:
    getBooleanValue in class JsonParser
    +
    Returns:
    +
    True if current token is JsonToken.VALUE_TRUE, + false if current token is JsonToken.VALUE_FALSE; + otherwise throws JsonParseException
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1867,19 +1957,29 @@

    getByteValue

    Numeric accessor that can be called when the current token is of type JsonToken.VALUE_NUMBER_INT and it can be expressed as a value of Java byte primitive type. + Note that in addition to "natural" input range of [-128, 127], + this also allows "unsigned 8-bit byte" values [128, 255]: + but for this range value will be translated by truncation, leading + to sign change. +

    It can also be called for JsonToken.VALUE_NUMBER_FLOAT; if so, it is equivalent to calling JsonParser.getDoubleValue() and then casting; except for possible overflow/underflow exception.

    Note: if the resulting integer value falls outside range of - Java byte, a InputCoercionException + [-128, 255], + a InputCoercionException will be thrown to indicate numeric overflow/underflow.

    Overrides:
    getByteValue in class JsonParser
    +
    Returns:
    +
    Current number value as byte (if numeric token within + range of [-128, 255]); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1906,8 +2006,12 @@

    getShortValue

    Overrides:
    getShortValue in class JsonParser
    +
    Returns:
    +
    Current number value as short (if numeric token within + Java 16-bit signed short range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1927,8 +2031,12 @@

    getDecimalValue

    Specified by:
    getDecimalValue in class JsonParser
    +
    Returns:
    +
    Current number value as BigDecimal (if numeric token); + otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1955,8 +2063,12 @@

    getDoubleValue

    Specified by:
    getDoubleValue in class JsonParser
    +
    Returns:
    +
    Current number value as double (if numeric token within + Java double range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -1983,8 +2095,12 @@

    getFloatValue

    Specified by:
    getFloatValue in class JsonParser
    +
    Returns:
    +
    Current number value as float (if numeric token within + Java float range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2006,13 +2122,17 @@

    getIntValue

    exception.

    Note: if the resulting integer value falls outside range of - Java int, a InputCoercionException + Java int, a InputCoercionException may be thrown to indicate numeric overflow/underflow.

    Specified by:
    getIntValue in class JsonParser
    +
    Returns:
    +
    Current number value as int (if numeric token within + Java 32-bit signed int range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2039,8 +2159,12 @@

    getLongValue

    Specified by:
    getLongValue in class JsonParser
    +
    Returns:
    +
    Current number value as long (if numeric token within + Java 32-bit signed long range); otherwise exception thrown
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2060,8 +2184,11 @@

    getNumberType

    Specified by:
    getNumberType in class JsonParser
    +
    Returns:
    +
    Type of current number, if parser points to numeric token; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2132,7 +2259,7 @@

    getValueAsInt

    throws IOException
    Description copied from class: JsonParser
    Method that will try to convert value of current token to a - int. + Java int value. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules. @@ -2143,8 +2270,12 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParser
    +
    Returns:
    +
    int value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2169,8 +2300,13 @@

    getValueAsInt

    Overrides:
    getValueAsInt in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to int is not possible
    +
    Returns:
    +
    int value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2195,8 +2331,12 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParser
    +
    Returns:
    +
    long value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2221,8 +2361,13 @@

    getValueAsLong

    Overrides:
    getValueAsLong in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to long is not possible
    +
    Returns:
    +
    long value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2247,8 +2392,12 @@

    getValueAsDouble

    Overrides:
    getValueAsDouble in class JsonParser
    +
    Returns:
    +
    double value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2273,8 +2422,13 @@

    getValueAsDouble

    Overrides:
    getValueAsDouble in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to double is not possible
    +
    Returns:
    +
    double value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2299,8 +2453,12 @@

    getValueAsBoolean

    Overrides:
    getValueAsBoolean in class JsonParser
    +
    Returns:
    +
    boolean value current token is converted to, if possible; exception thrown + otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2325,8 +2483,13 @@

    getValueAsBoolean

    Overrides:
    getValueAsBoolean in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to boolean is not possible
    +
    Returns:
    +
    boolean value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2349,8 +2512,11 @@

    getValueAsString

    Overrides:
    getValueAsString in class JsonParser
    +
    Returns:
    +
    String value current token is converted to, if possible; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2373,8 +2539,13 @@

    getValueAsString

    Specified by:
    getValueAsString in class JsonParser
    +
    Parameters:
    +
    defaultValue - Default value to return if conversion to String is not possible
    +
    Returns:
    +
    String value current token is converted to, if possible; def otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2400,8 +2571,12 @@

    getEmbeddedObject

    Overrides:
    getEmbeddedObject in class JsonParser
    +
    Returns:
    +
    Embedded value (usually of "native" type supported by format) + for the current token, if any; null otherwise
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2438,7 +2613,8 @@

    getBinaryValue

    Returns:
    Decoded binary data
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2463,7 +2639,8 @@

    readBinaryValue

    Returns:
    Number of bytes that were decoded and written via OutputStream
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2477,10 +2654,18 @@

    getTokenLocation

    Description copied from class: JsonParser
    Method that return the starting location of the current token; that is, position of the first character from input - that starts the current token.
    + that starts the current token. +

    + Note that the location is not guaranteed to be accurate (although most + implementation will try their best): some implementations may only + return JsonLocation.NA due to not having access + to input location information (when delegating actual decoding work + to other library)

    Specified by:
    getTokenLocation in class JsonParser
    +
    Returns:
    +
    Starting location of the token parser currently points to
    @@ -2504,7 +2689,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2536,7 +2722,8 @@

    nextValue

    parsers, JsonToken.NOT_AVAILABLE if no tokens were available yet)
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2563,7 +2750,8 @@

    finishToken

    Overrides:
    finishToken in class JsonParser
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2591,8 +2779,11 @@

    skipChildren

    Specified by:
    skipChildren in class JsonParser
    +
    Returns:
    +
    This parser, to allow call chaining
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2615,6 +2806,9 @@

    canReadObjectId

    Overrides:
    canReadObjectId in class JsonParser
    +
    Returns:
    +
    True if the format being read supports native Object Ids; + false if not
    @@ -2637,6 +2831,9 @@

    canReadTypeId

    Overrides:
    canReadTypeId in class JsonParser
    +
    Returns:
    +
    True if the format being read supports native Type Ids; + false if not
    @@ -2661,8 +2858,11 @@

    getObjectId

    Overrides:
    getObjectId in class JsonParser
    +
    Returns:
    +
    Native Object id associated with the current token, if any; null if none
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2687,8 +2887,11 @@

    getTypeId

    Overrides:
    getTypeId in class JsonParser
    +
    Returns:
    +
    Native Type Id associated with the current token, if any; null if none
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -2701,6 +2904,8 @@

    delegate

    public JsonParser delegate()
    Accessor for getting the immediate JsonParser this parser delegates calls to.
    +
    Returns:
    +
    Underlying parser calls are delegated to
    Since:
    2.10
    @@ -2775,6 +2980,6 @@

    delegate

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserSequence.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserSequence.html index f905afea7a..04b0a51964 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserSequence.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/JsonParserSequence.html @@ -2,10 +2,10 @@ - + JsonParserSequence (Jackson-core 2.12.0 API) - + @@ -275,7 +275,7 @@

    Method Summary

    createFlattened(boolean checkForExistingToken, JsonParser first, JsonParser second) -
    Method that will construct a parser (possibly a sequence) that +
    Method that will construct a sequence (possibly a sequence) that contains all given sub-parsers.
    @@ -283,10 +283,7 @@

    Method Summary

    static JsonParserSequence createFlattened(JsonParser first, JsonParser second) -
    Deprecated.  -
    Since 2.8 use createFlattened(boolean, JsonParser, JsonParser) - instead
    -
    +
    Deprecated. 
    @@ -437,10 +434,6 @@

    JsonParserSequence

    JsonParserSequence

    protected JsonParserSequence(boolean checkForExistingToken,
                              JsonParser[] parsers)
    -
    -
    Since:
    -
    2.8
    -
    @@ -460,13 +453,22 @@

    createFlattened

    public static JsonParserSequence createFlattened(boolean checkForExistingToken,
                                                  JsonParser first,
                                                  JsonParser second)
    -
    Method that will construct a parser (possibly a sequence) that +
    Method that will construct a sequence (possibly a sequence) that contains all given sub-parsers. All parsers given are checked to see if they are sequences: and if so, they will be "flattened", that is, contained parsers are directly added in a new sequence instead of adding sequences within sequences. This is done to minimize delegation depth, ideally only having just a single level of delegation.
    +
    +
    Parameters:
    +
    checkForExistingToken - Flag passed to be assigned as + _checkForExistingToken for resulting sequence
    +
    first - First parser to traverse
    +
    second - Second parser to traverse
    +
    Returns:
    +
    Sequence instance constructed
    +
    @@ -478,8 +480,7 @@

    createFlattened

    @Deprecated
 public static JsonParserSequence createFlattened(JsonParser first,
                                                              JsonParser second)
    -
    Deprecated. Since 2.8 use createFlattened(boolean, JsonParser, JsonParser) - instead
    +
    Deprecated. 
    @@ -521,7 +522,7 @@

    close

    Overrides:
    close in class JsonParserDelegate
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem
    @@ -545,7 +546,8 @@

    nextToken

    Next token from the stream, if any found, or null to indicate end-of-input
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -563,8 +565,11 @@

    skipChildren

    Overrides:
    skipChildren in class JsonParserDelegate
    +
    Returns:
    +
    This parser, to allow call chaining
    Throws:
    -
    IOException
    +
    IOException - for low-level read issues, or + JsonParseException for decoding problems
    @@ -578,6 +583,10 @@

    containedParsersCount

    Method that is most useful for debugging or testing; returns actual number of underlying parsers sequence was constructed with (nor just ones remaining active)
    +
    +
    Returns:
    +
    Number of actual underlying parsers this sequence has
    +
    @@ -681,6 +690,6 @@

    switchAndReturnNext

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/MinimalPrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/MinimalPrettyPrinter.html index 69b8ad408f..d3dc30d597 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/MinimalPrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/MinimalPrettyPrinter.html @@ -2,10 +2,10 @@ - + MinimalPrettyPrinter (Jackson-core 2.12.0 API) - + @@ -380,6 +380,10 @@

    setRootValueSeparator

    setSeparators

    public MinimalPrettyPrinter setSeparators(Separators separators)
    +
    Parameters:
    +
    separators - Separator definitions
    +
    Returns:
    +
    This pretty-printer instance to allow call chaining
    Since:
    2.9
    @@ -397,16 +401,18 @@

    writeRootValueSeparator

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

    - Default - handling (without pretty-printing) will output a space, to + Default handling (without pretty-printing) will output a space, to allow values to be parsed correctly. Pretty-printer is to output some other suitable and nice-looking separator (tab(s), space(s), linefeed(s) or any combination thereof).

    Specified by:
    writeRootValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -430,8 +436,11 @@

    writeStartObject

    Specified by:
    writeStartObject in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -454,8 +463,11 @@

    beforeObjectEntries

    Specified by:
    beforeObjectEntries in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -475,8 +487,11 @@

    writeObjectFieldValueSeparator

    Specified by:
    writeObjectFieldValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -496,8 +511,11 @@

    writeObjectEntrySeparator

    Specified by:
    writeObjectEntrySeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -522,10 +540,13 @@

    writeEndObject

    Specified by:
    writeEndObject in interface PrettyPrinter
    -
    nrOfEntries - Number of direct members of the array that +
    Parameters:
    +
    g - Generator used for output
    +
    nrOfEntries - Number of direct members of the Object that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -549,8 +570,11 @@

    writeStartArray

    Specified by:
    writeStartArray in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -572,8 +596,11 @@

    beforeArrayValues

    Specified by:
    beforeArrayValues in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -593,8 +620,11 @@

    writeArrayValueSeparator

    Specified by:
    writeArrayValueSeparator in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -619,10 +649,13 @@

    writeEndArray

    Specified by:
    writeEndArray in interface PrettyPrinter
    +
    Parameters:
    +
    g - Generator used for output
    nrOfValues - Number of direct members of the array that have been output
    Throws:
    -
    IOException
    +
    IOException - if there is either an underlying I/O problem or encoding + issue at format layer
    @@ -695,6 +728,6 @@

    writeEndArray

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/RequestPayload.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/RequestPayload.html index 9c19c97240..f113657294 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/RequestPayload.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/RequestPayload.html @@ -2,10 +2,10 @@ - + RequestPayload (Jackson-core 2.12.0 API) - + @@ -384,6 +384,6 @@

    toString

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Separators.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Separators.html index 7217da4cbf..775539d671 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Separators.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/Separators.html @@ -2,10 +2,10 @@ - + Separators (Jackson-core 2.12.0 API) - + @@ -377,6 +377,6 @@

    getArrayValueSeparator

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/TextBuffer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/TextBuffer.html index 2553e17c84..e7a001386c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/TextBuffer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/TextBuffer.html @@ -2,10 +2,10 @@ - + TextBuffer (Jackson-core 2.12.0 API) - + @@ -220,11 +220,17 @@

    Method Summary

    String -contentsAsString()  +contentsAsString() +
    Accessor that may be used to get the contents of this buffer as a single + String regardless of whether they were collected in a segmented + fashion or not: this typically require construction of the result String.
    + int -contentsToWriter(Writer w)  +contentsToWriter(Writer w) +
    Accessor that will write buffered contents using given Writer.
    + char[] @@ -264,7 +270,10 @@

    Method Summary

    char[] -getBufferWithoutReset()  +getBufferWithoutReset() +
    Method for accessing the currently active (last) content segment + without changing state of the buffer
    + char[] @@ -277,9 +286,9 @@

    Method Summary

    char[] getTextBuffer() -
    Accessor that may be used to get the contents of this buffer in a single - char array regardless of whether they were collected in a segmented - fashion or not.
    +
    Accessor that may be used to get the contents of this buffer as a single + char[] regardless of whether they were collected in a segmented + fashion or not: this typically require allocation of the result buffer.
    @@ -302,12 +311,15 @@

    Method Summary

    void -resetWith(char ch)  +resetWith(char ch) +
    Method for clearing out possibly existing content, and replacing them with + a single-character content (so size() would return 1)
    + void resetWithCopy(char[] buf, - int start, + int offset, int len)  @@ -326,7 +338,7 @@

    Method Summary

    void resetWithShared(char[] buf, - int start, + int offset, int len)
    Method called to initialize the buffer with a shared copy of data; this means that buffer will just have pointers to actual data.
    @@ -338,7 +350,12 @@

    Method Summary

    String -setCurrentAndReturn(int len)  +setCurrentAndReturn(int len) +
    Convenience method that finishes the current active content segment + (by specifying how many characters within consists of valid content) + and aggregates and returns resulting contents (similar to a call + to contentsAsString()).
    + void @@ -395,10 +412,6 @@

    TextBuffer

    TextBuffer

    protected TextBuffer(BufferRecycler allocator,
                      char[] initialSegment)
    -
    -
    Since:
    -
    2.10
    -
    @@ -419,6 +432,11 @@

    fromInitial

    Factory method for constructing an instance with no allocator, and with initial full segment.
    +
    Parameters:
    +
    initialSegment - Initial, full segment to use for creating buffer (buffer + size() would return length of initialSegment)
    +
    Returns:
    +
    TextBuffer constructed
    Since:
    2.10
    @@ -460,7 +478,11 @@

    resetWithEmpty

  • resetWith

    public void resetWith(char ch)
    +
    Method for clearing out possibly existing content, and replacing them with + a single-character content (so size() would return 1)
    +
    Parameters:
    +
    ch - Character to set as the buffer contents
    Since:
    2.9
    @@ -473,12 +495,18 @@

    resetWith

  • resetWithShared

    public void resetWithShared(char[] buf,
-                            int start,
+                            int offset,
                             int len)
    Method called to initialize the buffer with a shared copy of data; this means that buffer will just have pointers to actual data. It also means that if anything is to be appended to the buffer, it will first have to unshare it (make a local copy).
    +
    +
    Parameters:
    +
    buf - Buffer that contains shared contents
    +
    offset - Offset of the first content character in buf
    +
    len - Length of content in buf
    +
    • @@ -488,7 +516,7 @@

    resetWithShared

  • resetWithCopy

    public void resetWithCopy(char[] buf,
-                          int start,
+                          int offset,
                           int len)
    • @@ -501,10 +529,6 @@

    resetWithCopy

    public void resetWithCopy(String text,
                           int start,
                           int len)
    -
    -
    Since:
    -
    2.9
    -
    @@ -523,7 +547,11 @@

    resetWithString

  • getBufferWithoutReset

    public char[] getBufferWithoutReset()
    +
    Method for accessing the currently active (last) content segment + without changing state of the buffer
    +
    Returns:
    +
    Currently active (last) content segment
    Since:
    2.9
    @@ -538,7 +566,7 @@

    size

    public int size()
    Returns:
    -
    Number of characters currently stored by this collector
    +
    Number of characters currently stored in this buffer
    • @@ -560,6 +588,11 @@

    hasTextAsCharacters

    public boolean hasTextAsCharacters()
    Method that can be used to check whether textual contents can be efficiently accessed using getTextBuffer().
    +
    +
    Returns:
    +
    True if access via getTextBuffer() would be efficient + (that is, content already available as aggregated char[])
    +
    @@ -569,9 +602,13 @@

    hasTextAsCharacters

  • getTextBuffer

    public char[] getTextBuffer()
    -
    Accessor that may be used to get the contents of this buffer in a single - char array regardless of whether they were collected in a segmented - fashion or not.
    +
    Accessor that may be used to get the contents of this buffer as a single + char[] regardless of whether they were collected in a segmented + fashion or not: this typically require allocation of the result buffer.
    +
    +
    Returns:
    +
    Aggregated char[] that contains all buffered content
    +
    •  @@ -581,6 +618,13 @@

    getTextBuffer

  • contentsAsString

    public String contentsAsString()
    +
    Accessor that may be used to get the contents of this buffer as a single + String regardless of whether they were collected in a segmented + fashion or not: this typically require construction of the result String.
    +
    +
    Returns:
    +
    Aggregated buffered contents as a String
    +
    • @@ -603,8 +647,10 @@

    contentsAsDecimal

    Convenience method for converting contents of the buffer into a BigDecimal.
    +
    Returns:
    +
    Buffered text value parsed as a BigDecimal, if possible
    Throws:
    -
    NumberFormatException
    +
    NumberFormatException - if contents are not a valid Java number
    @@ -619,8 +665,10 @@

    contentsAsDouble

    Convenience method for converting contents of the buffer into a Double value.
    +
    Returns:
    +
    Buffered text value parsed as a Double, if possible
    Throws:
    -
    NumberFormatException
    +
    NumberFormatException - if contents are not a valid Java number
    @@ -632,10 +680,17 @@

    contentsAsDouble

    contentsAsInt

    public int contentsAsInt(boolean neg)
    Specialized convenience method that will decode a 32-bit int, - of at most 9 digits (and possible leading minus sign).
    + of at most 9 digits (and possible leading minus sign). +

    + NOTE: method DOES NOT verify that the contents actually are a valid + Java int value (either regarding format, or value range): caller + MUST validate that.

    Parameters:
    neg - Whether contents start with a minus sign
    +
    Returns:
    +
    Buffered text value parsed as an int using + NumberInput.parseInt(String) method (which does NOT validate input)
    Since:
    2.9
    @@ -649,10 +704,17 @@

    contentsAsInt

    contentsAsLong

    public long contentsAsLong(boolean neg)
    Specialized convenience method that will decode a 64-bit int, - of at most 18 digits (and possible leading minus sign).
    + of at most 18 digits (and possible leading minus sign). +

    + NOTE: method DOES NOT verify that the contents actually are a valid + Java long value (either regarding format, or value range): caller + MUST validate that.

    Parameters:
    neg - Whether contents start with a minus sign
    +
    Returns:
    +
    Buffered text value parsed as an long using + NumberInput.parseLong(String) method (which does NOT validate input)
    Since:
    2.9
    @@ -666,9 +728,14 @@

    contentsAsLong

    contentsToWriter

    public int contentsToWriter(Writer w)
                      throws IOException
    +
    Accessor that will write buffered contents using given Writer.
    +
    Parameters:
    +
    w - Writer to use for writing out buffered content
    +
    Returns:
    +
    Number of characters written (same as size())
    Throws:
    -
    IOException
    +
    IOException - If write using Writer parameter fails
    Since:
    2.8
    @@ -759,7 +826,15 @@

    setCurrentLength

  • setCurrentAndReturn

    public String setCurrentAndReturn(int len)
    +
    Convenience method that finishes the current active content segment + (by specifying how many characters within consists of valid content) + and aggregates and returns resulting contents (similar to a call + to contentsAsString()).
    +
    Parameters:
    +
    len - Length of content (in characters) of the current active segment
    +
    Returns:
    +
    String that contains all buffered content
    Since:
    2.6
    @@ -783,7 +858,12 @@

    expandCurrentSegment

    public char[] expandCurrentSegment()
    Method called to expand size of the current segment, to accommodate for more contiguous content. Usually only - used when parsing tokens like names if even then.
    + used when parsing tokens like names if even then. + Method will both expand the segment and return it +
    +
    Returns:
    +
    Expanded current segment
    +
    • @@ -799,8 +879,10 @@

    expandCurrentSegment

    Parameters:
    minSize - Required minimum strength of the current segment
    +
    Returns:
    +
    Expanded current segment
    Since:
    -
    2.4.0
    +
    2.4
    @@ -889,6 +971,6 @@

    toString

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/VersionUtil.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/VersionUtil.html index 31db7fd438..1721cf8f10 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/VersionUtil.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/VersionUtil.html @@ -2,10 +2,10 @@ - + VersionUtil (Jackson-core 2.12.0 API) - + @@ -19,7 +19,7 @@ catch(err) { } //--> -var methods = {"i0":41,"i1":9,"i2":9,"i3":9,"i4":9,"i5":42,"i6":9}; +var methods = {"i0":41,"i1":41,"i2":9,"i3":9,"i4":9,"i5":42,"i6":9}; var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -177,8 +177,9 @@

    Method Summary

    static Version packageVersionFor(Class<?> cls) -
    Loads version information by introspecting a class named - "PackageVersion" in the same package as the given class.
    +
    Deprecated.  +
    Since 2.12 simply use versionFor(Class) instead
    +
    @@ -206,8 +207,8 @@

    Method Summary

    static Version versionFor(Class<?> cls) -
    Helper method that will try to load version information for specified - class.
    +
    Loads version information by introspecting a class named + "PackageVersion" in the same package as the given class.
    @@ -267,13 +268,19 @@

    version

  • versionFor

    public static Version versionFor(Class<?> cls)
    -
    Helper method that will try to load version information for specified - class. Implementation is as follows: - - First, tries to load version info from a class named - "PackageVersion" in the same package as the class. - - If no version information is found, Version.unknownVersion() is returned.
    +
    Loads version information by introspecting a class named + "PackageVersion" in the same package as the given class. +

    + If the class could not be found or does not have a public + static Version field named "VERSION", returns "empty" Version + returned by Version.unknownVersion().

    +
    +
    Parameters:
    +
    cls - Class for which to look version information
    +
    Returns:
    +
    Version information discovered if any; + Version.unknownVersion() if none
    +
    • @@ -282,12 +289,17 @@

    versionFor

     @@ -326,6 +338,15 @@

    parseVersion

    String groupId, String artifactId)
    Method used by PackageVersion classes to decode version injected by Maven build.
    +
    +
    Parameters:
    +
    s - Version String to parse
    +
    groupId - Maven group id to include with version
    +
    artifactId - Maven artifact id to include with version
    +
    Returns:
    +
    Version instance constructed from parsed components, if successful; + Version.unknownVersion() if parsing of components fail
    +
    @@ -415,6 +436,6 @@

    throwInternal

     -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecycler.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecycler.html index 18be7d71e7..61abe551cb 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecycler.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecycler.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.BufferRecycler (Jackson-core 2.12.0 API) - + @@ -277,6 +277,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecyclers.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecyclers.html index 3f389c3e76..0f4c4384dc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecyclers.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/BufferRecyclers.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.BufferRecyclers (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/ByteArrayBuilder.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/ByteArrayBuilder.html index ee5e811503..3addb9fcaa 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/ByteArrayBuilder.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/ByteArrayBuilder.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.ByteArrayBuilder (Jackson-core 2.12.0 API) - + @@ -258,6 +258,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultIndenter.html index 8c401d0dac..1410384c82 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultIndenter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.DefaultIndenter (Jackson-core 2.12.0 API) - + @@ -180,6 +180,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.FixedSpaceIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.FixedSpaceIndenter.html index cc958276c3..7a326623a3 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.FixedSpaceIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.FixedSpaceIndenter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.DefaultPrettyPrinter.FixedSpaceIndenter (Jackson-core 2.12.0 API) - + @@ -163,6 +163,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.Indenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.Indenter.html index ec4b173789..eae3c8968d 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.Indenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.Indenter.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.util.DefaultPrettyPrinter.Indenter (Jackson-core 2.12.0 API) - + @@ -226,6 +226,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.NopIndenter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.NopIndenter.html index 1174b321c2..b6f4090df1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.NopIndenter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.NopIndenter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.DefaultPrettyPrinter.NopIndenter (Jackson-core 2.12.0 API) - + @@ -186,6 +186,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.html index 587399a6c9..bf0d9eed1e 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/DefaultPrettyPrinter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.DefaultPrettyPrinter (Jackson-core 2.12.0 API) - + @@ -140,7 +140,9 @@

    Uses of DefaultPrettyPrinter -DefaultPrettyPrinter.withSeparators(Separators separators)  +DefaultPrettyPrinter.withSeparators(Separators separators) +
    Method for configuring separators for this pretty-printer to use
    + DefaultPrettyPrinter @@ -220,6 +222,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Instantiatable.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Instantiatable.html index 296f2fa978..05a289f007 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Instantiatable.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Instantiatable.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.util.Instantiatable (Jackson-core 2.12.0 API) - + @@ -166,6 +166,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/InternCache.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/InternCache.html index 1cedb98fab..71a909218a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/InternCache.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/InternCache.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.InternCache (Jackson-core 2.12.0 API) - + @@ -163,6 +163,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeature.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeature.html index 604e5d8e11..e394ba13fc 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeature.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeature.html @@ -2,10 +2,10 @@ - + Uses of Interface com.fasterxml.jackson.core.util.JacksonFeature (Jackson-core 2.12.0 API) - + @@ -310,6 +310,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeatureSet.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeatureSet.html index 1407af428d..d9dddc32f9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeatureSet.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JacksonFeatureSet.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.JacksonFeatureSet (Jackson-core 2.12.0 API) - + @@ -187,7 +187,7 @@

    Uses of JacksonFeatureSet<StreamWriteCapability> JsonGenerator.getWriteCapabilities() -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    @@ -376,6 +376,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonGeneratorDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonGeneratorDelegate.html index c487ac1ef8..63b7c5c539 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonGeneratorDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonGeneratorDelegate.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.JsonGeneratorDelegate (Jackson-core 2.12.0 API) - + @@ -165,6 +165,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserDelegate.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserDelegate.html index 564de79676..4980d7db72 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserDelegate.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserDelegate.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.JsonParserDelegate (Jackson-core 2.12.0 API) - + @@ -193,6 +193,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserSequence.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserSequence.html index 1a4f27c2b2..7a345b9b4a 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserSequence.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/JsonParserSequence.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.JsonParserSequence (Jackson-core 2.12.0 API) - + @@ -110,7 +110,7 @@

    Uses of JsonParserSequence.createFlattened(boolean checkForExistingToken, JsonParser first, JsonParser second) -
    Method that will construct a parser (possibly a sequence) that +
    Method that will construct a sequence (possibly a sequence) that contains all given sub-parsers.
    @@ -118,10 +118,7 @@

    Uses of static JsonParserSequence JsonParserSequence.createFlattened(JsonParser first, JsonParser second) -
    Deprecated.  -
    Since 2.8 use createFlattened(boolean, JsonParser, JsonParser) - instead
    -
    +
    Deprecated. 
    @@ -178,6 +175,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/MinimalPrettyPrinter.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/MinimalPrettyPrinter.html index 626c5497e9..f3541bb3c1 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/MinimalPrettyPrinter.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/MinimalPrettyPrinter.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.MinimalPrettyPrinter (Jackson-core 2.12.0 API) - + @@ -163,6 +163,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/RequestPayload.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/RequestPayload.html index 1bb86a3728..6b7297101c 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/RequestPayload.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/RequestPayload.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.RequestPayload (Jackson-core 2.12.0 API) - + @@ -154,7 +154,7 @@

    Uses of JsonParseException -JsonParseException.withRequestPayload(RequestPayload p) +JsonParseException.withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -211,7 +211,7 @@

    Uses of abstract StreamReadException -StreamReadException.withRequestPayload(RequestPayload p) +StreamReadException.withRequestPayload(RequestPayload payload)
    Fluent method that may be used to assign payload to this exception, to let recipient access it for diagnostics purposes.
    @@ -270,6 +270,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Separators.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Separators.html index 3d218efc57..bde1934ce7 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Separators.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/Separators.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.Separators (Jackson-core 2.12.0 API) - + @@ -183,7 +183,9 @@

    Uses of DefaultPrettyPrinter -DefaultPrettyPrinter.withSeparators(Separators separators)  +DefaultPrettyPrinter.withSeparators(Separators separators) +
    Method for configuring separators for this pretty-printer to use
    + @@ -239,6 +241,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/TextBuffer.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/TextBuffer.html index b0b84180a7..65c645e80b 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/TextBuffer.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/TextBuffer.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.TextBuffer (Jackson-core 2.12.0 API) - + @@ -218,6 +218,6 @@

    Uses of Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/VersionUtil.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/VersionUtil.html index 7e12af753f..24ffd5c229 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/VersionUtil.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/class-use/VersionUtil.html @@ -2,10 +2,10 @@ - + Uses of Class com.fasterxml.jackson.core.util.VersionUtil (Jackson-core 2.12.0 API) - + @@ -121,6 +121,6 @@

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-frame.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-frame.html index 8789a32e21..8b2cfd19e6 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-frame.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-frame.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.util (Jackson-core 2.12.0 API) - + diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-summary.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-summary.html index 5112b34ea0..2298f1b0c9 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-summary.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-summary.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.util (Jackson-core 2.12.0 API) - + @@ -304,6 +304,6 @@

    Package com.fast

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-tree.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-tree.html index e1e29f11e2..3bba415fe5 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-tree.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-tree.html @@ -2,10 +2,10 @@ - + com.fasterxml.jackson.core.util Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -182,6 +182,6 @@

    Interface Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-use.html b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-use.html index 8a641bc2a8..3c5270797f 100644 --- a/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-use.html +++ b/docs/javadoc/2.12/com/fasterxml/jackson/core/util/package-use.html @@ -2,10 +2,10 @@ - + Uses of Package com.fasterxml.jackson.core.util (Jackson-core 2.12.0 API) - + @@ -508,6 +508,6 @@

    Uses o -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/constant-values.html b/docs/javadoc/2.12/constant-values.html index 52d69b2028..c09029bd0b 100644 --- a/docs/javadoc/2.12/constant-values.html +++ b/docs/javadoc/2.12/constant-values.html @@ -2,10 +2,10 @@ - + Constant Field Values (Jackson-core 2.12.0 API) - + @@ -1409,6 +1409,6 @@

    com.fasterxml.*

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/deprecated-list.html b/docs/javadoc/2.12/deprecated-list.html index 719b37fc6b..787ff26c3f 100644 --- a/docs/javadoc/2.12/deprecated-list.html +++ b/docs/javadoc/2.12/deprecated-list.html @@ -2,10 +2,10 @@ - + Deprecated List (Jackson-core 2.12.0 API) - + @@ -112,10 +112,7 @@

    Contents

    -com.fasterxml.jackson.core.util.JsonParserSequence.createFlattened(JsonParser, JsonParser) -
    Since 2.8 use JsonParserSequence.createFlattened(boolean, JsonParser, JsonParser) - instead
    - +com.fasterxml.jackson.core.util.JsonParserSequence.createFlattened(JsonParser, JsonParser) com.fasterxml.jackson.core.JsonFactory.createJsonGenerator(OutputStream) @@ -201,7 +198,7 @@

    Contents

    com.fasterxml.jackson.core.ObjectCodec.getJsonFactory() -
    Since 2.1: Use ObjectCodec.getFactory() instead.
    +
    Use ObjectCodec.getFactory() instead.
    @@ -236,41 +233,46 @@

    Contents

    +com.fasterxml.jackson.core.util.VersionUtil.packageVersionFor(Class<?>) +
    Since 2.12 simply use VersionUtil.versionFor(Class) instead
    + + + com.fasterxml.jackson.core.JsonParser.setFeatureMask(int)
    Since 2.7, use JsonParser.overrideStdFeatures(int, int) instead
    - + com.fasterxml.jackson.core.JsonGenerator.setFeatureMask(int)
    Since 2.7, use JsonGenerator.overrideStdFeatures(int, int) instead -- remove from 2.9
    - + com.fasterxml.jackson.core.util.JsonParserDelegate.setFeatureMask(int) - + com.fasterxml.jackson.core.util.JsonGeneratorDelegate.setFeatureMask(int) - + com.fasterxml.jackson.core.base.ParserBase.setFeatureMask(int) - + com.fasterxml.jackson.core.base.GeneratorBase.setFeatureMask(int) - + com.fasterxml.jackson.core.JsonFactory.setInputDecorator(InputDecorator)
    Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    - + com.fasterxml.jackson.core.JsonFactory.setOutputDecorator(OutputDecorator) -
    Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    +
    Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
    - + com.fasterxml.jackson.core.util.VersionUtil.version() - + com.fasterxml.jackson.core.JsonGenerator.writeStartArray(int)
    Since 2.12 Use JsonGenerator.writeStartArray(Object, int) instead
    @@ -458,6 +460,6 @@

    Contents

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/help-doc.html b/docs/javadoc/2.12/help-doc.html index 3ccc8eae77..63daea926e 100644 --- a/docs/javadoc/2.12/help-doc.html +++ b/docs/javadoc/2.12/help-doc.html @@ -2,10 +2,10 @@ - + API Help (Jackson-core 2.12.0 API) - + @@ -226,6 +226,6 @@

    Constant Field Values

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/index-all.html b/docs/javadoc/2.12/index-all.html index 911cf31962..d05957b780 100644 --- a/docs/javadoc/2.12/index-all.html +++ b/docs/javadoc/2.12/index-all.html @@ -2,10 +2,10 @@ - + Index (Jackson-core 2.12.0 API) - + @@ -88,9 +88,14 @@

    A

    addName(String, int[], int) - Method in class com.fasterxml.jackson.core.sym.ByteQuadsCanonicalizer
     
    allocBase64Buffer() - Method in class com.fasterxml.jackson.core.io.IOContext
    -
     
    +
    +
    Method for recycling or allocation byte buffer of "base 64 encode/decode" type.
    +
    allocBase64Buffer(int) - Method in class com.fasterxml.jackson.core.io.IOContext
    -
     
    +
    +
    Variant of IOContext.allocBase64Buffer() that specifies smallest acceptable + buffer size.
    +
    allocByteBuffer(int) - Method in class com.fasterxml.jackson.core.util.BufferRecycler
     
    allocByteBuffer(int, int) - Method in class com.fasterxml.jackson.core.util.BufferRecycler
    @@ -105,19 +110,26 @@

    A

     
    allocReadIOBuffer() - Method in class com.fasterxml.jackson.core.io.IOContext
    -
    - Note: the method can only be called once during its life cycle.
    +
    Method for recycling or allocation byte buffer of "read I/O" type.
    allocReadIOBuffer(int) - Method in class com.fasterxml.jackson.core.io.IOContext
    -
     
    +
    +
    Variant of IOContext.allocReadIOBuffer() that specifies smallest acceptable + buffer size.
    +
    allocTokenBuffer() - Method in class com.fasterxml.jackson.core.io.IOContext
     
    allocTokenBuffer(int) - Method in class com.fasterxml.jackson.core.io.IOContext
     
    allocWriteEncodingBuffer() - Method in class com.fasterxml.jackson.core.io.IOContext
    -
     
    +
    +
    Method for recycling or allocation byte buffer of "write encoding" type.
    +
    allocWriteEncodingBuffer(int) - Method in class com.fasterxml.jackson.core.io.IOContext
    -
     
    +
    +
    Variant of IOContext.allocWriteEncodingBuffer() that specifies smallest acceptable + buffer size.
    +
    append(char) - Method in class com.fasterxml.jackson.core.io.SegmentedStringWriter
     
    append(CharSequence) - Method in class com.fasterxml.jackson.core.io.SegmentedStringWriter
    @@ -334,9 +346,7 @@

    B

    bits() - Method in enum com.fasterxml.jackson.core.JsonEncoding
     
    bucketCount() - Method in class com.fasterxml.jackson.core.sym.ByteQuadsCanonicalizer
    -
    -
    Returns number of primary slots table has currently
    -
    +
     
    bucketCount() - Method in class com.fasterxml.jackson.core.sym.CharsToNameCanonicalizer
    Method for checking number of primary hash buckets this symbol @@ -935,9 +945,15 @@

    C

    of at most 18 digits (and possible leading minus sign).
    contentsAsString() - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
     
    +
    +
    Accessor that may be used to get the contents of this buffer as a single + String regardless of whether they were collected in a segmented + fashion or not: this typically require construction of the result String.
    +
    contentsToWriter(Writer) - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
     
    +
    +
    Accessor that will write buffered contents using given Writer.
    +
    convertNumberToBigDecimal() - Method in class com.fasterxml.jackson.core.base.ParserBase
     
    convertNumberToBigInteger() - Method in class com.fasterxml.jackson.core.base.ParserBase
    @@ -950,7 +966,7 @@

    C

     
    convertSurrogate(int) - Method in class com.fasterxml.jackson.core.io.UTF8Writer
    -
    Method called to calculate UTF codepoint, from a surrogate pair.
    +
    Method called to calculate Unicode code-point, from a surrogate pair.
    copy() - Method in class com.fasterxml.jackson.core.JsonFactory
    @@ -1004,15 +1020,12 @@

    C

     
    createFlattened(boolean, JsonParser, JsonParser) - Static method in class com.fasterxml.jackson.core.util.JsonParserSequence
    -
    Method that will construct a parser (possibly a sequence) that +
    Method that will construct a sequence (possibly a sequence) that contains all given sub-parsers.
    createFlattened(JsonParser, JsonParser) - Static method in class com.fasterxml.jackson.core.util.JsonParserSequence
    -
    Deprecated. -
    Since 2.8 use JsonParserSequence.createFlattened(boolean, JsonParser, JsonParser) - instead
    -
    +
    Deprecated.
    createGenerator(OutputStream, JsonEncoding) - Method in class com.fasterxml.jackson.core.JsonFactory
    @@ -1246,7 +1259,13 @@

    C

    createRootContext(DupDetector) - Static method in class com.fasterxml.jackson.core.json.JsonWriteContext
     
    currentName() - Method in class com.fasterxml.jackson.core.JsonParser
    -
     
    +
    +
    Method that can be called to get the name associated with + the current token: for JsonToken.FIELD_NAMEs it will + be the same as what JsonParser.getText() returns; + for field values it will be preceding field name; + and for others (array values, root-level values) null.
    +
    currentToken() - Method in class com.fasterxml.jackson.core.base.ParserMinimalBase
     
    currentToken() - Method in class com.fasterxml.jackson.core.filter.FilteringParserDelegate
    @@ -1434,7 +1453,7 @@

    D

    DefaultIndenter(String, String) - Constructor for class com.fasterxml.jackson.core.util.DefaultIndenter
    Create an indenter which uses the indent string to indent one level - and the eol string to separate lines.
    + and the eol string to separate lines.
    DefaultPrettyPrinter - Class in com.fasterxml.jackson.core.util
    @@ -1532,7 +1551,7 @@

    D

     
    disable(JsonGenerator.Feature) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
    Method for disabling specified features +
    Method for disabling specified feature (check JsonGenerator.Feature for list of features)
    disable(JsonParser.Feature) - Method in class com.fasterxml.jackson.core.JsonParser
    @@ -1619,7 +1638,7 @@

    E

     
    enable(JsonGenerator.Feature) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
    Method for enabling specified parser features: +
    Method for enabling specified generator feature: check JsonGenerator.Feature for list of available features.
    enable(JsonParser.Feature) - Method in class com.fasterxml.jackson.core.JsonParser
    @@ -1699,7 +1718,7 @@

    E

     
    enabledIn(int) - Method in interface com.fasterxml.jackson.core.util.JacksonFeature
    -
    Convenience method for checking whether feature is enabled in given bitmask
    +
    Convenience method for checking whether feature is enabled in given bitmask.
    encode(byte[]) - Method in class com.fasterxml.jackson.core.Base64Variant
    @@ -1718,8 +1737,8 @@

    E

    encodeAsUTF8(String) - Method in class com.fasterxml.jackson.core.io.JsonStringEncoder
    -
    Will encode given String as UTF-8 (without any quoting), return - resulting byte array.
    +
    Will encode given String as UTF-8 (without any escaping) and return + the resulting byte array.
    encodeAsUTF8(CharSequence) - Method in class com.fasterxml.jackson.core.io.JsonStringEncoder
    @@ -1756,7 +1775,8 @@

    E

    endOfInput() - Method in interface com.fasterxml.jackson.core.async.NonBlockingInputFeeder
    Method that should be called after last chunk of data to parse has been fed - (with feedInput in sub-class); can be called regardless of what NonBlockingInputFeeder.needMoreInput() + (with feedInput in sub-class); can be called regardless of what + NonBlockingInputFeeder.needMoreInput() returns.
    endOfInput() - Method in class com.fasterxml.jackson.core.json.async.NonBlockingJsonParser
    @@ -2150,7 +2170,8 @@

    G

    Convenience accessor that can be called when the current token is JsonToken.VALUE_TRUE or - JsonToken.VALUE_FALSE.
    + JsonToken.VALUE_FALSE, to return matching boolean + value.
    getBooleanValue() - Method in class com.fasterxml.jackson.core.util.JsonParserDelegate
     
    @@ -2159,7 +2180,10 @@

    G

    Main accessor to call for accessing possibly recycled BufferRecycler instance.
    getBufferWithoutReset() - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
     
    +
    +
    Method for accessing the currently active (last) content segment + without changing state of the buffer
    +
    getByteOffset() - Method in class com.fasterxml.jackson.core.JsonLocation
     
    getByteValue() - Method in class com.fasterxml.jackson.core.filter.FilteringParserDelegate
    @@ -2267,11 +2291,7 @@

    G

     
    getCurrentName() - Method in class com.fasterxml.jackson.core.JsonParser
    -
    Method that can be called to get the name associated with - the current token: for JsonToken.FIELD_NAMEs it will - be the same as what JsonParser.getText() returns; - for field values it will be preceding field name; - and for others (array values, root-level values) null.
    +
    See JsonParser.currentName().
    getCurrentName() - Method in class com.fasterxml.jackson.core.JsonStreamContext
    @@ -2589,7 +2609,7 @@

    G

    getJsonFactory() - Method in class com.fasterxml.jackson.core.ObjectCodec
    Deprecated. -
    Since 2.1: Use ObjectCodec.getFactory() instead.
    +
    Use ObjectCodec.getFactory() instead.
    getKeyType() - Method in class com.fasterxml.jackson.core.type.ResolvedType
    @@ -2658,7 +2678,7 @@

    G

    getMask() - Method in interface com.fasterxml.jackson.core.util.JacksonFeature
    Returns bit mask for this feature instance; must be a single bit, - that is of form 1 << N
    + that is of form 1 << N.
    getMatch() - Method in class com.fasterxml.jackson.core.format.DataFormatMatcher
    @@ -2698,7 +2718,7 @@

    G

     
    getMessage() - Method in exception com.fasterxml.jackson.core.JsonProcessingException
    -
    Default method overridden so that we can add location information
    +
    Default implementation overridden so that we can add location information
    getMessageSuffix() - Method in exception com.fasterxml.jackson.core.JsonProcessingException
    @@ -2809,7 +2829,10 @@

    G

    getOutputContext() - Method in class com.fasterxml.jackson.core.filter.FilteringGeneratorDelegate
     
    getOutputContext() - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Accessor for context object that provides information about low-level + logical position withing output token stream.
    +
    getOutputContext() - Method in class com.fasterxml.jackson.core.util.JsonGeneratorDelegate
     
    getOutputDecorator() - Method in class com.fasterxml.jackson.core.JsonFactory
    @@ -2943,7 +2966,7 @@

    G

     
    getSchema() - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
    Method for accessing Schema that this parser uses, if any.
    +
    Method for accessing Schema that this generator uses, if any; null if none.
    getSchema() - Method in class com.fasterxml.jackson.core.JsonParser
    @@ -3036,9 +3059,9 @@

    G

     
    getTextBuffer() - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
    Accessor that may be used to get the contents of this buffer in a single - char array regardless of whether they were collected in a segmented - fashion or not.
    +
    Accessor that may be used to get the contents of this buffer as a single + char[] regardless of whether they were collected in a segmented + fashion or not: this typically require allocation of the result buffer.
    getTextCharacters() - Method in class com.fasterxml.jackson.core.base.ParserMinimalBase
     
    @@ -3218,7 +3241,7 @@

    G

    getValueAsInt() - Method in class com.fasterxml.jackson.core.JsonParser
    Method that will try to convert value of current token to a - int.
    + Java int value.
    getValueAsInt(int) - Method in class com.fasterxml.jackson.core.JsonParser
    @@ -3293,7 +3316,7 @@

    G

     
    getWriteCapabilities() - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
    Accessor for getting metadata on capabilities of this parser, based on +
    Accessor for getting metadata on capabilities of this generator, based on underlying data format being read (directly or indirectly).
    getWriteCapabilities() - Method in class com.fasterxml.jackson.core.util.JsonGeneratorDelegate
    @@ -3332,10 +3355,7 @@

    H

    hasCurrentToken() - Method in class com.fasterxml.jackson.core.util.JsonParserDelegate
     
    hasFormat(InputAccessor) - Method in class com.fasterxml.jackson.core.JsonFactory
    -
    -
    Convenience method for trying to determine whether input via given accessor - is of format type supported by this factory.
    -
    +
     
    hasGenericTypes() - Method in class com.fasterxml.jackson.core.type.ResolvedType
    Method that can be used to find out if the type directly declares generic @@ -3366,10 +3386,7 @@

    H

    supports UTF-8, for example.
    hasJSONFormat(InputAccessor) - Method in class com.fasterxml.jackson.core.JsonFactory
    -
    -
    Helper method that can be called to determine if content accessed - using given accessor seems to be JSON content.
    -
    +
     
    hasMatch() - Method in class com.fasterxml.jackson.core.format.DataFormatMatcher
    Accessor to use to see if any formats matched well enough with @@ -3544,7 +3561,7 @@

    I

    inArray() - Method in class com.fasterxml.jackson.core.JsonStreamContext
    Method that returns true if this context is an Array context; - that is, content is being read from or written to a Json Array.
    + that is, content is being read from or written to a JSON Array.
    include - Variable in class com.fasterxml.jackson.core.type.WritableTypeId
    @@ -3677,7 +3694,7 @@

    I

    inObject() - Method in class com.fasterxml.jackson.core.JsonStreamContext
    Method that returns true if this context is an Object context; - that is, content is being read from or written to a Json Object.
    + that is, content is being read from or written to a JSON Object.
    InputAccessor - Interface in com.fasterxml.jackson.core.format
    @@ -3841,7 +3858,11 @@

    I

    isContainerType() - Method in class com.fasterxml.jackson.core.type.ResolvedType
     
    isDup(String) - Method in class com.fasterxml.jackson.core.json.DupDetector
    -
     
    +
    +
    Method called to check whether a newly encountered property name would + be a duplicate within this context, and if not, update the state to remember + having seen the property name for checking more property names
    +
    isEnabled(JsonGenerator.Feature) - Method in class com.fasterxml.jackson.core.base.GeneratorBase
     
    isEnabled(JsonFactory.Feature) - Method in class com.fasterxml.jackson.core.JsonFactory
    @@ -3850,22 +3871,28 @@

    I

    isEnabled(JsonParser.Feature) - Method in class com.fasterxml.jackson.core.JsonFactory
    -
    Checked whether specified parser feature is enabled.
    +
    Method for checking if the specified parser feature is enabled.
    isEnabled(StreamReadFeature) - Method in class com.fasterxml.jackson.core.JsonFactory
    -
     
    +
    +
    Method for checking if the specified stream read feature is enabled.
    +
    isEnabled(JsonGenerator.Feature) - Method in class com.fasterxml.jackson.core.JsonFactory
    Check whether specified generator feature is enabled.
    isEnabled(StreamWriteFeature) - Method in class com.fasterxml.jackson.core.JsonFactory
    -
     
    +
    +
    Check whether specified stream write feature is enabled.
    +
    isEnabled(JsonGenerator.Feature) - Method in class com.fasterxml.jackson.core.JsonGenerator
    Method for checking whether given feature is enabled.
    isEnabled(StreamWriteFeature) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Method for checking whether given feature is enabled.
    +
    isEnabled(JsonParser.Feature) - Method in class com.fasterxml.jackson.core.JsonParser
    Method for checking whether specified JsonParser.Feature is enabled.
    @@ -4247,9 +4274,7 @@

    J

    state that matches current node.
    JsonPointer(String, String, JsonPointer) - Constructor for class com.fasterxml.jackson.core.JsonPointer
    -
    -
    Constructor used for creating non-empty Segments
    -
    +
     
    JsonPointer(String, String, int, JsonPointer) - Constructor for class com.fasterxml.jackson.core.JsonPointer
     
    JsonPointerBasedFilter - Class in com.fasterxml.jackson.core.filter
    @@ -4340,9 +4365,7 @@

    J

    L

    last() - Method in class com.fasterxml.jackson.core.JsonPointer
    -
    -
    Returns the leaf of current JSON Pointer expression.
    -
    +
     
    LAST_VALID_UNICODE_CHAR - Static variable in class com.fasterxml.jackson.core.io.UTF32Reader
    JSON actually limits available Unicode range in the high end @@ -4411,21 +4434,29 @@

    M

    markSupported() - Method in class com.fasterxml.jackson.core.io.MergedStream
     
    matchElement(int) - Method in class com.fasterxml.jackson.core.JsonPointer
    -
     
    +
    +
    Method that may be called to check whether the pointer head (first segment) + matches specified Array index and if so, return + JsonPointer that represents rest of the path after match.
    +
    matches() - Method in class com.fasterxml.jackson.core.JsonPointer
     
    matchesElement(int) - Method in class com.fasterxml.jackson.core.JsonPointer
    Method that may be called to see if the pointer would match - array element (of a JSON Array) with given index.
    + Array element (of a JSON Array) with given index.
    matchesProperty(String) - Method in class com.fasterxml.jackson.core.JsonPointer
    -
    Method that may be called to see if the pointer would match property - (of a JSON Object) with given name.
    +
    Method that may be called to see if the pointer head (first segment) + would match property (of a JSON Object) with given name.
    matchProperty(String) - Method in class com.fasterxml.jackson.core.JsonPointer
    -
     
    +
    +
    Method that may be called to check whether the pointer head (first segment) + matches specified Object property (by name) and if so, return + JsonPointer that represents rest of the path after match.
    +
    MatchStrength - Enum in com.fasterxml.jackson.core.format
    Enumeration used to indicate strength of match between data format @@ -4884,11 +4915,17 @@

    O

    outputDecorator(OutputDecorator) - Method in class com.fasterxml.jackson.core.TSFBuilder
     
    outputInt(int, char[], int) - Static method in class com.fasterxml.jackson.core.io.NumberOutput
    -
     
    +
    +
    Method for appending value of given int value into + specified char[].
    +
    outputInt(int, byte[], int) - Static method in class com.fasterxml.jackson.core.io.NumberOutput
     
    outputLong(long, char[], int) - Static method in class com.fasterxml.jackson.core.io.NumberOutput
    -
     
    +
    +
    Method for appending value of given long value into + specified char[].
    +
    outputLong(long, byte[], int) - Static method in class com.fasterxml.jackson.core.io.NumberOutput
     
    overrideCurrentName(String) - Method in class com.fasterxml.jackson.core.base.ParserBase
    @@ -4952,8 +4989,9 @@

    P

     
    packageVersionFor(Class<?>) - Static method in class com.fasterxml.jackson.core.util.VersionUtil
    -
    Loads version information by introspecting a class named - "PackageVersion" in the same package as the given class.
    +
    Deprecated. +
    Since 2.12 simply use VersionUtil.versionFor(Class) instead
    +
    PADDING_CHAR_NONE - Static variable in class com.fasterxml.jackson.core.Base64Variant
    @@ -4990,7 +5028,7 @@

    P

    parseInt(char[], int, int) - Static method in class com.fasterxml.jackson.core.io.NumberInput
    -
    Fast method for parsing integers that are known to fit into +
    Fast method for parsing unsigned integers that are known to fit into regular 32-bit signed int type.
    parseInt(String) - Static method in class com.fasterxml.jackson.core.io.NumberInput
    @@ -5001,7 +5039,9 @@

    P

    parseLong(char[], int, int) - Static method in class com.fasterxml.jackson.core.io.NumberInput
     
    parseLong(String) - Static method in class com.fasterxml.jackson.core.io.NumberInput
    -
     
    +
    +
    Similar to NumberInput.parseInt(String) but for long values.
    +
    parseLongName(int, int, int) - Method in class com.fasterxml.jackson.core.json.UTF8StreamJsonParser
     
    parseMediumName(int) - Method in class com.fasterxml.jackson.core.json.UTF8StreamJsonParser
    @@ -5071,11 +5111,17 @@

    P

    putQuotedUTF8(ByteBuffer) - Method in class com.fasterxml.jackson.core.io.SerializedString
     
    putQuotedUTF8(ByteBuffer) - Method in interface com.fasterxml.jackson.core.SerializableString
    -
     
    +
    +
    Method for appending JSON-escaped UTF-8 encoded String value into given + ByteBuffer, if it fits.
    +
    putUnquotedUTF8(ByteBuffer) - Method in class com.fasterxml.jackson.core.io.SerializedString
     
    putUnquotedUTF8(ByteBuffer) - Method in interface com.fasterxml.jackson.core.SerializableString
    -
     
    +
    +
    Method for appending unquoted ('raw') UTF-8 encoded String value into given + ByteBuffer, if it fits.
    +
    @@ -5084,8 +5130,8 @@

    Q

    quoteAsString(String) - Method in class com.fasterxml.jackson.core.io.JsonStringEncoder
    -
    Method that will quote text contents using JSON standard quoting, - and return results as a character array
    +
    Method that will escape text contents using JSON standard escaping, + and return results as a character array.
    quoteAsString(CharSequence) - Method in class com.fasterxml.jackson.core.io.JsonStringEncoder
    @@ -5098,8 +5144,9 @@

    Q

    quoteAsUTF8(String) - Method in class com.fasterxml.jackson.core.io.JsonStringEncoder
    -
    Will quote given JSON String value using standard quoting, encode - results as UTF-8, and return result as a byte array.
    +
    Method that will escape text contents using JSON standard escaping, + encode resulting String as UTF-8 bytes + and return results as a byte array.
    quoteChar(char) - Method in class com.fasterxml.jackson.core.JsonFactoryBuilder
    @@ -5175,11 +5222,12 @@

    R

    readResolve() - Method in class com.fasterxml.jackson.core.JsonFactory
    Method that we need to override to actually make restoration go - through constructors etc.
    + through constructors etc: needed to allow JDK serializability of + factory instances.
    readTree(JsonParser) - Method in class com.fasterxml.jackson.core.ObjectCodec
    -
    Method to deserialize JSON content as tree expressed +
    Method for deserializing JSON content as tree expressed using set of TreeNode instances.
    readTree(JsonParser) - Method in class com.fasterxml.jackson.core.TreeCodec
    @@ -5431,7 +5479,10 @@

    R

    resetInt(boolean, int) - Method in class com.fasterxml.jackson.core.base.ParserBase
     
    resetWith(char) - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
     
    +
    +
    Method for clearing out possibly existing content, and replacing them with + a single-character content (so TextBuffer.size() would return 1)
    +
    resetWithCopy(char[], int, int) - Method in class com.fasterxml.jackson.core.util.TextBuffer
     
    resetWithCopy(String, int, int) - Method in class com.fasterxml.jackson.core.util.TextBuffer
    @@ -5571,7 +5622,12 @@

    S

    setCodec(ObjectCodec) - Method in class com.fasterxml.jackson.core.util.JsonParserDelegate
     
    setCurrentAndReturn(int) - Method in class com.fasterxml.jackson.core.util.TextBuffer
    -
     
    +
    +
    Convenience method that finishes the current active content segment + (by specifying how many characters within consists of valid content) + and aggregates and returns resulting contents (similar to a call + to TextBuffer.contentsAsString()).
    +
    setCurrentLength(int) - Method in class com.fasterxml.jackson.core.util.TextBuffer
     
    setCurrentName(String) - Method in class com.fasterxml.jackson.core.json.JsonReadContext
    @@ -5664,7 +5720,7 @@

    S

    setOutputDecorator(OutputDecorator) - Method in class com.fasterxml.jackson.core.JsonFactory
    Deprecated. -
    Since 2.10 use TSFBuilder.inputDecorator(InputDecorator) instead
    +
    Since 2.10 use TSFBuilder.outputDecorator(OutputDecorator) instead
    setPrettyPrinter(PrettyPrinter) - Method in class com.fasterxml.jackson.core.JsonGenerator
    @@ -5822,7 +5878,7 @@

    S

    spilloverCount() - Method in class com.fasterxml.jackson.core.sym.ByteQuadsCanonicalizer
    Method mostly needed by unit tests; calculates number of entries - in shared spillover area
    + in shared spill-over area
    standardAsciiEscapesForJSON() - Static method in class com.fasterxml.jackson.core.io.CharacterEscapes
    @@ -5928,8 +5984,8 @@

    T

    tail() - Method in class com.fasterxml.jackson.core.JsonPointer
    -
    Accessor for getting a "sub-pointer", instance where current segment - has been removed and pointer includes rest of segments.
    +
    Accessor for getting a "sub-pointer" (or sub-path), instance where current segment + has been removed and pointer includes rest of the segments.
    tertiaryCount() - Method in class com.fasterxml.jackson.core.sym.ByteQuadsCanonicalizer
    @@ -6100,7 +6156,11 @@

    T

    Indicator for "Root Value" context (has not parent)
    typeDesc() - Method in class com.fasterxml.jackson.core.JsonStreamContext
    -
     
    +
    +
    Method for accessing simple type description of current context; + either ROOT (for root-level values), OBJECT (for field names and + values of JSON Objects) or ARRAY (for values of JSON Arrays)
    +
    TypeReference<T> - Class in com.fasterxml.jackson.core.type
    This generic abstract class is used for obtaining full generics type information @@ -6419,8 +6479,8 @@

    V

    versionFor(Class<?>) - Static method in class com.fasterxml.jackson.core.util.VersionUtil
    -
    Helper method that will try to load version information for specified - class.
    +
    Loads version information by introspecting a class named + "PackageVersion" in the same package as the given class.
    VersionUtil - Class in com.fasterxml.jackson.core.util
    @@ -6535,7 +6595,9 @@

    W

    withRootSeparator(String) - Method in class com.fasterxml.jackson.core.util.DefaultPrettyPrinter
     
    withSeparators(Separators) - Method in class com.fasterxml.jackson.core.util.DefaultPrettyPrinter
    -
     
    +
    +
    Method for configuring separators for this pretty-printer to use
    +
    withSpacesInObjectEntries() - Method in class com.fasterxml.jackson.core.util.DefaultPrettyPrinter
    "Mutant factory" method that will return a pretty printer instance @@ -6749,8 +6811,9 @@

    W

    writeEmbeddedObject(Object) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
    Method that can be called on backends that support passing opaque datatypes of - non-JSON formats
    +
    Method that can be called on backends that support passing opaque native + values that some data formats support; not used with JSON backend, + more common with binary formats.
    writeEmbeddedObject(Object) - Method in class com.fasterxml.jackson.core.util.JsonGeneratorDelegate
     
    @@ -7027,7 +7090,7 @@

    W

     
    writeObjectEntrySeparator(JsonGenerator) - Method in interface com.fasterxml.jackson.core.PrettyPrinter
    -
    Method called after an object entry (field:value) has been completely +
    Method called after an Object entry (field:value) has been completely output, and before another value is to be output.
    writeObjectEntrySeparator(JsonGenerator) - Method in class com.fasterxml.jackson.core.util.DefaultPrettyPrinter
    @@ -7098,7 +7161,10 @@

    W

    writeQuotedUTF8(OutputStream) - Method in class com.fasterxml.jackson.core.io.SerializedString
     
    writeQuotedUTF8(OutputStream) - Method in interface com.fasterxml.jackson.core.SerializableString
    -
     
    +
    +
    Method for writing JSON-escaped UTF-8 encoded String value using given + OutputStream.
    +
    writeRaw(String) - Method in class com.fasterxml.jackson.core.filter.FilteringGeneratorDelegate
     
    writeRaw(String, int, int) - Method in class com.fasterxml.jackson.core.filter.FilteringGeneratorDelegate
    @@ -7280,9 +7346,20 @@

    W

    writeStartArray(Object) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), + but also specifying the "current value" + to assign to the new Array context being created.
    +
    writeStartArray(Object, int) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Method for writing start marker of an Array value, similar + to JsonGenerator.writeStartArray(), but also specifying the "current value" + to assign to the new Array context being created + as well as how many elements will be written for the array before calling + JsonGenerator.writeEndArray().
    +
    writeStartArray(JsonGenerator) - Method in interface com.fasterxml.jackson.core.PrettyPrinter
    Method called when an Array value is to be output, before @@ -7413,7 +7490,10 @@

    W

    where given JsonNode is the root) using this generator.
    writeTree(JsonGenerator, TreeNode) - Method in class com.fasterxml.jackson.core.ObjectCodec
    -
     
    +
    +
    Method for serializing JSON content from given Tree instance, using + specified generator.
    +
    writeTree(JsonGenerator, TreeNode) - Method in class com.fasterxml.jackson.core.TreeCodec
     
    writeTree(TreeNode) - Method in class com.fasterxml.jackson.core.util.JsonGeneratorDelegate
    @@ -7427,13 +7507,22 @@

    W

    writeTypeId(Object) - Method in class com.fasterxml.jackson.core.util.JsonGeneratorDelegate
     
    writeTypePrefix(WritableTypeId) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Replacement method for JsonGenerator.writeTypeId(Object) which is called + regardless of whether format has native type ids.
    +
    writeTypeSuffix(WritableTypeId) - Method in class com.fasterxml.jackson.core.JsonGenerator
    -
     
    +
    +
    Method to call along with JsonGenerator.writeTypePrefix(com.fasterxml.jackson.core.type.WritableTypeId), but after actual value + that has type id has been completely written.
    +
    writeUnquotedUTF8(OutputStream) - Method in class com.fasterxml.jackson.core.io.SerializedString
     
    writeUnquotedUTF8(OutputStream) - Method in interface com.fasterxml.jackson.core.SerializableString
    -
     
    +
    +
    Method for writing unescaped UTF-8 encoded String value using given + OutputStream.
    +
    writeUTF8String(byte[], int, int) - Method in class com.fasterxml.jackson.core.filter.FilteringGeneratorDelegate
     
    writeUTF8String(byte[], int, int) - Method in class com.fasterxml.jackson.core.json.UTF8JsonGenerator
    @@ -9398,6 +9487,6 @@

    _

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/index.html b/docs/javadoc/2.12/index.html index 37612985c1..65ed745bdd 100644 --- a/docs/javadoc/2.12/index.html +++ b/docs/javadoc/2.12/index.html @@ -2,7 +2,7 @@ - + Jackson-core 2.12.0 API diff --git a/docs/javadoc/2.12/overview-summary.html b/docs/javadoc/2.12/overview-summary.html index c0396b4319..769aa18a96 100644 --- a/docs/javadoc/2.12/overview-summary.html +++ b/docs/javadoc/2.12/overview-summary.html @@ -2,10 +2,10 @@ - + Overview (Jackson-core 2.12.0 API) - + @@ -214,6 +214,6 @@

    Jackson-core 2.12.0 API

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/overview-tree.html b/docs/javadoc/2.12/overview-tree.html index 02c626a78a..7d8d2d6ed8 100644 --- a/docs/javadoc/2.12/overview-tree.html +++ b/docs/javadoc/2.12/overview-tree.html @@ -2,10 +2,10 @@ - + Class Hierarchy (Jackson-core 2.12.0 API) - + @@ -380,6 +380,6 @@

    Enum Hierarchy

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.

    diff --git a/docs/javadoc/2.12/serialized-form.html b/docs/javadoc/2.12/serialized-form.html index 992e6d0d1d..5bedfe24fd 100644 --- a/docs/javadoc/2.12/serialized-form.html +++ b/docs/javadoc/2.12/serialized-form.html @@ -2,10 +2,10 @@ - + Serialized Form (Jackson-core 2.12.0 API) - + @@ -171,8 +171,10 @@

    Serialization Methods

    readResolve

    protected Object readResolve()
    Method that we need to override to actually make restoration go - through constructors etc. - Also: must be overridden by sub-classes as well.
    + through constructors etc: needed to allow JDK serializability of + factory instances. +

    + Note: must be overridden by sub-classes as well. @@ -804,6 +806,6 @@

    arrayValueSeparator

    -

    Copyright © 2008–2020 FasterXML. All rights reserved.

    +

    Copyright © 2008–2021 FasterXML. All rights reserved.