Jackson 2.18.2 · com.fasterxml.jackson.core.JsonLocation

Field Summary

Modifier and Type	Field and Description
protected final int	_columnNr
protected final ContentReference	_contentReference Reference to input source; never null (but may be that of `ContentReference#unknown()`).
protected final int	_lineNr
protected transient String	_sourceDescription Lazily constructed description for source; constructed if and when `sourceDescription()` is called, retained.
protected final long	_totalBytes
protected final long	_totalChars
public static final int	MAX_CONTENT_SNIPPET Deprecated Since 2.13 use `ErrorReportConfiguration#DEFAULT_MAX_RAW_CONTENT_LENGTH` instead
public static final JsonLocation	NA Shared immutable "N/A location" that can be returned to indicate that no location information is available.
private static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
public	JsonLocation(ContentReference contentRef, long totalChars, int lineNr, int colNr)
public	JsonLocation(ContentReference contentRef, long totalBytes, long totalChars, int lineNr, int columnNr)
public	JsonLocation(Object srcRef, long totalChars, int lineNr, int columnNr) Deprecated
public	JsonLocation(Object srcRef, long totalBytes, long totalChars, int lineNr, int columnNr) Deprecated

Method Summary

Modifier and Type	Method and Description
protected static ContentReference	_wrap(Object srcRef)
public StringBuilder	appendOffsetDescription(StringBuilder sb)
public ContentReference	Returns: Object with information about input source. contentReference() Accessor for information about the original input source content is being read from.
public boolean	equals(Object the reference object with which to compare. other) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public long	Returns: Byte offset within underlying stream, reader or writer, if available; `-1` if not. getByteOffset()
public long	Returns: Character offset within underlying stream, reader or writer, if available; `-1` if not. getCharOffset()
public int	Returns: Column offset of the location (1-based), if available; `-1` if not. getColumnNr() Access for getting column offset of this location, if available.
public int	Returns: Line number of the location (1-based), if available; `-1` if not. getLineNr() Access for getting line number of this location, if available.
public Object	Returns: Source reference this location was constructed with, if any; `null` if none getSourceRef() Deprecated Since 2.13 Use `contentReference` instead Reference to the original resource being read, if one available.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
public String	Returns: Description of available relevant location offsets; combination of line number and column position or byte offset offsetDescription() Accessor for a brief summary of Location offsets (line number, column position, or byte offset, if available).
public String	Returns: Description of the source reference (see `getSourceRef()` sourceDescription() Accessor for getting a textual description of source reference (Object returned by `getSourceRef()`), as included in description returned by `toString()`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

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

Field Detail

_columnNr	back to summary
protected final int _columnNr

_contentReference back to summary

_contentReference	back to summary
protected final ContentReference _contentReference Reference to input source; never null (but may be that of `ContentReference#unknown()`). Since 2.13 (before we have `_sourceRef` (Object-valued)

protected final ContentReference _contentReference

Reference to input source; never null (but may be that of ContentReference#unknown()).

Since: 2.13 (before we have _sourceRef (Object-valued)

_lineNr	back to summary
protected final int _lineNr

_sourceDescription back to summary

_sourceDescription	back to summary
protected transient String _sourceDescription Lazily constructed description for source; constructed if and when `sourceDescription()` is called, retained. Since 2.13

protected transient String _sourceDescription

Lazily constructed description for source; constructed if and when sourceDescription() is called, retained.

Since: 2.13

_totalBytes	back to summary
protected final long _totalBytes

_totalChars	back to summary
protected final long _totalChars

MAX_CONTENT_SNIPPET	back to summary
public static final int MAX_CONTENT_SNIPPET Deprecated Since 2.13 use `ErrorReportConfiguration#DEFAULT_MAX_RAW_CONTENT_LENGTH` instead Annotations @Deprecated

NA	back to summary
public static final JsonLocation NA Shared immutable "N/A location" that can be returned to indicate that no location information is available. Note before 2.9, Location was given as String "N/A"; with 2.9 it was removed so that source should be indicated as "UNKNOWN".

serialVersionUID	back to summary
private static final long serialVersionUID

Constructor Detail

JsonLocation	back to summary
public JsonLocation(ContentReference contentRef, long totalChars, int lineNr, int colNr)

JsonLocation	back to summary
public JsonLocation(ContentReference contentRef, long totalBytes, long totalChars, int lineNr, int columnNr)

JsonLocation	back to summary
public JsonLocation(Object srcRef, long totalChars, int lineNr, int columnNr) Deprecated Annotations @Deprecated

JsonLocation	back to summary
public JsonLocation(Object srcRef, long totalBytes, long totalChars, int lineNr, int columnNr) Deprecated Annotations @Deprecated

Method Detail

_wrap	back to summary
protected static ContentReference _wrap(Object srcRef)

appendOffsetDescription	back to summary
public StringBuilder appendOffsetDescription(StringBuilder sb)

contentReference back to summary

contentReference	back to summary
public ContentReference contentReference() Accessor for information about the original input source content is being read from. Returned reference is never `null` but may not contain useful information. Note not getter, on purpose, to avoid inlusion if serialized using default Jackson serializer. Returns:ContentReference Object with information about input source. Since 2.13 (to replace `getSourceRef`)

public ContentReference contentReference()

Accessor for information about the original input source content is being read from. Returned reference is never null but may not contain useful information.

Note

not getter, on purpose, to avoid inlusion if serialized using default Jackson serializer.

Returns:ContentReference: Object with information about input source.
Since: 2.13 (to replace getSourceRef)

equals back to summary

equals	back to summary
public boolean equals(Object other) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters other:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object other)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

other:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

getByteOffset	back to summary
public long getByteOffset() Returns:long Byte offset within underlying stream, reader or writer, if available; `-1` if not.

getCharOffset	back to summary
public long getCharOffset() Returns:long Character offset within underlying stream, reader or writer, if available; `-1` if not.

getColumnNr back to summary

getColumnNr	back to summary
public int getColumnNr() Access for getting column offset of this location, if available. Note that column position is typically not available for binary formats. Note this returns an offset that is in units of input, so for `byte`-based input sources (like `java.io.InputStream`) this does not take into account multi-byte characters: one logical character can be 1, 2 or 3 bytes long. To calculate column position in characters either `char`-based input source (like `java.io.Reader`) needs to be used, or content needs to be explicitly decoded. Returns:int Column offset of the location (1-based), if available; `-1` if not.

public int getColumnNr()

Access for getting column offset of this location, if available. Note that column position is typically not available for binary formats.

Note

this returns an offset that is in units of input, so for byte-based input sources (like java.io.InputStream) this does not take into account multi-byte characters: one logical character can be 1, 2 or 3 bytes long. To calculate column position in characters either char-based input source (like java.io.Reader) needs to be used, or content needs to be explicitly decoded.

Returns:int: Column offset of the location (1-based), if available; -1 if not.

getLineNr back to summary

getLineNr	back to summary
public int getLineNr() Access for getting line number of this location, if available. Note that line number is typically not available for binary formats. Returns:int Line number of the location (1-based), if available; `-1` if not.

public int getLineNr()

Access for getting line number of this location, if available. Note that line number is typically not available for binary formats.

Returns:int: Line number of the location (1-based), if available; -1 if not.

getSourceRef back to summary

getSourceRef	back to summary
public Object getSourceRef() Deprecated Since 2.13 Use `contentReference` instead Reference to the original resource being read, if one available. For example, when a parser has been constructed by passing a `java.io.File` instance, this method would return that File. Will return null if no such reference is available, for example when `java.io.InputStream` was used to construct the parser instance. Returns:Object Source reference this location was constructed with, if any; `null` if none Annotations @Deprecated

public Object getSourceRef()

Deprecated

Since 2.13 Use contentReference instead

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

Returns:Object

Source reference this location was constructed with, if any; null if none

Annotations

@Deprecated

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object

Annotations

@Override

offsetDescription	back to summary
public String offsetDescription() Accessor for a brief summary of Location offsets (line number, column position, or byte offset, if available). Returns:String Description of available relevant location offsets; combination of line number and column position or byte offset Since 2.13

offsetDescription

back to summary

public String offsetDescription()

Accessor for a brief summary of Location offsets (line number, column position, or byte offset, if available).

Returns:String: Description of available relevant location offsets; combination of line number and column position or byte offset
Since: 2.13

sourceDescription back to summary

sourceDescription	back to summary
public String sourceDescription() Accessor for getting a textual description of source reference (Object returned by `getSourceRef()`), as included in description returned by `toString()`. Note implementation will simply call `ContentReference#buildSourceDescription()`) Note not added as a "getter" to prevent it from getting serialized. Returns:String Description of the source reference (see `getSourceRef()` Since 2.9

public String sourceDescription()

Accessor for getting a textual description of source reference (Object returned by getSourceRef()), as included in description returned by toString().

Note

implementation will simply call ContentReference#buildSourceDescription())

Note

not added as a "getter" to prevent it from getting serialized.

Returns:String: Description of the source reference (see getSourceRef()
Since: 2.9

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 JsonLocation

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail