You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
84 lines
3.3 KiB
84 lines
3.3 KiB
4 years ago
|
/**
|
||
|
|
* JSON is an open standard file format, and data interchange format,
|
||
|
|
* that uses human-readable text to store and transmit data objects
|
||
|
|
* consisting of name–value pairs and array data types.
|
||
|
|
* For more information refer to https://en.wikipedia.org/wiki/JSON
|
||
|
|
* This is a base class for implementation of JSON data storage for Acedia.
|
||
|
|
* It does not implement parsing and printing from/into human-readable
|
||
|
|
* text representation, just provides means to store such information.
|
||
|
|
*
|
||
|
|
* JSON data is stored as an object (represented via `JSONObject`) that
|
||
|
|
* contains a set of name-value pairs, where value can be
|
||
|
|
* a number, string, boolean value, another object or
|
||
|
|
* an array (represented by `JSONArray`).
|
||
|
|
* Copyright 2020 Anton Tarasenko
|
||
|
|
*------------------------------------------------------------------------------
|
||
|
|
* This file is part of Acedia.
|
||
|
|
*
|
||
|
|
* Acedia is free software: you can redistribute it and/or modify
|
||
|
|
* it under the terms of the GNU General Public License as published by
|
||
|
|
* the Free Software Foundation, version 3 of the License, or
|
||
|
|
* (at your option) any later version.
|
||
|
|
*
|
||
|
|
* Acedia is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
* GNU General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU General Public License
|
||
|
|
* along with Acedia. If not, see <https://www.gnu.org/licenses/>.
|
||
|
|
*/
|
||
|
|
class JSON extends AcediaActor
|
||
|
|
abstract;
|
||
|
|
|
||
|
|
// Enumeration for possible types of JSON values.
|
||
|
|
enum JType
|
||
|
|
{
|
||
|
|
// Technical type, used to indicate that requested value is missing.
|
||
|
|
// Undefined values are not part of JSON format.
|
||
|
|
JSON_Undefined,
|
||
|
|
// An empty value, in teste representation defined by a single word "null".
|
||
|
|
JSON_Null,
|
||
|
|
// A number, recorded as a float.
|
||
|
|
// JSON itself doesn't specify whether number is an integer or float.
|
||
|
|
JSON_Number,
|
||
|
|
// A string.
|
||
|
|
JSON_String,
|
||
|
|
// A bool value.
|
||
|
|
JSON_Boolean,
|
||
|
|
// Array of other JSON values, stored without names;
|
||
|
|
// Single array can contain any mix of value types.
|
||
|
|
JSON_Array,
|
||
|
|
// Another JSON object, i.e. associative array of name-value pairs
|
||
|
|
JSON_Object
|
||
|
|
};
|
||
|
|
|
||
|
|
// Stores a single JSON value
|
||
|
|
struct JStorageAtom
|
||
|
|
{
|
||
|
|
// What type is stored exactly?
|
||
|
|
// Depending on that, uses one of the other fields as a storage.
|
||
|
|
var protected JType type;
|
||
|
|
var protected float numberValue;
|
||
|
|
var protected string stringValue;
|
||
|
|
var protected bool booleanValue;
|
||
|
|
// Used for storing both JSON objects and arrays.
|
||
|
|
var protected JSON complexValue;
|
||
|
|
};
|
||
|
|
|
||
|
|
// TODO: Rewrite JSON object to use more efficient storage data structures
|
||
|
|
// that will support subtypes:
|
||
|
|
// ~ Number: byte, int, float
|
||
|
|
// ~ String: string, class
|
||
|
|
// (maybe move to auto generated code?).
|
||
|
|
// TODO: Add cleanup queue to efficiently and without crashes clean up
|
||
|
|
// removed objects.
|
||
|
|
// TODO: Add `JValue` - a reference type for number / string / boolean / null
|
||
|
|
// TODO: Add accessors for last values.
|
||
|
|
// TODO: Add path-getters.
|
||
|
|
// TODO: Add iterators.
|
||
|
|
// TODO: Add parsing/printing.
|
||
|
|
// TODO: Add functions for deep copy.
|
||
|
|
defaultproperties
|
||
|
|
{
|
||
|
|
}
|