Package de.uniks.networkparser.json

Class JsonArray

java.lang.Object

de.uniks.networkparser.list.AbstractArray<V>

de.uniks.networkparser.list.AbstractList<V>

de.uniks.networkparser.list.SimpleList<V>

de.uniks.networkparser.list.SortedList<java.lang.Object>

de.uniks.networkparser.json.JsonArray

All Implemented Interfaces:

BaseItem, EntityList

Direct Known Subclasses:

JsonArrayLazy

public class JsonArray
extends SortedList<java.lang.Object>
implements EntityList

A JSONArray is an ordered sequence of values. Its external text form is a string wrapped in square brackets with commas separating the values. The internal form is an object having get and opt methods for accessing the values by index, and put methods for adding or replacing values. The values can be any of these types: Boolean, JSONArray, JSONObject, Number, String, or the JSONObject.NULL object.

The constructor can convert a JSON text into a Java object. The toString method converts to JSON text.

The generic get() and opt() methods return an object which you can cast or query for type. There are also typed get and opt methods that do type checking and type coercion for you.

The texts produced by the toString methods strictly conform to JSON syntax rules. The constructors are more forgiving in the texts they will accept:

• An extra , (comma) may appear just before the closing bracket.
• The null value will be inserted when there is , (comma) elision.
• Strings may be quoted with ' (single quote).
• Strings do not need to be quoted at all if they do not begin with a quote or single quote, and if they do not contain leading or trailing spaces, and if they do not contain any of these characters: {} [ ] / \ : , = ; # and if they do not look like numbers and if they are not the reserved words true, false, or null.
• Values can be separated by ; (semicolon) as well as by , (comma).
• Numbers may have the 0x- (hex) prefix.

Field Summary

Fields

Modifier and Type	Field	Description
static char	END
static char	START

Fields inherited from class de.uniks.networkparser.list.AbstractArray

ALLOWDUPLICATE, ALLOWEMPTYVALUE, BIDI, CASESENSITIVE, flag, MAP, READONLY, REMOVED, VISIBLE

Fields inherited from interface de.uniks.networkparser.interfaces.BaseItem

CLASS, CRLF, ENCODING

Fields inherited from class de.uniks.networkparser.list.SimpleList

PROPERTY

Fields inherited from class de.uniks.networkparser.list.SortedList

cpr

Constructor Summary

Constructors

Constructor	Description
JsonArray()	Default Constructor

Method Summary

Modifier and Type	Method	Description
static JsonArray	create(java.lang.String value)
JsonObject	get(java.lang.String id)
JsonArray	getJSONArray(int index)	Get the JSONArray associated with an index.
JsonObject	getJSONObject(int index)	Get the JSONObject associated with an index.
BaseItem	getNewList(boolean keyValue)	Get a new Instance of a JsonObject
java.lang.String	getString(int index)	Get the JSONObject associated with an index.
protected java.lang.String	parseItem(EntityStringConverter converter)	Make a prettyprinted JSON text of this JSONArray.
boolean	remove(java.lang.Object value)
int	sizeChildren()
JsonArray	subList(int fromIndex, int toIndex)	Returns a view of the portion of this list between the specified fromIndex, inclusive, and toIndex, exclusive.
JsonObject	toJSONObject(JsonArray names)	Produce a JSONObject by combining a JSONArray of names with the values of this JSONArray.
java.lang.String	toString()	Make a JSON text of this JSONArray.
JsonArray	withValue(Buffer values)	Set the value to Tokener or pairs of values
JsonArray	withValue(BaseItem... values)	JSONArray from a BaseEntityArray.
JsonArray	withValue(Tokener x)	JSONArray from a JSONTokener.
JsonArray	withValue(java.lang.String value)	JSONArray from a source JSON text.

Methods inherited from class de.uniks.networkparser.list.AbstractArray

add, addHashItem, addKeyValue, checkValue, clear, contains, containsAll, containsAll, first, flag, get, getByIndex, getKeyByIndex, getPositionKey, getTypClass, getValue, hashKey, hasKeyAndPos, indexOf, init, init, init, isAllowDuplicate, isAllowEmptyValue, isCaseSensitive, isEmpty, isReadOnly, isVisible, last, lastIndexOf, move, pack, removeAll, removeByIndex, removeByObject, removeItem, replaceAllValues, reset, reset, retainAll, setAllowEmptyValue, setFlag, setValue, size, toArray, toArray, toString, with, withAllowDuplicate, withAllowEmptyValue, withCaseSensitive, withFlag, without, withSize, withType, withVisible

