Dynamic Data Types
Key takeaways
AnyValue | Dynamic object that can hold a value of any type. |
AnyValueArray | Dynamic array that can hold values of any type. |
AnyValueMap | Dynamic map (dictionary) object that can hold values of any type. |
Introduction
This tutorial explains how to use the three dynamic data types available in Pip.Services. They are AnyValue, AnyValueArray and AnyValueMap, which define dynamic types for single values (variables), arrays, and maps respectively. These types can hold any type of data, which can then be converted to several well-known formats such as integer, float, and more. This tutorial explains each of these classes and their methods through examples.
Dynamic data types
Pip.Services provides three different dynamic data types. They are AnyValue, AnyValueArray and AnyValueMap. This section explains each of them with examples.
AnyValue
This component provides a cross-language implementation of a dynamic object that can hold a value of any type. For example, it can contain an integer, a float, or a string.
// Examples
let value1 = new AnyValue(1);
let value2 = new AnyValue(123.456);
let value3 = new AnyValue("123.456");
// Examples
value1 := data.NewAnyValue(1)
value2 := data.NewAnyValue(123.456)
value3 := data.NewAnyValue("123.456")
value1 = AnyValue(1)
value2 = AnyValue(123.456)
value3 = AnyValue("123.456")
Pre-requisites
In order to create an AnyValue object, we need to import the corresponding class. The code below shows how to do this.
import { AnyValue } from "pip-services4-commons-node"
import (
data "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/data"
)
from pip_services4_commons.data import AnyValue
Create
To create an AnyValue object we need to use its constructor with the value as input parameter or clone an existing AnyValue object. The following examples show how to do this.
// Constructor
let value = new AnyValue("123.456");
// Cloning
let value2 = value.clone(); // Returns an object of type AnyValue with value 123.456
// Constructor
value := data.NewAnyValue("123.456")
// Cloning
value2 := value.Clone() // Returns an object of type AnyValue with value 123.456
# Constructor
value1 = AnyValue("123.456")
# Cloning
value2 = value1.clone() # Returns an object of type AnyValue with value 123.456
Conversion
This component presents several methods that can be used to convert a value to different types, such as integer, long, float, double, and more. The examples below show how to use several of these methods.
import { AnyValue } from "pip-services4-commons-node"
let value = new AnyValue("123.456");
let value1 = value.getAsInteger(); // Returns 123
let value2 = value.getAsLong(); // Returns 123
let value3 = value.getAsFloat(); // Returns 123.456
let valueB = new AnyValue("ABC");
let value4 = valueB.getAsIntegerWithDefault(25); // Returns 25
let value5 = value.getAsString(); // Returns '123.456'
let value6 = value.getAsStringWithDefault("ABC"); // Returns '123.456'
valueB = new AnyValue("1");
let value7 = valueB.getAsBoolean(); // Returns True
let valueC = new AnyValue("abc");
let value8 = valueC.getAsBooleanWithDefault(false); // Returns False
let type1 = value.getTypeCode(); // Returns 1 (TypeCode.String)
import (
"fmt"
data "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/data"
)
func main() {
value := data.NewAnyValue("123.456")
value1 := value.GetAsInteger() // Returns 123
value2 := value.GetAsLong() // Returns 123
value3 := value.GetAsFloat() // Returns 123.456
valueB := data.NewAnyValue("ABC")
value4 := valueB.GetAsIntegerWithDefault(25) // Returns 25
value5 := value.GetAsString() // Returns '123.456'
value6 := value.GetAsStringWithDefault("ABC") // Returns '123.456'
valueB = data.NewAnyValue("1")
value7 := valueB.GetAsBoolean() // Returns True
valueC := data.NewAnyValue("abc")
value8 := valueC.GetAsBooleanWithDefault(false) // Returns False
type1 := value.TypeCode() // Returns TypeCode.String 1
}
value = AnyValue("123.456")
value1 = value.get_as_integer() # Returns 123
value2 = value.get_as_long() # Returns 123
value3 = value.get_as_float() # Returns 123.456
valueB = AnyValue("ABC")
value4 = valueB.get_as_integer_with_default(25) # Returns 25
value5 = value.get_as_string() # Returns '123.456'
value6 = value.get_as_string_with_default("ABC") # Returns '123.456'
valueB = AnyValue("1")
value7 = valueB.get_as_boolean() # Returns True
valueC = AnyValue("abc")
value8 = valueC.get_as_boolean_with_default(False) # Returns False
type1 = value.get_type_code() # Returns TypeCode.String
Update
This class offers the set_as_object() method to change a value. The following example shows how to use it.
let value = new AnyValue("ABC");
value.setAsObject("CEF"); // Sets value to "CEF"
value := data.NewAnyValue("ABC")
value.SetAsObject("CEF") // Sets value to "CEF"
value = AnyValue("ABC")
value.set_as_object("CEF") # Sets value to "CEF"
String representation
The method to_string() provides a way to create a string representation of an AnyValue object. The example below shows how to use it.
let value = new AnyValue(123.456);
let value1 = value.toString(); // Returns '123.456'
value := data.NewAnyValue(123)
value.String() // Returns '123.456'
value = AnyValue(123.456)
value1 = value.to_string() # Returns '123.456'
Logical operators
The method equals and equals_as_type offer a way to compare two different AnyValue objects. The first compares an object’s value to another specified value. When direct comparison gives a negative result, it tries to compare the values as strings. The second method compares an object’s value to another specified value. When direct comparison gives a negative result, it converts values to a type specified by a type code and compares them again. The following examples show how to use them.
import { AnyValue, TypeCode } from "pip-services4-commons-node"
let value = new AnyValue("123.456");
let value2 = value.clone();
let result1 = value.equals(value2); // Returns True
let result2 = value.equalsAsType(TypeCode.Object, value2); // Returns True
import (
"fmt"
convert "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/convert"
data "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/data"
)
func main() {
value := data.NewAnyValue("123.456")
value2 := value.Clone()
result1 := value.Equals(value2) // Returns True
fmt.Println(result1)
result2 := value.EqualsAsType(convert.Object, value2) // Returns True
fmt.Println(result2)
}
value = AnyValue("123.456")
value2 = value.clone()
result1 = value.equals(value2) # Returns True
from pip_services4_commons.convert import TypeCode
result2 = value.equals_as_type(TypeCode.Object, value2) # Returns True
AnyValueArray
This component provides a cross-language implementation of a dynamic array object that can hold values of any type. Each element is referenced by an index value, starting with zero for the first element. For example, the following AnyTypeArray contains a string, an integer, a float, and a date.
let value = new AnyValueArray([ 1, "ABC", 123.45, new Date() ]);
value := data.NewAnyValueArray([]interface{}{1, "ABC", 123.45, time.Now()})
value = AnyValueArray([1, "ABC", 123.45, date.today()])
Pre-requisites
To work with this class, we need to import it first. This can be done with the following command:
import { AnyValueArray } from "pip-services4-commons-node"
import (
data "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/data"
)
from pip_services4_commons.data import AnyValueArray
Create
There are several ways to create an AnyValueArray. First, we can create an instance of the class using a list of values as the input parameter. Second, we can use a string or a list with the methods from_string and from_values respectively. Lastly, we can clone an existing object. The examples below show how to perform each of them.
// Constructor
let value1 = new AnyValueArray([ 1, 2, 3 ]);
// String
let myString = "1.2.3";
let value2 = AnyValueArray.fromString(myString, '.');
// List
let myList = [1, 2, 3];
let value = AnyValueArray.fromValue(myList);
// Cloning
value2 = value.clone(); // Returns value2 as AnyValueArry with values 1,2,3
// Constructor
value1 := data.NewAnyValueArray([]interface{}{1, 2, 3})
// String
myString := "1.2.3"
value2 := data.NewAnyValueArrayFromString(myString, ".", false)
// List
myList := []int{1, 2, 3}
value := data.NewAnyValueArrayFromValues(myList)
// Cloning
value3 := value.Clone() // Returns value2 as AnyValueArry with values 1,2,3
# Constructor
value1 = AnyValueArray([1, 2, 3])
# String
my_string = "1.2.3"
value2 = AnyValueArray.from_string(my_string, '.')
# List
my_list = [1, 2, 3]
value = AnyValueArray.from_values(my_list)
# Cloning
value2 = value.clone() # Returns value2 as AnyValueArry with values 1,2,3
Contains
This class has the methods contains() and contains_as_type() that can be used to check if a value exists in an AnyValueArray. The first performs a direct comparison, and the second converts to the specified value and then checks if the value exists.
// Find out if it contains a value
let value = new AnyValueArray([ 1, "123.456", "2018-01-01" ]);
let res = value.contains(1); // Returns True
let result = value.containsAsType(TypeCode.Integer, 1); // Returns True
// Find out if it contains a value
value := data.NewAnyValueArray([]interface{}{1, "123.456", "2018-01-01"})
value.Contains(1) // Returns True
result := value.ContainsAsType(convert.Integer, 1) // Returns True
# Find out if it contains a value
value = AnyValueArray([1, "123.456", "2018-01-01"])
value.contains(1) # Returns True
from pip_services4_commons.convert import TypeCode
result = value.contains_as_type(TypeCode.Integer, 1) # Returns True
Conversion
This class offers several methods to transform the stored values into several well-known formats, such as Boolean, integer, double, float, and more. The examples below show how to use each of them.
import { AnyValueArray, AnyValueMap, TypeCode } from "pip-services4-commons-node"
let value = new AnyValueArray([ 1, "123.456", "2018-01-01" ]);
// Get a value for a specified index
let value1 = value.get(0); // Returns 1, type int
let value2 = value.getAsBoolean(0); // Returns True
let value3 = value.getAsBooleanWithDefault(1, false); // Returns False
let value4 = value.getAsNullableBoolean(2); // Returns null
let value5 = value.getAsInteger(1); // Returns 123
let value6 = value.getAsIntegerWithDefault(3, 0); // Returns 0
let value7 = value.getAsNullableInteger(3); // Returns null
let value8 = value.getAsLong(1); // Returns 123
let value9 = value.getAsLongWithDefault(3, 0); // Returns 0
let value10 = value.getAsNullableLong(3); // Returns null
let value11 = value.getAsFloat(1); // Returns 123.456
let value12 = value.getAsFloatWithDefault(3, 0.0); // Returns 0.0
let value13 = value.getAsNullableFloat(3); // Returns null
let value14 = value.getAsDouble(1); // Returns 123.456
let value15 = value.getAsDoubleWithDefault(3, 0.0); // Returns 0.0
let value16 = value.getAsNullableDouble(3); // Returns null
let value17 = value.getAsDateTime(2); // Returns 2018-01-01 00:00:00+00:00
let value18 = value.getAsDateTimeWithDefault(1, new Date()); // Returns (e.g) 2021-11-04
let value19 = value.getAsString(2); // Returns '2018-01-01'
let value20 = value.getAsNullableString(2); // Returns '2018-01-01'
let value21 = value.getAsStringWithDefault(2, "0000-00-00"); // Returns '2018-01-01'
let value22 = value.getAsArray(1); // Returns ['123.456']
let value23 = value.getAsArrayWithDefault(0, new AnyValueArray([0])); // Returns [1]
let value24 = value.getAsNullableArray(2); // Returns ['2018-01-01']
let valueA = new AnyValueArray([1, { "number": "123.456" }, "2018-01-01" ]);
let value25 = valueA.getAsMap(1); // Returns {'number': '123.456'}
value25 = valueA.getAsMapWithDefault(3, new AnyValueMap({ "key1": 1 })); // Returns {'key1': 1}
let value27 = valueA.getAsNullableMap(3); // Returns null
let value28 = value.getAsType(TypeCode.DateTime, 2); // Returns 2018-01-01
let value29 = value.getAsTypeWithDefault(TypeCode.DateTime, 1, new Date()); // Returns today date
let value30 = value.getAsNullableType(TypeCode.DateTime, 1); // Returns null
value := data.NewAnyValueArray([]interface{}{1, "123.456", "2018-01-01"})
// Get a value for a specified index
value1 := value.Get(0) // Returns 1, type int
value2 := value.GetAsBoolean(0) // Returns True
value3 := value.GetAsBooleanWithDefault(1, false) // Returns False
value4 := value.GetAsNullableBoolean(2) // Returns nil
value5 := value.GetAsInteger(1) // Returns 123
value6 := value.GetAsIntegerWithDefault(2, 0) // Returns 0
value7 := value.GetAsNullableInteger(2) // Returns nil
value8 := value.GetAsLong(1) // Returns 123
value9 := value.GetAsLongWithDefault(2, 0) // Returns 0
value10 := value.GetAsNullableLong(2) // Returns nil
value11 := value.GetAsFloat(1) // Returns 123.456
value12 := value.GetAsFloatWithDefault(2, 0.0) // Returns 0.0
value13 := value.GetAsNullableFloat(2) // Returns nil
value14 := value.GetAsDouble(1) // Returns 123.456
value15 := value.GetAsDoubleWithDefault(2, 0.0) // Returns 0.0
value16 := value.GetAsNullableDouble(2) // Returns nil
value17 := value.GetAsDateTime(2) // Returns 01-01-01 00:00:00+00:00
value18 := value.GetAsDateTimeWithDefault(1, time.Now()) // Returns (e.g) 2021-11-04 00:00:00+00:00
value19 := value.GetAsString(2) // Returns '2018-01-01'
value20 := value.GetAsNullableString(2) // Returns '2018-01-01'
value21 := value.GetAsStringWithDefault(2, "0000-00-00") // Returns '2018-01-01'
value22 := value.GetAsArray(1) // Returns ['123.456']
value23 := value.GetAsArrayWithDefault(0, data.NewAnyValueArray([]interface{}{0})) // Returns [1]
value24 := value.GetAsNullableArray(2) // Returns ['2018-01-01']
valueA := data.NewAnyValueArray([]interface{}{1, map[string]interface{}{"number": "123.456"}, "2018-01-01"})
value25 := valueA.GetAsMap(1) // Returns {'number': '123.456'}
value25 = valueA.GetAsMapWithDefault(1, data.NewAnyValueMap(map[string]interface{}{"key1": 1})) // Returns {'key1': 1}
value27 := valueA.GetAsNullableMap(1) // Returns nil
value28 := value.GetAsType(convert.DateTime, 2) // Returns 2018-01-01 00:00:00+00:00
value29 := value.GetAsTypeWithDefault(convert.DateTime, 1, time.Now()) // Returns today date
value30 := value.GetAsNullableType(convert.DateTime, 1) // Returns nil
from pip_services4_commons.convert import TypeCode
from pip_services4_commons.data import AnyValueMap
from datetime import date
value = AnyValueArray([1, "123.456", "2018-01-01"])
# Get a value for a specified index
value1 = value.get(0) # Returns 1, type int
value2 = value.get_as_boolean(0) # Returns True
value3 = value.get_as_boolean_with_default(1, False) # Returns False
value4 = value.get_as_nullable_boolean(2) # Returns None
value5 = value.get_as_integer(1) # Returns 123
value6 = value.get_as_integer_with_default(2, 0) # Returns 0
value7 = value.get_as_nullable_integer(2) # Returns None
value8 = value.get_as_long(1) # Returns 123
value9 = value.get_as_long_with_default(2, 0) # Returns 0
value10 = value.get_as_nullable_long(2) # Returns None
value11 = value.get_as_float(1) # Returns 123.456
value12 = value.get_as_float_with_default(2, 0.0) # Returns 0.0
value13 = value.get_as_nullable_float(2) # Returns None
value14 = value.get_as_double(1) # Returns 123.456
value15 = value.get_as_double_with_default(2, 0.0) # Returns 0.0
value16 = value.get_as_nullable_double(2) # Returns None
value17 = value.get_as_datetime(2) # Returns 2018-01-01 00:00:00+00:00
value18 = value.get_as_datetime_with_default(1, date.today()) # Returns (e.g) 2021-11-04 00:00:00+00:00
value19 = value.get_as_string(2) # Returns '2018-01-01'
value20 = value.get_as_nullable_string(2) # Returns '2018-01-01'
value21 = value.get_as_string_with_default(2,'0000-00-00') # Returns '2018-01-01'
value22 = value.get_as_array(1) # Returns ['123.456']
value23 = value.get_as_array_with_default(0, AnyValueArray([0])) # Returns [1]
value24 = value.get_as_nullable_array(2) # Returns ['2018-01-01']
valueA = AnyValueArray([1, {'number': "123.456"}, "2018-01-01"])
value25 = valueA.get_as_map(1) # Returns {'number': '123.456'}
value26 = valueA.get_as_map_with_default(2, AnyValueMap({'key1': 1})) # Returns {'key1': 1}
value27 = valueA.get_as_nullable_map(2) # Returns None
value28 = value.get_as_type(TypeCode.DateTime,2) # Returns 2018-01-01 00:00:00+00:00
value29 = value.get_as_type_with_default(TypeCode.DateTime, 1, date.today()) # Returns today date
value30 = value.get_as_nullable_type(TypeCode.DateTime,1) # Returns None
Update
We can either append a value or a list of values to an AnyValueArray with the append method or change the value of any element with the put method. The following examples show how to use them.
// Replace a value
let value = AnyValueArray([1, 2, 3]);
value.put(0,"ABC"); // Returns ABC,2,3
// Append a value
let myList = [1,3,4];
value.append(my_list); // Returns ABC,2,3,1,3,4
// Replace a value
value := data.NewAnyValueArray([]interface{}{1, 2, 3})
value.Put(0, "ABC") // Returns ABC,2,3
// Append a value
myList := []interface{}{1, 3, 4}
value.Append(myList) // Returns ABC,2,3,1,3,4
# Replace a value
value = AnyValueArray([1, 2, 3])
value.put(0,"ABC") # Returns ABC,2,3
# Append a value
my_list = [1,3,4]
value.append(my_list) # Returns ABC,2,3,1,3,4
Delete
To delete an element included in an AnyValueArray, we can use the remove method. This method asks the index of the element to be removed as input parameter. The code below shows how to use it.
let value = new AnyValueArray([ 1, "123.456", "2018-01-01" ]);
value.remove(0); // Returns 123.456,2018-01-01
value := data.NewAnyValueArray([]interface{}{1, "123.456", "2018-01-01"})
value.Remove(0) // Returns 123.456,2018-01-01
value = AnyValueArray([1, "123.456", "2018-01-01"])
value.remove(0) # Returns 123.456,2018-01-01
AnyValueMap
The AnyValueMap class provides a cross-language implementation of a dynamic map (dictionary) object that can hold values of any type. For example, the following map contains an integer, a float, a string, and a date.
let value = new AnyValueMap({
"key1": 1,
"key2": 123.456,
"key3": "ABC",
"key4": new Date()
});
value := data.NewAnyValueMap(map[string]interface{}{"key1": 1, "key2": 123.456, "key3": "ABC", "key4": time.Now()})
value = AnyValueMap({ 'key1': 1, 'key2': 123.456, 'key3': "ABC", 'key4': date.today() })
Pre-requisites
To use this component, we need to import its class first. The following code shows how to do this.
import { AnyValueMap } from "pip-services4-commons-node"
import (
data "github.com/pip-services3-gox/pip-services3-commons-gox/data"
)
from pip_services4_commons.data import AnyValueMap
Create
There are several ways to create an AnyValueMap object. It can be created by defining a new instance with the constructor, from a list of maps or tuples, or by cloning. The examples below show how to perform these operations.
// Constructor
let value = new AnyValueMap({
"key1": 1,
"key2": "123.456",
"key3": "2018-01-01"
}); // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Cloning
let value2 = value.clone(); // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Maps
let myMap1 = new AnyValueMap({
"key1": 1 ,
"key2": "123.456" ,
"key3": "2018-01-01"
});
let myMap2 = {
"key4": 2,
"key5": 3,
"key6": 4,
};
value = AnyValueMap.fromMaps(myMap1, myMap2); // Returns {"key1": 1,"key2": "123.456","key3": "2018-01-01","key4": 2,"key5": 3,"key6": 4}
// Tuples
value = AnyValueMap.fromTuples("key1", 1, "key2", "123.456", "key3", "2018-01-01"); // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Array of tuples
let myTuple = [ "key1", 1, "key2", "123.456", "key3", "2018-01-01" ];
value = AnyValueMap.fromTuplesArray(myTuple); // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Values
let myValue = [1,2];
value = AnyValueMap.fromValue(myValue); // Returns {"0": 1, "1": 2}
// Constructor
value := data.NewAnyValueMap(map[string]interface{}{"key1": 1, "key2": "123.456", "key3": "2018-01-01"}) // Returns{"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Cloning
value2 := value.Clone() // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Maps
myMap1 := map[string]interface{}{"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
myMap2 := map[string]interface{}{"key4": 2, "key5": 3, "key6": 4}
value = data.NewAnyValueMapFromMaps(myMap1, myMap2) // Returns {"key1": 1,"key2": "123.456","key3": "2018-01-01","key4": 2,"key5": 3,"key6": 4}
// Tuples
value = data.NewAnyValueMapFromTuples("key1", 1, "key2", "123.456", "key3", "2018-01-01") // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Array of tuples
myTuple := []interface{}{"key1", 1, "key2", "123.456", "key3", "2018-01-01"}
value = data.NewAnyValueMapFromTuplesArray(myTuple) // Returns {"key1": 1, "key2": "123.456", "key3": "2018-01-01"}
// Values
myValue := []int{1, 2}
value = data.NewAnyValueMapFromValue(myValue) // Returns {"0": 1, "1": 2}
# Constructor
value1 = AnyValueMap({ 'key1': 1, 'key2': "123.456", 'key3': "2018-01-01" }) # Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
# Cloning
value2 = value.clone() # Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
# Maps
my_map1 = { 'key1': 1, 'key2': "123.456", 'key3': "2018-01-01" }
my_map2 = {'key4': 2, 'key5': 3, 'key6': 4}
list_of_maps = [my_map1, my_map2]
value3 = AnyValueMap.from_maps(*list_of_maps) # Returns {'key1': 1,'key2': '123.456','key3': '2018-01-01','key4': 2,'key5': 3,'key6': 4}
# Tuples
my_tuple2 = ['key1', 1, 'key2', '123.456', 'key3', "2018-01-01"]
value4 = AnyValueMap.from_tuples(*my_tuple2) # Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
# Array of tuples
my_tuple = ['key1', 1, 'key2', '123.456', 'key3', "2018-01-01"]
value5 = AnyValueMap.from_tuples_array(my_tuple) # Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
# Values
my_value = [1,2]
value6 = AnyValueMap.from_value(my_value) # Returns {'0': 1, '1': 2}
Conversion
This class offers several methods to extract the value of an element specified by its key in different known formats such as Boolean, integer, float, and more. The following examples show how to use them.
let value = new AnyValueMap({
"key1": 1,
"key2": "123.456",
"key3": "2018-01-01",
"key4": "word"
});
let value1 = value.getAsBoolean("key1"); // Returns: true
let value2 = value.getAsInteger("key2"); // Returns: 123
let value3 = value.getAsIntegerWithDefault("key4", 0); // Returns 0
let value4 = value.getAsFloat("key2"); // Returns: 123.456
let value5 = value.getAsDateTime("key3"); // Returns new 2018-0-1
let valueA = new AnyValueMap({
"key1": 1,
"key2": { "key": "123.456" },
"key3": "2018-01-01"
}); // redact
let value6 = valueA.getAsMap("key2"); // Returns {'key': '123.456'}
let value7 = value.getAsNullableDateTime("key2"); // Returns null
let value8 = value.getAsNullableDateTime("key3"); // Returns 2018-0-1
let value9 = value.getAsString("key1"); // Returns '1'
let value10 = value.getAsObject(); // Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
let value11 = value.getAsType(TypeCode.String, "key1"); // Returns '1'
let value12 = value.getAsValue("key1");
import (
"fmt"
convert "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/convert"
data "github.com/pip-services4/pip-services4-go/pip-services4-commons-go/data"
)
func main() {
value := data.NewAnyValueMap(map[string]any{"key1": 1, "key2": "123.456", "key3": "2018-01-01"})
value1 := value.GetAsBoolean("key1") // Returns: true
value2 := value.GetAsInteger("key2") // Returns: 123
value3 := value.GetAsIntegerWithDefault("key3", 0) // Returns 0
value4 := value.GetAsFloat("key2") // Returns: 123.456
value5 := value.GetAsDateTime("key3") // Returns new Date(2018,0,1)
value9 := value.GetAsString("key1") // Returns '1'
valueA := data.NewAnyValueMap(map[string]any{"key1": 1, "key2": map[string]any{"key": "123.456"}, "key3": "2018-01-01"}) // redact
value6 := valueA.GetAsMap("key2") // Returns {'key': '123.456'}
value7, ok := value.GetAsNullableDateTime("key2") // Returns None
value8, ok := value.GetAsNullableDateTime("key3") // Returns new Date(2018,0,1)
value10, ok := value.GetAsObject("")
value11 := value.GetAsType(convert.String, "key1") // Returns '1'
value12 := value.GetAsValue("key1")
}
from pip_services4_commons.convert import TypeCode
value = AnyValueMap({ 'key1': 1, 'key2': "123.456", 'key3': "2018-01-01" })
value1 = value.get_as_boolean("key1") # Returns: true
value2 = value.get_as_integer("key2") # Returns: 123
value3 = value.get_as_integer_with_default("key3", 0) # Returns 0
value4 = value.get_as_float("key2") # Returns: 123.456
value5 = value.get_as_datetime("key3") # Returns new Date(2018,0,1)
value9 = value.get_as_string("key1") # Returns '1'
valueA = AnyValueMap({'key1': 1, 'key2': {'key': "123.456"}, 'key3': "2018-01-01"}) # redact
value6 = valueA.get_as_map("key2") # Returns {'key': '123.456'}
value7 = value.get_as_nullable_datetime("key2") # Returns None
value8 = value.get_as_nullable_datetime("key3") # Returns new Date(2018,0,1)
value10 = value.get_as_object() # Returns {'key1': 1, 'key2': '123.456', 'key3': '2018-01-01'}
value11 = value.get_as_type(TypeCode.String, 'key1') # Returns '1'
value12 = value.get_as_value('key1') # Returns '1'
Update
The method set_as_object() allows us to change the value of an element according to its key. The example below shows how to do this.
let value = new AnyValueMap({
"key1": 1 ,
"key2": "123.456",
"key3": "2018-01-01"
});
value.setAsObject("key1", 2); // Returns {"key1": 2, "key2": "123.456", "key3": "2018-01-01"}
value := data.NewAnyValueMap(map[string]interface{}{"key1": 1, "key2": "123.456", "key3": "2018-01-01"})
value.SetAsObject("key1", 2) // Returns {"key1": 2, "key2": "123.456", "key3": "2018-01-01"}
value = AnyValueMap({ 'key1': 1, 'key2': "123.456", 'key3': "2018-01-01" })
value.set_as_object('key1', 2) # Returns {'key1': 2, 'key2': '123.456', 'key3': '2018-01-01'}
Delete
To remove an element, we can use the remove method. This method accepts the key of a value as input. The example below shows how to use it.
var value = new AnyValueMap({
"key1": 1,
"key2": "123.456",
"key3": "2018-01-01"
});
value.remove("key1"); // Returns value = {'key2': '123.456', 'key3': '2018-01-01'}
value := data.NewAnyValueMap(map[string]interface{}{"key1": 1, "key2": "123.456", "key3": "2018-01-01"})
value.Remove("key1") /// Returns value = {"key2": "123.456", "key3": "2018-01-01"}
value = AnyValueMap({ 'key1': 1, 'key2': "123.456", 'key3': "2018-01-01" })
value.remove('key1') # Returns value = {'key2': '123.456', 'key3': '2018-01-01'}
Wrapping up
In this tutorial, we have seen how to use the three dynamic data types available in Pip.Services namely, AnyValue, AnyValueArray, and AnyValueMap.
AnyValue offers a dynamic type for single values. AnyValueArray is a dynamic type for arrays and AnyValueMap gives us a dynamic type for maps.
We have also seen examples of all the methods to create, extract, modify and delete values or elements that these classes have.