Module tools.jackson.core

Package tools.jackson.core.exc

Class InputCoercionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

tools.jackson.core.JacksonException

tools.jackson.core.exc.StreamReadException

tools.jackson.core.exc.InputCoercionException

All Implemented Interfaces:

Serializable

public class InputCoercionException
extends StreamReadException

Exception type for read-side problems that are not direct decoding ("parsing") problems (those would be reported as basic StreamReadExceptions), but rather result from failed attempts to convert specific Java value out of valid but incompatible input value. One example is numeric coercions where target number type's range does not allow mapping of too large/too small input value.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class tools.jackson.core.JacksonException

JacksonException.Reference

Field Summary

Fields

Modifier and Type	Field	Description
protected final JsonToken	_inputType	Input token that represents input value that failed to coerce.
protected final Class<?>	_targetType	Target type that input value failed to coerce to.

Fields inherited from class tools.jackson.core.JacksonException

_location, _path, _processor

Constructor Summary

Constructors

Constructor	Description
InputCoercionException(JsonParser p, String msg, JsonToken inputType, Class<?> targetType)	Constructor that uses current parsing location as location, and sets processor (accessible via StreamReadException.processor()) to specified parser.

Method Summary

Modifier and Type	Method	Description
JsonToken	getInputType()	Accessor for getting information about input type (in form of token, giving "shape" of input) for which coercion failed.
Class<?>	getTargetType()	Accessor for getting information about target type (in form of Java Class) for which coercion failed.
InputCoercionException	withParser(JsonParser p)	Fluent method that may be used to assign originating JsonParser, to be accessed using StreamReadException.processor().

Methods inherited from class tools.jackson.core.exc.StreamReadException

processor

Methods inherited from class tools.jackson.core.JacksonException

_appendPathDesc, _appendReferenceChain, _buildMessage, _exceptionMessage, clearLocation, getLocalizedMessage, getLocation, getMessage, getOriginalMessage, getPath, getPathReference, getPathReference, messageSuffix, prependPath, prependPath, prependPath, toString, withCause, wrapWithPath, wrapWithPath, wrapWithPath, wrapWithPath

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

_inputType

protected final JsonToken _inputType

Input token that represents input value that failed to coerce.

_targetType

protected final Class<?> _targetType

Target type that input value failed to coerce to.

Constructor Details

InputCoercionException

public InputCoercionException(JsonParser p,
 String msg,
 JsonToken inputType,
 Class<?> targetType)

Constructor that uses current parsing location as location, and sets processor (accessible via StreamReadException.processor()) to specified parser.

Parameters:

p - Parser in use at the point where failure occurred

msg - Exception mesage to use

inputType - Shape of input that failed to coerce

targetType - Target type of failed coercion

Method Details

withParser

public InputCoercionException withParser(JsonParser p)

Fluent method that may be used to assign originating JsonParser, to be accessed using StreamReadException.processor().

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

Overrides:

withParser in class StreamReadException

Parameters:

p - Parser instance to assign to this exception

Returns:

This exception instance to allow call chaining

getInputType

public JsonToken getInputType()

Accessor for getting information about input type (in form of token, giving "shape" of input) for which coercion failed.

Returns:

"Shape" of input for which coercion failed, as JsonToken

getTargetType

public Class<?> getTargetType()

Accessor for getting information about target type (in form of Java Class) for which coercion failed.

Returns:

Target type of failed conversion