Methods inherited from class de.uniks.networkparser.list.AbstractList

add, addAll, addAll, ceiling, copyEntity, equals, filter, filterItems, hashCode, iterator, iterator, iteratorReverse, listIterator, listIterator, lower, remove, set, subSet, withList

Methods inherited from interface de.uniks.networkparser.interfaces.BaseItem

add, size, toString

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface de.uniks.networkparser.interfaces.EntityList

comparator, getChild, isComparator, toString

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, of, of, of, of, of, of, of, of, of, of, of, of, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, toArray, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from class de.uniks.networkparser.list.SimpleList

add, clone, fireProperty, withListener

Methods inherited from class de.uniks.networkparser.list.SortedList

comparator, getChild, headSet, higher, isComparator, tailSet, toString, withComparator, withComparator

Field Detail

START

public static final char START

See Also:

Constant Field Values

END

public static final char END

See Also:

Constant Field Values

Constructor Detail

JsonArray

public JsonArray()

Default Constructor

Method Detail

getJSONArray

public JsonArray getJSONArray(int index)

Get the JSONArray associated with an index.

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

A JSONArray value.

sizeChildren

public int sizeChildren()

Specified by:

sizeChildren in interface EntityList

getJSONObject

public JsonObject getJSONObject(int index)

Get the JSONObject associated with an index.

Parameters:

index - subscript

Returns:

A JSONObject value.

Throws:

java.lang.RuntimeException - If there is no value for the index or if the value is not a JSONObject

getString

public java.lang.String getString(int index)

Get the JSONObject associated with an index.

Parameters:

index - subscript

Returns:

A JSONObject value.

Throws:

java.lang.RuntimeException - If there is no value for the index or if the value is not a JSONObject

toJSONObject

public JsonObject toJSONObject(JsonArray names)

Produce a JSONObject by combining a JSONArray of names with the values of this JSONArray.

Parameters:

names - A JSONArray containing a list of key strings. These will be paired with the values.

Returns:

A JSONObject, or null if there are no names or if this JSONArray has no values.

toString

public java.lang.String toString()

Make a JSON text of this JSONArray. For compactness, no unnecessary whitespace is added. If it is not possible to produce a syntactically correct JSON text then null will be returned instead. This could occur if the array contains an invalid number.

Warning: This method assumes that the data structure is acyclical.

Specified by:

toString in interface BaseItem

Overrides:

toString in class AbstractArray<java.lang.Object>

Returns:

a printable, displayable, transmittable representation of the array.

parseItem

protected java.lang.String parseItem(EntityStringConverter converter)

Make a prettyprinted JSON text of this JSONArray.

Overrides:

parseItem in class AbstractArray<java.lang.Object>

Parameters:

converter - Factor for spacing between Level

Returns:

return Item As String

withValue

public JsonArray withValue(java.lang.String value)

JSONArray from a source JSON text.

Parameters:

value - A string that begins with [ (left bracket) and ends with ] (right bracket).

Returns:

Itself

withValue

public JsonArray withValue(Tokener x)

JSONArray from a JSONTokener.

Parameters:

x - A JSONTokener

Returns:

Itself

withValue

public JsonArray withValue(Buffer values)

Set the value to Tokener or pairs of values

Specified by:

withValue in interface EntityList

Parameters:

values - a simple String of Value or pairs of key-values

Returns:

Itself

withValue

public JsonArray withValue(BaseItem... values)

JSONArray from a BaseEntityArray.

Parameters:

values - of Elements.

Returns:

Itself

get

public JsonObject get(java.lang.String id)

getNewList

public BaseItem getNewList(boolean keyValue)

Get a new Instance of a JsonObject

Specified by:

getNewList in interface BaseItem

Overrides:

getNewList in class SimpleList<java.lang.Object>

remove

public boolean remove(java.lang.Object value)

Overrides:

remove in class SimpleList<java.lang.Object>

subList

public JsonArray subList(int fromIndex,
                         int toIndex)

Description copied from class: AbstractArray

Returns a view of the portion of this list between the specified fromIndex, inclusive, and toIndex, exclusive. (If fromIndex and toIndex are equal, the returned list is empty.)

Overrides:

subList in class SimpleList<java.lang.Object>

Parameters:

fromIndex - low endpoint (inclusive) of the subList

toIndex - high endpoint (exclusive) of the subList

Returns:

a view of the specified range within this list

create

public static JsonArray create(java.lang.String value)