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, java.lang.Cloneable, java.lang.Iterable<java.lang.Object>, java.util.Collection<java.lang.Object>, java.util.List<java.lang.Object>

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 inherited from class de.uniks.networkparser.list.SortedList

cpr

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

CRLF

Constructor Summary

Constructors

Constructor and Description
JsonArray()

Method Summary

Modifier and Type	Method and Description
JsonObject	get(java.lang.String id)
SimpleList<EntityList>	getChildren()
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)
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.
java.lang.String	toString(int indentFactor) Make a prettyprinted JSON text of this JSONArray.
JsonArray	withValue(BaseItem... values) JSONArray from a BaseEntityArray.
JsonArray	withValue(Buffer values) Set the value to Tokener or pairs of values
JsonArray	withValue(java.lang.String value) JSONArray from a source JSON text.
JsonArray	withValue(Tokener x) JSONArray from a JSONTokener.

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

comparator, headSet, higher, isComparator, tailSet, withComparator, withComparator

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

clone, filter, with

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

add, add, addAll, addAll, ceiling, copyEntity, filterItems, iteratorReverse, listIterator, listIterator, remove, set, subSet, withList

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

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

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

comparator, isComparator, size

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

toString, with

Methods inherited from interface java.util.List

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

JsonArray

public JsonArray()

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.

Throws:

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

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.

toString

public java.lang.String toString(int indentFactor)

Make a prettyprinted JSON text of this JSONArray. Warning: This method assumes that the data structure is acyclical.

Specified by:

toString in interface EntityList

Parameters:

indentFactor - The number of spaces to add to each level of indentation.

Returns:

a printable, displayable, transmittable representation of the object, beginning with [ (left bracket) and ending with ] (right bracket).

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)

Specified by:

remove in interface java.util.Collection<java.lang.Object>

Specified by:

remove in interface java.util.List<java.lang.Object>

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.)

Specified by:

subList in interface java.util.List<java.lang.Object>

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

getChildren

public SimpleList<EntityList> getChildren()

Specified by:

getChildren in interface EntityList