Reference Source
public class | source

Instance

Extends:

LoggableErrorableSettingsableStateable → Instance

Devapt base class for resources, servers, Collection items...

Constructor Summary

Public Constructor
public

constructor(arg_collection: string, arg_class: string, arg_name: string, arg_settings: Immutable.Map | object, arg_log_context: string, arg_logger_manager: LoggerManager): nothing

Create an instance.

Member Summary

Public Members
public

Instance class name.

public

Instance id.

public

Instance name.

public

Instance collection name.

public

Class type flag.

public

Instance is loaded flag.

Method Summary

Public Methods
public

Get instance class.

public

Get instance description: {$type:..., $class:..., $id:..., $name:...}.

public

Get instance description string: $type:..., $class:..., $id:..., $name:....

public

Get instance unique id.

public

Get instance unique name.

public

Get instance type.

public

Test if this code run inside a browser.

public

Test if this code run on a browser.

public abstract

load(): nothing

Load instance settings.

Inherited Summary

From class Loggable
public

Log context.

public

Class type flag.

public

Trace is enabled for this flag.

private

Logger manager instance (default undefined)

public

debug(args: string | array): nothing

Trace DEBUG formatted message.

public

disable_trace(): nothing

Disable traces.

public

enable_trace(): nothing

Enable traces.

public

enter_group(arg_group: string): nothing

Trace INFO message on "enter trace group".

public

error(args: string | array): nothing

Trace ERROR formatted message.

public

Define get class name method for non Instance classes.

public

Get instance context.

public

Get logger manager.

public

Define get instance name method for non Instance classes.

public

Get trace flag.

public

info(args: string | array): nothing

Trace INFO formatted message.

public

leave_group(arg_group: string): nothing

Trace INFO message on "leave trace group".

public

separate_level_1(): nothing

Trace INFO trace level 1 separator.

public

separate_level_2(): nothing

Trace INFO trace level 2 separator.

public

separate_level_3(): nothing

Trace INFO trace level 3 separator.

public

set_trace(arg_value: boolean): nothing

Set trace flag.

public

should_trace(arg_traces_cfg: object): boolean

Calculate should trace flag.

public

should_trace_class(arg_traces_cfg: object): boolean

Calculate should trace flag for classes.

public

should_trace_collection_item(arg_traces_cfg: object, arg_collection_name: string, arg_this_item_accessor: string): boolean

Calculate should trace flag for given collection of names or patterns.

public

should_trace_module(arg_traces_cfg: object): boolean

Calculate should trace flag for modules.

public

should_trace_name(arg_traces_cfg: object): boolean

Calculate should trace flag for instances names.

public

Toggle trace flag.

public

Update trace enabled flag.

public

warn(args: string | array): nothing

Trace WARN formatted message.

From class Errorable
private

Error text (default null).

private

Has error flag (default false).

public

error(arg_msg: string): nothing

Set an error.

public

Default helper for "not implemented" error.

public

Get error message.

public

Test is an error is set.

From class Settingsable
public

$settings: object | Immutable.Map

Instance settings (default undefined).

public

Class type flag.

public

get_setting(arg_name: string | array, arg_default: any): any

Get a value in settings for given key.

public

get_setting_js(arg_name: string | array, arg_default: any): any

Get a value in settings for given key.

public

get_settings(): Immutable.Map

Get instance settings.

public

get_settings_js(): Immutable.Map

Get instance settings.

public

has_setting(arg_name: string): boolean

Test if a key exists in settings.

public

set_setting(arg_name: string, arg_value: any): nothing

Set a value in settings for given key.

public

set_settings(arg_settings: Immutable.Map): nothing

Set instance settings.

From class Stateable
public

Class type flag.

public

state_path: array

State path in runtime state.

private

Initial state.

private

_runtime: Runtime

Runtime isntance.

private

State store.

private

State changes handlers.

public

dispatch_action(arg_action_type: string | object, arg_options: object | undefined): nothing

Dispatch a state action.

public

get_initial_state(): Immutable.Map

Get initial state, an immutable object from a Redux data store.

public

Get name.

public

Get runtime instance.

public

get_state(): Immutable.Map

Get current state, an immutable object from a Redux data store.

public

Get current state, an immutable object from a Redux data store.

public

get_state_path(): array

Get state path into a Redux data store.

public

Get state store.

public

get_state_value(arg_key_or_path: string | array, arg_default_value: any): any

Get a state entry.

public

handle_state_change(arg_previous_state: Immutable.Map, arg_new_state: Immutable.Map): nothing

Handle component state changes.

public

register_state_value_change_handle(arg_path: string | array, arg_listener: string | function): nothing

Register a state value change listener.

Public Constructors

public constructor(arg_collection: string, arg_class: string, arg_name: string, arg_settings: Immutable.Map | object, arg_log_context: string, arg_logger_manager: LoggerManager): nothing source

Create an instance.

Override:

Stateable#constructor

Params:

NameTypeAttributeDescription
arg_collection string

collection name.

arg_class string

class name.

arg_name string

instance name.

arg_settings Immutable.Map | object

settings plain object

arg_log_context string

log context.

arg_logger_manager LoggerManager

logger manager object (optional).

Return:

nothing

Public Members

public $class: string source

Instance class name.

public $id: string source

Instance id.

public $name: string source

Instance name.

public $type: string source

Instance collection name.

public is_instance: boolean source

Class type flag.

public is_loaded: boolean source

Instance is loaded flag.

Public Methods

public get_class(): string source

Get instance class.

Override:

Loggable#get_class

Return:

string

public get_descriptor(): object source

Get instance description: {$type:..., $class:..., $id:..., $name:...}.

Return:

object

instance object description

public get_descriptor_string(): string source

Get instance description string: $type:..., $class:..., $id:..., $name:....

Return:

string

instance object description

public get_id(): string source

Get instance unique id.

Return:

string

public get_name(): string source

Get instance unique name.

Override:

Stateable#get_name

Return:

string

public get_type(): string source

Get instance type.

Return:

string

public is_browser(): boolean source

Test if this code run inside a browser.

Return:

boolean

public is_server(): boolean source

Test if this code run on a browser.

Return:

boolean

public abstract load(): nothing source

Load instance settings.

Return:

nothing