AnyValueMap | pip-services3-commons-node

Cross-language implementation of dynamic object map (dictionary) what can hold values of any type. The stored values can be converted to different types using variety of accessor methods.

Example

let value1 = new AnyValueMap({ key1: 1, key2: "123.456", key3: "2018-01-01" });

value1.getAsBoolean("key1");   // Result: true
value1.getAsInteger("key2");   // Result: 123
value1.getAsFloat("key2");     // Result: 123.456
value1.getAsDateTime("key3");  // Result: new Date(2018,0,1)

see: StringConverter
see: TypeConverter
see: BooleanConverter
see: IntegerConverter
see: LongConverter
see: DoubleConverter
see: FloatConverter
see: DateTimeConverter
see: ICloneable

Hierarchy

AnyValueMap
- Parameters

Implements

ICloneable

Index

Constructors

constructor

Methods

Constructors

constructor

new AnyValueMap(values?: any): AnyValueMap

- Defined in data/AnyValueMap.ts:42
Creates a new instance of the map and assigns its value.

Parameters
- Default value values: any = null
Returns AnyValueMap

Methods

append

append(map: any): void

- Defined in data/AnyValueMap.ts:104
Appends new elements to this map.

Parameters
- map: any
  
  a map with elements to be added.
Returns void

clear

clear(): any

- Defined in data/AnyValueMap.ts:117
Clears this map by removing all its elements.

Returns any

clone

clone(): any

Implementation of ICloneable.clone
- Defined in data/AnyValueMap.ts:630
Creates a binary clone of this object.

Returns any

a clone of this object.

get

get(key: string): any

- Defined in data/AnyValueMap.ts:59
Gets a map element specified by its key.

Parameters
- key: string
  
  a key of the element to get.
Returns any

the value of the map element.

getAsArray

getAsArray(key: string): AnyValueArray

- Defined in data/AnyValueMap.ts:537
Converts map element into an AnyValueArray or returns empty AnyValueArray if conversion is not possible.

see

AnyValueArray

see

AnyValueArray.fromValue

Parameters
- key: string
  
  a key of element to get.
Returns AnyValueArray

AnyValueArray value of the element or empty AnyValueArray if conversion is not supported.

getAsArrayWithDefault

getAsArrayWithDefault(key: string, defaultValue: AnyValueArray): AnyValueArray

- Defined in data/AnyValueMap.ts:552
Converts map element into an AnyValueArray or returns default value if conversion is not possible.

see

AnyValueArray

see

getAsNullableArray

Parameters
- key: string
  
  a key of element to get.
- defaultValue: AnyValueArray
  
  the default value
Returns AnyValueArray

AnyValueArray value of the element or default value if conversion is not supported.

getAsBoolean

getAsBoolean(key: string): boolean

- Defined in data/AnyValueMap.ts:242
Converts map element into a boolean or returns false if conversion is not possible.

see

getAsBooleanWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns boolean

boolean value of the element or false if conversion is not supported.

getAsBooleanWithDefault

getAsBooleanWithDefault(key: string, defaultValue: boolean): boolean

- Defined in data/AnyValueMap.ts:255
Converts map element into a boolean or returns default value if conversion is not possible.

see

BooleanConverter.toBooleanWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: boolean
  
  the default value
Returns boolean

boolean value of the element or default value if conversion is not supported.

getAsDateTime

getAsDateTime(key: string): Date

- Defined in data/AnyValueMap.ts:437
Converts map element into a Date or returns the current date if conversion is not possible.

see

getAsDateTimeWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns Date

Date value of the element or the current date if conversion is not supported.

getAsDateTimeWithDefault

getAsDateTimeWithDefault(key: string, defaultValue: Date): Date

- Defined in data/AnyValueMap.ts:450
Converts map element into a Date or returns default value if conversion is not possible.

see

DateTimeConverter.toDateTimeWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: Date
  
  the default value
Returns Date

Date value of the element or default value if conversion is not supported.

getAsDouble

getAsDouble(key: string): number

- Defined in data/AnyValueMap.ts:398
Converts map element into a double or returns 0 if conversion is not possible.

see

getAsDoubleWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns number

double value of the element or 0 if conversion is not supported.

getAsDoubleWithDefault

