com.fasterxml.jackson.core

Class JsonLocation

java.lang.Object

com.fasterxml.jackson.core.JsonLocation

All Implemented Interfaces:

java.io.Serializable

public class JsonLocation
extends java.lang.Object
implements java.io.Serializable

Object that encapsulates Location information used for reporting parsing (or potentially generation) errors, as well as current location within input streams.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int	_columnNr
(package private) int	_lineNr
(package private) java.lang.Object	_sourceRef Displayable description for input source: file path, URL.
(package private) long	_totalBytes
(package private) long	_totalChars
static JsonLocation	NA Shared immutable "N/A location" that can be returned to indicate that no location information is available
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
JsonLocation(java.lang.Object srcRef, long totalChars, int lineNr, int colNr)
JsonLocation(java.lang.Object sourceRef, long totalBytes, long totalChars, int lineNr, int columnNr)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
long	getByteOffset()
long	getCharOffset()
int	getColumnNr()
int	getLineNr()
java.lang.Object	getSourceRef() Reference to the original resource being read, if one available.
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

NA

public static final JsonLocation NA

Shared immutable "N/A location" that can be returned to indicate that no location information is available

_totalBytes

final long _totalBytes

_totalChars

final long _totalChars

_lineNr

final int _lineNr

_columnNr

final int _columnNr

_sourceRef

final transient java.lang.Object _sourceRef

Displayable description for input source: file path, URL.

NOTE: transient since 2.2 so that Location itself is Serializable.

Constructor Detail

JsonLocation

public JsonLocation(java.lang.Object srcRef,
                    long totalChars,
                    int lineNr,
                    int colNr)

JsonLocation

public JsonLocation(java.lang.Object sourceRef,
                    long totalBytes,
                    long totalChars,
                    int lineNr,
                    int columnNr)

Method Detail

getSourceRef

public java.lang.Object getSourceRef()

Reference to the original resource being read, if one available. For example, when a parser has been constructed by passing a File instance, this method would return that File. Will return null if no such reference is available, for example when InputStream was used to construct the parser instance.

getLineNr

public int getLineNr()

Returns:

Line number of the location (1-based)

getColumnNr

public int getColumnNr()

Returns:

Column number of the location (1-based)

getCharOffset

public long getCharOffset()

Returns:

Character offset within underlying stream, reader or writer, if available; -1 if not.

getByteOffset

public long getByteOffset()

Returns:

Byte offset within underlying stream, reader or writer, if available; -1 if not.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object