Module tools.jackson.core

Package tools.jackson.core.exc

Class StreamReadException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

tools.jackson.core.JacksonException

tools.jackson.core.exc.StreamReadException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

InputCoercionException, UnexpectedEndOfInputException

public class StreamReadException
extends JacksonException

Intermediate base class for all read-side streaming processing problems, including parsing and input value coercion problems.

See Also:

• Serialized Form

Nested Class Summary

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

JacksonException.Reference

Field Summary

Fields inherited from class tools.jackson.core.JacksonException

_location, _path, _processor

Constructor Summary

Constructors

Constructor	Description
StreamReadException(String msg)
StreamReadException(JsonParser p, String msg)
StreamReadException(JsonParser p, String msg, Throwable rootCause)
StreamReadException(JsonParser p, String msg, TokenStreamLocation loc)
StreamReadException(JsonParser p, String msg, TokenStreamLocation loc, Throwable rootCause)

Method Summary

Modifier and Type	Method	Description
JsonParser	processor()	Method that allows accessing underlying processor that triggered this exception; typically either JsonParser or JsonGenerator for exceptions that originate from streaming API, but may be other types when thrown by databinding.
StreamReadException	withParser(JsonParser p)	Fluent method that may be used to assign originating JsonParser, to be accessed using 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

Constructor Details

StreamReadException

public StreamReadException(String msg)

StreamReadException

public StreamReadException(JsonParser p,
 String msg)

StreamReadException

public StreamReadException(JsonParser p,
 String msg,
 Throwable rootCause)

StreamReadException

public StreamReadException(JsonParser p,
 String msg,
 TokenStreamLocation loc)

StreamReadException

public StreamReadException(JsonParser p,
 String msg,
 TokenStreamLocation loc,
 Throwable rootCause)

Method Details

withParser

public StreamReadException withParser(JsonParser p)

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

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

processor

public JsonParser processor()

Description copied from class: JacksonException

Method that allows accessing underlying processor that triggered this exception; typically either JsonParser or JsonGenerator for exceptions that originate from streaming API, but may be other types when thrown by databinding.

Note that it is possible that null may be returned if code throwing exception either has no access to the processor; or has not been retrofitted to set it; this means that caller needs to take care to check for nulls. Subtypes override this method with co-variant return type, for more type-safe access.

NOTE: In Jackson 2.x, accessor was getProcessor(): in 3.0 changed to non-getter to avoid having to annotate for serialization.

Overrides:

processor in class JacksonException

Returns:

Originating processor, if available; null if not.