getAsDoubleWithDefault(key: string, defaultValue: number): number

- Defined in data/AnyValueMap.ts:411
Converts map element into a double or returns default value if conversion is not possible.

see

DoubleConverter.toDoubleWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: number
  
  the default value
Returns number

double value of the element or default value if conversion is not supported.

getAsFloat

getAsFloat(key: string): number

- Defined in data/AnyValueMap.ts:359
Converts map element into a float or returns 0 if conversion is not possible.

see

getAsFloatWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns number

float value of the element or 0 if conversion is not supported.

getAsFloatWithDefault

getAsFloatWithDefault(key: string, defaultValue: number): number

- Defined in data/AnyValueMap.ts:372
Converts map element into a flot or returns default value if conversion is not possible.

see

FloatConverter.toFloatWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: number
  
  the default value
Returns number

flot value of the element or default value if conversion is not supported.

getAsInteger

getAsInteger(key: string): number

- Defined in data/AnyValueMap.ts:281
Converts map element into an integer or returns 0 if conversion is not possible.

see

getAsIntegerWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns number

integer value of the element or 0 if conversion is not supported.

getAsIntegerWithDefault

getAsIntegerWithDefault(key: string, defaultValue: number): number

- Defined in data/AnyValueMap.ts:294
Converts map element into an integer or returns default value if conversion is not possible.

see

IntegerConverter.toIntegerWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: number
  
  the default value
Returns number

integer value of the element or default value if conversion is not supported.

getAsLong

getAsLong(key: string): number

- Defined in data/AnyValueMap.ts:320
Converts map element into a long or returns 0 if conversion is not possible.

see

getAsLongWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns number

long value of the element or 0 if conversion is not supported.

getAsLongWithDefault

getAsLongWithDefault(key: string, defaultValue: number): number

- Defined in data/AnyValueMap.ts:333
Converts map element into a long or returns default value if conversion is not possible.

see

LongConverter.toLongWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: number
  
  the default value
Returns number

long value of the element or default value if conversion is not supported.

getAsMap

getAsMap(key: string): AnyValueMap

- Defined in data/AnyValueMap.ts:578
Converts map element into an AnyValueMap or returns empty AnyValueMap if conversion is not possible.

see

fromValue

Parameters
- key: string
  
  a key of element to get.
Returns AnyValueMap

AnyValueMap value of the element or empty AnyValueMap if conversion is not supported.

getAsMapWithDefault

getAsMapWithDefault(key: string, defaultValue: AnyValueMap): AnyValueMap

- Defined in data/AnyValueMap.ts:592
Converts map element into an AnyValueMap or returns default value if conversion is not possible.

see

getAsNullableMap

Parameters
- key: string
  
  a key of element to get.
- defaultValue: AnyValueMap
  
  the default value
Returns AnyValueMap

AnyValueMap value of the element or default value if conversion is not supported.

getAsNullableArray

getAsNullableArray(key: string): AnyValueArray

- Defined in data/AnyValueMap.ts:523
Converts map element into an AnyValueArray or returns null if conversion is not possible.

see

AnyValueArray

see

AnyValueArray.fromValue

Parameters
- key: string
  
  a key of element to get.
Returns AnyValueArray

AnyValueArray value of the element or null if conversion is not supported.

getAsNullableBoolean

getAsNullableBoolean(key: string): boolean

- Defined in data/AnyValueMap.ts:229
Converts map element into a boolean or returns null if conversion is not possible.

see

BooleanConverter.toNullableBoolean

Parameters
- key: string
  
  a key of element to get.
Returns boolean

boolean value of the element or null if conversion is not supported.

getAsNullableDateTime

getAsNullableDateTime(key: string): Date

- Defined in data/AnyValueMap.ts:424
Converts map element into a Date or returns null if conversion is not possible.

see

DateTimeConverter.toNullableDateTime

Parameters
- key: string
  
  a key of element to get.
Returns Date

Date value of the element or null if conversion is not supported.

getAsNullableDouble

getAsNullableDouble(key: string): number

- Defined in data/AnyValueMap.ts:385
Converts map element into a double or returns null if conversion is not possible.

see

DoubleConverter.toNullableDouble

Parameters
- key: string
  
  a key of element to get.
Returns number

double value of the element or null if conversion is not supported.

