84 lines
3.3 KiB
Ucode
84 lines
3.3 KiB
Ucode
/**
|
||
* 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
|
||
{
|
||
} |