com.fasterxml.jackson.jr.ob
Class JSONObjectException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.io.IOException
              com.fasterxml.jackson.core.JsonProcessingException
                  com.fasterxml.jackson.jr.ob.JSONObjectException

All Implemented Interfaces:

Serializable

public class JSONObjectException
extends JsonProcessingException

Standard exception exposed by this package; equivalent of com.fasterxml.jackson.databind.JsonMappingException (and, in fact, much of implementation came from that class, but had to be cut-n-pasted since we do not depend on databind package).

See Also:

Serialized Form

Nested Class Summary

static class

JSONObjectException.Reference Simple bean class used to contain references.

Field Summary

protected LinkedList<JSONObjectException.Reference>

_path Path through which problem that triggering throwing of this exception was reached.

Fields inherited from class com.fasterxml.jackson.core.JsonProcessingException

_location

Constructor Summary

JSONObjectException(String msg)

JSONObjectException(String msg, JsonLocation loc)

JSONObjectException(String msg, JsonLocation loc, Throwable rootCause)

JSONObjectException(String msg, Throwable rootCause)

Method Summary

protected void	_appendPathDesc(StringBuilder sb)
protected String	_buildMessage()
static JSONObjectException	from(JsonParser jp, String msg)
static JSONObjectException	from(JsonParser jp, String msg, Throwable problem)
static JSONObjectException	fromUnexpectedIOE(IOException src) Factory method used when "upgrading" an IOException into JSONObjectException: usually only needed to comply with a signature.
String	getLocalizedMessage()
String	getMessage() Method is overridden so that we can properly inject description of problem path, if such is defined.
List<JSONObjectException.Reference>	getPath() Method for accessing full structural path within type hierarchy down to problematic property.
String	getPathReference() Method for accesing description of path that lead to the problem that triggered this exception
StringBuilder	getPathReference(StringBuilder sb)
void	prependPath(JSONObjectException.Reference r)
void	prependPath(Object referrer, int index) Method called to prepend a reference information in front of current path
void	prependPath(Object referrer, String fieldName) Method called to prepend a reference information in front of current path
String	toString()
static JSONObjectException	wrapWithPath(Throwable src, JSONObjectException.Reference ref) Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information.
static JSONObjectException	wrapWithPath(Throwable src, Object refFrom, int index) Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information.
static JSONObjectException	wrapWithPath(Throwable src, Object refFrom, String refFieldName) Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information.

Methods inherited from class com.fasterxml.jackson.core.JsonProcessingException

getLocation, getMessageSuffix, getOriginalMessage, getProcessor

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Field Detail

_path

protected LinkedList<JSONObjectException.Reference> _path

Path through which problem that triggering throwing of this exception was reached.

Constructor Detail

JSONObjectException

public JSONObjectException(String msg)

JSONObjectException

public JSONObjectException(String msg,
                           Throwable rootCause)

JSONObjectException

public JSONObjectException(String msg,
                           JsonLocation loc)

JSONObjectException

public JSONObjectException(String msg,
                           JsonLocation loc,
                           Throwable rootCause)

Method Detail

from

public static JSONObjectException from(JsonParser jp,
                                       String msg)

from

public static JSONObjectException from(JsonParser jp,
                                       String msg,
                                       Throwable problem)

fromUnexpectedIOE

public static JSONObjectException fromUnexpectedIOE(IOException src)

Factory method used when "upgrading" an IOException into JSONObjectException: usually only needed to comply with a signature.

wrapWithPath

public static JSONObjectException wrapWithPath(Throwable src,
                                               Object refFrom,
                                               String refFieldName)

Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information. This version of method is called when the reference is through a non-indexed object, such as a Map or POJO/bean.

wrapWithPath

public static JSONObjectException wrapWithPath(Throwable src,
                                               Object refFrom,
                                               int index)

Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information. This version of method is called when the reference is through an index, which happens with arrays and Collections.

wrapWithPath

public static JSONObjectException wrapWithPath(Throwable src,
                                               JSONObjectException.Reference ref)

Method that can be called to either create a new JsonMappingException (if underlying exception is not a JsonMappingException), or augment given exception with given path/reference information.

getPath

public List<JSONObjectException.Reference> getPath()

Method for accessing full structural path within type hierarchy down to problematic property.

getPathReference

public String getPathReference()

Method for accesing description of path that lead to the problem that triggered this exception

getPathReference

public StringBuilder getPathReference(StringBuilder sb)

prependPath

public void prependPath(Object referrer,
                        String fieldName)

Method called to prepend a reference information in front of current path

prependPath

public void prependPath(Object referrer,
                        int index)

Method called to prepend a reference information in front of current path

prependPath

public void prependPath(JSONObjectException.Reference r)

getLocalizedMessage

public String getLocalizedMessage()

Overrides:

getLocalizedMessage in class Throwable

getMessage

public String getMessage()

Method is overridden so that we can properly inject description of problem path, if such is defined.

Overrides:

getMessage in class JsonProcessingException

_buildMessage

protected String _buildMessage()

toString

public String toString()

Overrides:

toString in class JsonProcessingException

_appendPathDesc

protected void _appendPathDesc(StringBuilder sb)