getAsNullableFloat

getAsNullableFloat(key: string): number

- Defined in data/AnyValueMap.ts:346
Converts map element into a float or returns null if conversion is not possible.

see

FloatConverter.toNullableFloat

Parameters
- key: string
  
  a key of element to get.
Returns number

float value of the element or null if conversion is not supported.

getAsNullableInteger

getAsNullableInteger(key: string): number

- Defined in data/AnyValueMap.ts:268
Converts map element into an integer or returns null if conversion is not possible.

see

IntegerConverter.toNullableInteger

Parameters
- key: string
  
  a key of element to get.
Returns number

integer value of the element or null if conversion is not supported.

getAsNullableLong

getAsNullableLong(key: string): number

- Defined in data/AnyValueMap.ts:307
Converts map element into a long or returns null if conversion is not possible.

see

LongConverter.toNullableLong

Parameters
- key: string
  
  a key of element to get.
Returns number

long value of the element or null if conversion is not supported.

getAsNullableMap

getAsNullableMap(key: string): AnyValueMap

- Defined in data/AnyValueMap.ts:565
Converts map element into an AnyValueMap or returns null if conversion is not possible.

see

fromValue

Parameters
- key: string
  
  a key of element to get.
Returns AnyValueMap

AnyValueMap value of the element or null if conversion is not supported.

getAsNullableString

getAsNullableString(key: string): string

- Defined in data/AnyValueMap.ts:190
Converts map element into a string or returns null if conversion is not possible.

see

StringConverter.toNullableString

Parameters
- key: string
  
  a key of element to get.
Returns string

string value of the element or null if conversion is not supported.

getAsNullableType

getAsNullableType<T>(type: TypeCode, key: string): T

- Defined in data/AnyValueMap.ts:465
Converts map element into a value defined by specied typecode. If conversion is not possible it returns null.

see

TypeConverter.toNullableType

Type parameters
- T
Parameters
- type: TypeCode
  
  the TypeCode that defined the type of the result
- key: string
  
  a key of element to get.
Returns T

element value defined by the typecode or null if conversion is not supported.

getAsObject

getAsObject(key?: string): any

- Defined in data/AnyValueMap.ts:147
Gets the value stored in map element without any conversions. When element key is not defined it returns the entire map value.

Parameters
- Default value key: string = undefined
  
  (optional) a key of the element to get
Returns any

the element value or value of the map when index is not defined.

getAsString

getAsString(key: string): string

- Defined in data/AnyValueMap.ts:203
Converts map element into a string or returns "" if conversion is not possible.

see

getAsStringWithDefault

Parameters
- key: string
  
  a key of element to get.
Returns string

string value of the element or "" if conversion is not supported.

getAsStringWithDefault

getAsStringWithDefault(key: string, defaultValue: string): string

- Defined in data/AnyValueMap.ts:216
Converts map element into a string or returns default value if conversion is not possible.

see

StringConverter.toStringWithDefault

Parameters
- key: string
  
  a key of element to get.
- defaultValue: string
  
  the default value
Returns string

string value of the element or default value if conversion is not supported.

getAsType

getAsType<T>(type: TypeCode, key: string): T

- Defined in data/AnyValueMap.ts:480
Converts map element into a value defined by specied typecode. If conversion is not possible it returns default value for the specified type.

see

getAsTypeWithDefault

Type parameters
- T
Parameters
- type: TypeCode
  
  the TypeCode that defined the type of the result
- key: string
  
  a key of element to get.
Returns T

element value defined by the typecode or default if conversion is not supported.

getAsTypeWithDefault

getAsTypeWithDefault<T>(type: TypeCode, key: string, defaultValue: T): T

- Defined in data/AnyValueMap.ts:495
Converts map element into a value defined by specied typecode. If conversion is not possible it returns default value.

see

TypeConverter.toTypeWithDefault

Type parameters
- T
Parameters
- type: TypeCode
  
  the TypeCode that defined the type of the result
- key: string
  
  a key of element to get.
- defaultValue: T
  
  the default value
Returns T

element value defined by the typecode or default value if conversion is not supported.

getAsValue

getAsValue(key: string): AnyValue

- Defined in data/AnyValueMap.ts:509
Converts map element into an AnyValue or returns an empty AnyValue if conversion is not possible.

