Modifier and Type	Class and Description
public static class	JSONObjectException.Reference Simple bean class used to contain references.

Modifier and Type	Field and Description
protected LinkedList<JSONObjectException.Reference>	_path Path through which problem that triggering throwing of this exception was reached.
pack-priv static final int	MAX_REFS_TO_LIST Let's limit length of reference chain, to limit damage in cases of infinite recursion.
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.JsonProcessingException.serialVersionUID.

Access	Constructor and Description
public	JSONObjectException(String msg)
public	JSONObjectException(String msg, Throwable rootCause)
public	JSONObjectException(String msg, JsonLocation loc)
public	JSONObjectException(String msg, JsonLocation loc, Throwable rootCause)

Method Summary

Modifier and Type	Method and Description
protected void	_appendPathDesc(StringBuilder sb)
protected String	_buildMessage()
public static JSONObjectException	from(JsonParser p, String msg)
public static JSONObjectException	from(JsonParser p, String msg, Object... args)
public static JSONObjectException	from(JsonParser p, Throwable problem, String msg, Object... args)
public static JSONObjectException	fromUnexpectedIOE(IOException src) Factory method used when "upgrading" an `IOException` into `JSONObjectException`: usually only needed to comply with a signature.
public String	getLocalizedMessage() Overrides java.lang.Throwable.getLocalizedMessage. Creates a localized description of this throwable.
public String	getMessage() Overrides com.fasterxml.jackson.core.JsonProcessingException.getMessage. Method is overridden so that we can properly inject description of problem path, if such is defined.
public List<JSONObjectException.Reference>	getPath() Method for accessing full structural path within type hierarchy down to problematic property.
public String	getPathReference() Method for accesing description of path that lead to the problem that triggered this exception
public StringBuilder	getPathReference(StringBuilder sb)
public void	prependPath(Object referrer, String fieldName) Method called to prepend a reference information in front of current path
public void	prependPath(Object referrer, int index) Method called to prepend a reference information in front of current path
public void	prependPath(JSONObjectException.Reference r)
public String	toString() Overrides com.fasterxml.jackson.core.JsonProcessingException.toString. Returns a short description of this throwable.
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.
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.
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.

Inherited from com.fasterxml.jackson.core.JsonProcessingException:: clearLocation getLocation getMessageSuffix getOriginalMessage getProcessor

Field Detail

_path	back to summary
protected LinkedList<JSONObjectException.Reference> _path Path through which problem that triggering throwing of this exception was reached.

MAX_REFS_TO_LIST	back to summary
pack-priv static final int MAX_REFS_TO_LIST Let's limit length of reference chain, to limit damage in cases of infinite recursion.

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.JsonProcessingException.serialVersionUID.

Constructor Detail

JSONObjectException	back to summary
public JSONObjectException(String msg)

JSONObjectException	back to summary
public JSONObjectException(String msg, Throwable rootCause)

JSONObjectException	back to summary
public JSONObjectException(String msg, JsonLocation loc)

JSONObjectException	back to summary
public JSONObjectException(String msg, JsonLocation loc, Throwable rootCause)

Method Detail

_appendPathDesc	back to summary
protected void _appendPathDesc(StringBuilder sb)

_buildMessage	back to summary
protected String _buildMessage()

from	back to summary
public static JSONObjectException from(JsonParser p, String msg)

from	back to summary
public static JSONObjectException from(JsonParser p, String msg, Object... args)

from	back to summary
public static JSONObjectException from(JsonParser p, Throwable problem, String msg, Object... args)

fromUnexpectedIOE	back to summary
public static JSONObjectException fromUnexpectedIOE(IOException src) Factory method used when "upgrading" an `IOException` into `JSONObjectException`: usually only needed to comply with a signature.

getLocalizedMessage back to summary

getLocalizedMessage	back to summary
public String getLocalizedMessage() Overrides java.lang.Throwable.getLocalizedMessage. Doc from java.lang.Throwable.getLocalizedMessage. Creates a localized description of this throwable. Subclasses may override this method in order to produce a locale-specific message. For subclasses that do not override this method, the default implementation returns the same result as `getMessage()`. Returns:String The localized description of this throwable. Annotations @Override

public String getLocalizedMessage()

Overrides java.lang.Throwable.getLocalizedMessage.

Doc from java.lang.Throwable.getLocalizedMessage.

Creates a localized description of this throwable. Subclasses may override this method in order to produce a locale-specific message. For subclasses that do not override this method, the default implementation returns the same result as getMessage().

Returns:String

The localized description of this throwable.

Annotations

@Override

getMessage back to summary

