public abstract class JsonStreamContext
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
int |
getCurrentIndex() |
abstract java.lang.String |
getCurrentName()
Method for accessing name associated with the current location.
|
java.lang.Object |
getCurrentValue()
Method for accessing currently active value being used by data-binding
(as the source of streaming data to write, or destination of data being
read), at this level in hierarchy.
|
int |
getEntryCount() |
abstract JsonStreamContext |
getParent()
Accessor for finding parent context of this context; will
return null for root context.
|
JsonLocation |
getStartLocation(java.lang.Object srcRef)
Optional method that may be used to access starting location of this context:
for example, in case of JSON `Object` context, offset at which `[` token was
read or written.
|
java.lang.String |
getTypeDesc()
Deprecated.
Since 2.8 use
typeDesc() instead |
boolean |
hasCurrentIndex()
Method that may be called to verify whether this context has valid index:
will return `false` before the first entry of Object context or before
first element of Array context; otherwise returns `true`.
|
boolean |
hasCurrentName() |
boolean |
hasPathSegment()
Method that may be called to check if this context is either:
Object, with at least one entry written (partially or completely)
Array, with at least one entry written (partially or completely)
and if so, return `true`; otherwise return `false`.
|
boolean |
inArray()
Method that returns true if this context is an Array context;
that is, content is being read from or written to a Json Array.
|
boolean |
inObject()
Method that returns true if this context is an Object context;
that is, content is being read from or written to a Json Object.
|
boolean |
inRoot()
Method that returns true if this context is a Root context;
that is, content is being read from or written to without
enclosing array or object structure.
|
JsonPointer |
pathAsPointer()
Factory method for constructing a
JsonPointer that points to the current
location within the stream that this context is for, excluding information about
"root context" (only relevant for multi-root-value cases) |
JsonPointer |
pathAsPointer(boolean includeRoot)
Factory method for constructing a
JsonPointer that points to the current
location within the stream that this context is for, optionally including
"root value index" |
void |
setCurrentValue(java.lang.Object v)
Method to call to pass value to be returned via
getCurrentValue() ; typically
called indirectly through JsonParser.setCurrentValue(java.lang.Object)
or JsonGenerator.setCurrentValue(java.lang.Object) ). |
java.lang.String |
toString()
Overridden to provide developer readable "JsonPath" representation
of the context.
|
java.lang.String |
typeDesc() |
public abstract JsonStreamContext getParent()
public final boolean inArray()
public final boolean inRoot()
public final boolean inObject()
@Deprecated public final java.lang.String getTypeDesc()
typeDesc()
insteadpublic java.lang.String typeDesc()
public final int getEntryCount()
public final int getCurrentIndex()
public boolean hasCurrentIndex()
public boolean hasPathSegment()
Method is mostly used to determine whether this context should be used for
constructing JsonPointer
public abstract java.lang.String getCurrentName()
FIELD_NAME
and value events that directly
follow field names; null for root level and array values.public boolean hasCurrentName()
public java.lang.Object getCurrentValue()
Note that "current value" is NOT populated (or used) by Streaming parser or generator; it is only used by higher-level data-binding functionality. The reason it is included here is that it can be stored and accessed hierarchically, and gets passed through data-binding.
public void setCurrentValue(java.lang.Object v)
getCurrentValue()
; typically
called indirectly through JsonParser.setCurrentValue(java.lang.Object)
or JsonGenerator.setCurrentValue(java.lang.Object)
).public JsonPointer pathAsPointer()
JsonPointer
that points to the current
location within the stream that this context is for, excluding information about
"root context" (only relevant for multi-root-value cases)public JsonPointer pathAsPointer(boolean includeRoot)
JsonPointer
that points to the current
location within the stream that this context is for, optionally including
"root value index"includeRoot
- Whether root-value offset is included as the first segment or not;public JsonLocation getStartLocation(java.lang.Object srcRef)
JsonLocation.NA
; this is what the default implementation does.
NOTE: demoted from JsonReadContext
in 2.9, to allow use for
"non-standard" read contexts.
public java.lang.String toString()
toString
in class java.lang.Object
Copyright © 2010 - 2020 Adobe. All Rights Reserved