see

AnyValue

see

AnyValue.constructor

Parameters
- key: string
  
  a key of element to get.
Returns AnyValue

AnyValue value of the element or empty AnyValue if conversion is not supported.

getKeys

getKeys(): string[]

- Defined in data/AnyValueMap.ts:68
Gets keys of all elements stored in this map.

Returns string[]

a list with all map keys.

length

length(): number

- Defined in data/AnyValueMap.ts:130
Gets a number of elements stored in this map.

Returns number

the number of elements in this map.

put

put(key: string, value: any): any

- Defined in data/AnyValueMap.ts:86
Puts a new value into map element specified by its key.

Parameters
- key: string
  
  a key of the element to put.
- value: any
  
  a new value for map element.
Returns any

remove

remove(key: string): void

- Defined in data/AnyValueMap.ts:95
Removes a map element specified by its key

Parameters
- key: string
  
  a key of the element to remove.
Returns void

setAsObject

setAsObject(key: any, value?: any): void

- Defined in data/AnyValueMap.ts:171
Sets a new value to map element specified by its index. When the index is not defined, it resets the entire map value. This method has double purpose because method overrides are not supported in JavaScript.

see

MapConverter.toMap

Parameters
- key: any
  
  (optional) a key of the element to set
- Default value value: any = undefined
  
  a new element or map value.
Returns void

toString

toString(): string

- Defined in data/AnyValueMap.ts:604
Gets a string representation of the object. The result is a semicolon-separated list of key-value pairs as "key1=value1;key2=value2;key=value3"

Returns string

a string representation of the object.

Static fromMaps

fromMaps(...maps: any[]): AnyValueMap

- Defined in data/AnyValueMap.ts:691
Creates a new AnyValueMap by merging two or more maps. Maps defined later in the list override values from previously defined maps.

Parameters
- Rest ...maps: any[]
  
  an array of maps to be merged
Returns AnyValueMap

a newly created AnyValueMap.

Static fromTuples

fromTuples(...tuples: any[]): AnyValueMap

- Defined in data/AnyValueMap.ts:656
Creates a new AnyValueMap from a list of key-value pairs called tuples.

see

fromTuplesArray

Parameters
- Rest ...tuples: any[]
  
  a list of values where odd elements are keys and the following even elements are values
Returns AnyValueMap

a newly created AnyValueArray.

Static fromTuplesArray

fromTuplesArray(tuples: any[]): AnyValueMap

- Defined in data/AnyValueMap.ts:667
Creates a new AnyValueMap from a list of key-value pairs called tuples. The method is similar to fromTuples but tuples are passed as array instead of parameters.

Parameters
- tuples: any[]
  
  a list of values where odd elements are keys and the following even elements are values
Returns AnyValueMap

a newly created AnyValueArray.

Static fromValue

fromValue(value: any): AnyValueMap

- Defined in data/AnyValueMap.ts:642
Converts specified value into AnyValueMap.

see

setAsObject

Parameters
- value: any
  
  value to be converted
Returns AnyValueMap

a newly created AnyValueMap.

Example

Hierarchy

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Default value values: any = null

Returns AnyValueMap

Methods

append

Parameters

map: any

Returns void

clear

Returns any

clone

Returns any

get

Parameters

key: string

Returns any

getAsArray

Parameters

key: string

Returns AnyValueArray

getAsArrayWithDefault

Parameters

key: string

defaultValue: AnyValueArray

Returns AnyValueArray

getAsBoolean

Parameters

key: string

Returns boolean

getAsBooleanWithDefault

Parameters

key: string

defaultValue: boolean

Returns boolean

getAsDateTime

Parameters

key: string

Returns Date

getAsDateTimeWithDefault

Parameters

key: string

defaultValue: Date

Returns Date

getAsDouble

Parameters

key: string

Returns number

getAsDoubleWithDefault

Parameters

key: string

defaultValue: number

Returns number

getAsFloat

Parameters

key: string

Returns number

getAsFloatWithDefault

Parameters

key: string

defaultValue: number

Returns number

getAsInteger

Parameters

key: string

Returns number

getAsIntegerWithDefault

Parameters

key: string

defaultValue: number

Returns number

getAsLong

Parameters