getMessage	back to summary
public String getMessage() Overrides com.fasterxml.jackson.core.JsonProcessingException.getMessage. Method is overridden so that we can properly inject description of problem path, if such is defined. Returns:String Doc from com.fasterxml.jackson.core.JsonProcessingException.getMessage. Original `message` preceded by optional prefix and followed by location information, message and location information separated by a linefeed Annotations @Override

public String getMessage()

Overrides com.fasterxml.jackson.core.JsonProcessingException.getMessage.

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

Returns:String

Doc from com.fasterxml.jackson.core.JsonProcessingException.getMessage.

Original message preceded by optional prefix and followed by location information, message and location information separated by a linefeed

Annotations

@Override

getPath	back to summary
public List<JSONObjectException.Reference> getPath() Method for accessing full structural path within type hierarchy down to problematic property.

getPathReference	back to summary
public String getPathReference() Method for accesing description of path that lead to the problem that triggered this exception

getPathReference	back to summary
public StringBuilder getPathReference(StringBuilder sb)

prependPath	back to summary
public void prependPath(Object referrer, String fieldName) Method called to prepend a reference information in front of current path

prependPath	back to summary
public void prependPath(Object referrer, int index) Method called to prepend a reference information in front of current path

prependPath	back to summary
public void prependPath(JSONObjectException.Reference r)

toString back to summary

toString	back to summary
public String toString() Overrides com.fasterxml.jackson.core.JsonProcessingException.toString. Doc from java.lang.Throwable.toString. Returns a short description of this throwable. The result is the concatenation of: the name of the class of this object ": " (a colon and a space) the result of invoking this object's `getLocalizedMessage` method If `getLocalizedMessage` returns `null`, then just the class name is returned. Returns:String a string representation of this throwable. Annotations @Override

public String toString()

Overrides com.fasterxml.jackson.core.JsonProcessingException.toString.

Doc from java.lang.Throwable.toString.

Returns a short description of this throwable. The result is the concatenation of:

the name of the class of this object
": " (a colon and a space)
the result of invoking this object's getLocalizedMessage method

If getLocalizedMessage returns null, then just the class name is returned.

Returns:String

a string representation of this throwable.

Annotations

@Override

wrapWithPath	back to summary
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

back to summary

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	back to summary
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

back to summary

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

wrapWithPath	back to summary
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.

com.fasterxml.jackson.jr.ob back to summary

public Class JSONObjectException.Reference

Class Inheritance

extends Object
implements Serializable

java.lang.Object
com.fasterxml.jackson.jr.ob.JSONObjectException.Reference

All Implemented Interfaces

java.io.Serializable

Simple bean class used to contain references. References can be added to indicate execution/reference path that lead to the problem that caused this exception to be thrown.

Field Summary

Modifier and Type	Field and Description
protected String	_fieldName Name of field (for beans) or key (for Maps) that is part of the reference.
protected Object	_from Object through which reference was resolved.
protected int	_index Index within a `Collection` instance that contained the reference; used if index is relevant and available.
private static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
protected	Reference() Default constructor for deserialization/sub-classing purposes
public	Reference(Object from)
public	Reference(Object from, String fieldName)
public	Reference(Object from, int index)

Method Summary

Modifier and Type	Method and Description
public String	getFieldName()
public Object	getFrom()
public int	getIndex()
public void	setFieldName(String n)
public void	setFrom(Object o)
public void	setIndex(int ix)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

_fieldName	back to summary
protected String _fieldName Name of field (for beans) or key (for Maps) that is part of the reference. May be null for Collection types (which generally have `_index` defined), or when resolving Map classes without (yet) having an instance to operate on.

_from	back to summary
protected Object _from Object through which reference was resolved. Can be either actual instance (usually the case for serialization), or Class (usually the case for deserialization).

_index	back to summary
protected int _index Index within a `Collection` instance that contained the reference; used if index is relevant and available. If either not applicable, or not available, -1 is used to denote "not known".

serialVersionUID	back to summary
private static final long serialVersionUID

Constructor Detail

Reference	back to summary
protected Reference() Default constructor for deserialization/sub-classing purposes

Reference	back to summary
public Reference(Object from)

Reference	back to summary
public Reference(Object from, String fieldName)

Reference	back to summary
public Reference(Object from, int index)

Method Detail

getFieldName	back to summary
public String getFieldName()

getFrom	back to summary
public Object getFrom()

getIndex	back to summary
public int getIndex()

setFieldName	back to summary
public void setFieldName(String n)

setFrom	back to summary
public void setFrom(Object o)

setIndex	back to summary
public void setIndex(int ix)

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

public Class JSONObjectException

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JSONObjectException.Reference

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail