Class MetaTable

Table entity class

This class models database tables and manages the collection and table names of columns. You can also support transactions to commit or roll back changes.

Hierarchy (view full)

Implements

Constructors

constructor

Properties

_guid _metaSet _name _type columns rows tableName _NS _PARAM _UNION

Methods

_buildEntity _readEntity _readSchema acceptChanges clear clone copy equal getChanges getObject getTypes getValue instanceOf load merge newRow output read readData readSchema rejectChanges reset select setObject setValue validate write writeData writeSchema transformSchema

Constructors

constructor

  • new MetaTable(name): MetaTable

  • Creates a table entity with a given name.

    Parameters

    • name: string

      Table name.

    Returns MetaTable

Properties

_guid

_guid: string

Unique identifier of the object (GUID). Uniquely identifies the object.

Protected_metaSet

_metaSet: MetaSet

Metaset to which the entity belongs.

_name

_name: string

The name of the element, which acts as a unique identifier for the MetaElement.

_type

_type: Function

The generator function of the object. The function used when the object was created.

columns

columns: MetaTableColumnCollection

Collection of columns in the table.

Readonlyrows

rows: MetaRowCollection

Data (low) collection of entities.

tableName

tableName: string

Indicates the name of the table.

Static Readonly_NS

_NS: string

Indicates the namespace.

Default

'Meta'

Static Readonly_PARAM

_PARAM: []

List of parameters used for the constructor.

Default

['name']

Static Readonly_UNION

_UNION: []

List of implemented interfaces.

Default

[IElement]

Methods

_buildEntity

  • _buildEntity(entity, callback, items): BaseEntity

  • Creates and sets rows for a given entity.

    Parameters

    • entity: BaseEntity

      The entity to be built.

    • callback: Function

      Callback to be called after row generation.

    • items: string[]

      Row name to select, [], or full selection when undefined.

    Returns BaseEntity

    The created entity.

_readEntity

  • _readEntity(entity, option): any

  • Read the entity according to the given option.

    Parameters

    • entity: BaseEntity

      Destination entity.

    • option: number

      Read option.

    Returns any

_readSchema

  • _readSchema(obj, createRow?, origin?): any

  • Reads schema information from a given object.

    Parameters

    • obj: object

      Destination object.

    • OptionalcreateRow: boolean

      Whether to create a column with a row name if there is no column (default: false)

    • Optionalorigin: object

      Original object.

    Returns any

acceptChanges

  • acceptChanges(): void

  • Commit all changes to the current object. Permission to change: commit

    Returns void

clear

  • clear(): void

  • Initializes all data in the entity.

    Returns void

clone

  • clone(): this

  • Creates and returns a deep copy of the current object.

    Returns this

    This is a replica of the current object.

copy

  • copy(filter, cols): this

  • Copy the cols column name after the callback.

    Parameters

    • filter: Function

      The filter function that selects the column.

    • cols: string[]

      List of column names to copy.

    Returns this

    The copied meta table object.

  • copy(...cols): this

  • Copy the cols column name after performing callback.

    Parameters

    • Rest...cols: any[]

      List of column names to copy.

    Returns this

    The copied meta table object.

  • copy(filter): this

  • Copy the target column.

    Parameters

    • filter: string[]

      The filter function that selects the column.

    Returns this

    The copied meta table object.

equal

  • equal(target): boolean

  • Compare the current object with the specified object.

    Parameters

    • target: object

      the object to be compared to.

    Returns boolean

    Returns whether the two objects are the same.

getChanges

  • getChanges(): object[]

  • Returns a list of changes to the current object.

    Returns object[]

    This is a changed list.

getObject

  • getObject(vOpt?, owned?): object

  • Returns objects in serialized form according to specific options. Circular references are replaced by values of '$ref'.

    Parameters

    • OptionalvOpt: number

      Import option. (Default: 0)

      • 0 : Reference structure (_guid: Yes, $ref: Yes)
      • 1: Redundant structure (_guid: Yes, $ref: Yes)
      • 2: Non-tidal rescue (_guid: No, $ref: No)
    • Optionalowned: object | object[]

      Top objects that currently own the object. (Default: {})

    Returns object

    Serialized object.

    Example

    const serializedObject = table.getObject(2);

getTypes

  • getTypes(): Function[]

  • Returns the creators of the current object and all the creators of the prototype chain to the array.

    Returns Function[]

    Returns the array of generator functions.

    Example

    const types = obj.getTypes();
    console.log(types); // [Function: MetaObject]

getValue

  • getValue(): MetaRow

  • Returns the value of the column as a MetaRow type object.

    Returns MetaRow

    The MetaRow object with the value of the column set.

instanceOf

  • instanceOf(target): boolean

  • Verify that the current object is an instance of the specified type (including _UNION)

    Parameters

    • target: string | object

      The type of object to be checked (object or string).

    Returns boolean

    Returns whether it is an instance of the specified type.

load

  • load(obj, parse?): void

  • Gets the given object to the current entity. Initializes existing data and loads new data.

    Parameters

    • obj: string | object

      the object to be imported.

    • Optionalparse: Function

      parser function. (Optional)

    Returns void

merge

  • merge(target, option, matchType?): void

  • Merges the given entity with the current entity.

    Parameters

    • target: BaseEntity

      Destination entity to merge.

    • option: number

      Merge option. (TODO: type definition required)

    • OptionalmatchType: boolean

      Whether or not a row validation exists. (Default: false)

    Returns void

newRow

  • newRow(): MetaRow

  • Creates and returns a new row that matches the column structure.

    Returns MetaRow

    The MetaRow object created.

output

  • output(vOpt, stringify?, space?): string

  • Outputs the current entity as a serialized string.

    Parameters

    • vOpt: number

      Optional. (0, 1, 2)

    • Optionalstringify: Function

      This is a custom parser function. (Optional)

    • Optionalspace: string

      A blank string to use in the output. (Optional)

    Returns string

    Serialized string.

read

  • read(obj, option): void

  • Reads the given object as an entity. Follow JSON schema rules.

    Parameters

    • obj: object

      object to be read.

    • option: number

      Read option. (Default: 3) (TODO: type definition required)

    Returns void

    Example

    var schema1 = { 
       table: { 
    	    columns: {}, 
    	    rows: {} 
      }
    };

    var schema1 = { 
     columns: {...}, 
     rows: {} 
    };

readData

  • readData(obj): void

  • Reads only rows that exist on a given object.

    Parameters

    • obj: object

      The object to be read.

    Returns void

readSchema

  • readSchema(obj, createRow?): void

  • Reads the given schema object as the current entity.

    Parameters

    • obj: object

      Schema object to read.

    • OptionalcreateRow: boolean

      If true, add columns by row[0] (default: false)

    Returns void

rejectChanges

  • rejectChanges(): void

  • Rolls back all changes to the current object. Cancel Changes: rollback

    Returns void

reset

  • reset(): void

  • Initializes the entity's columns and data.

    Returns void

select

  • select(filter): MetaView

  • Query rows according to the given callback function.

    Parameters

    • filter: Function

      A callback function that defines the query conditions.

    Returns MetaView

    This is the searched entity.

  • select(filter, ...cols): MetaView

  • Query rows that meet the given filter conditions.

    Parameters

    • filter: string[]

      Filter conditions.

    • Rest...cols: any[]

      The name of the column to be set for the filter.

    Returns MetaView

    This is the searched entity.

  • select(filter, ...cols): MetaView

  • Query rows that meet the given filter conditions.

    Parameters

    • filter: string[]

      Filter conditions.

    • Rest...cols: any[]

      The name of the column to be set for the filter.

    Returns MetaView

    This is the searched entity.

  • select(...cols): MetaView

  • Enquires rows that match the specified column.

    Parameters

    • Rest...cols: any[]

      column specification.

    Returns MetaView

    This is the searched entity.

setObject

  • setObject(oGuid, origin?): any

  • Reflects a given serialized object to the current object. This action initializes the object.

    Parameters

    • oGuid: object

      Object of the guid type to serialize.

    • Optionalorigin: object

      The source object setting the current object. (Default: oGuid)

    Returns any

setValue

  • setValue(row): void

  • Set the MetaRow value to the value in the column.

    Parameters

    • row: MetaRow

      MetaRow object to set.

    Returns void

validate

  • validate(): boolean

  • Validates the MetaColumn included in the columns collection.

    • Validates the value based on required properties and constructs.

    Returns boolean

    Returns the validation results of the entire column.

write

  • write(vOpt?): object

  • Returns the current entity by converting it to an object of schema type.

    Parameters

    • OptionalvOpt: number

      Optional. (Default: 0)

    Returns object

    The object of the schema type.

writeData

  • writeData(vOpt?): object

  • Returns data from the current entity by converting it to an object of schema type.

    Parameters

    • OptionalvOpt: number

      Optional. (Default: 0)

    Returns object

    The object of the schema type.

writeSchema

  • writeSchema(vOpt?): object

  • Returns the schema of the current entity by converting it to an object of schema type.

    Parameters

    • OptionalvOpt: number

      Optional. (Default: 0)

    Returns object

    The object of the schema type.

StatictransformSchema

  • transformSchema(oGuid): object

  • Converts a given serialization object to a schema object.

    Parameters

    • oGuid: object

      object obtained from getObject().

    Returns object

    The transformed schema object.

Settings

Member Visibility

On This Page

Constructors
Properties
Methods