Description
The RecursiveObjectWriter class allows you to dynamically set the properties of an object and to copy them to another object recursively using dot notation.
Important points
- It is similar to ObjectWriter but writes properties recursively through the entire object graph.
- Nested property names are defined using dot notation as “object.subobject.property”
Methods
CopyProperties
Copies content of one object to another object by recursively reading all properties from a source object and then recursively writing them to a destination object.
CopyProperties(dest any, src any)
- dest: any - destination object to write properties to.
- src: any - source object to read properties from
SetProperties
Recursively sets values of some (all) object’s and its subobjects' properties.
The object can be a user defined object, map or array. Property values correspondently are object properties, map key-pairs or array elements with their indexes.
If some properties do not exist or introspection fails they are just silently skipped and no errors thrown.
SetProperties(obj any, values map[string]any)
- obj: any - object to write properties to.
- values: map[string]any - map containing property names and their values.
SetProperty
Recursively sets value of an object’s and its subobjects' property specified by its name.
The object can be a user defined object, map or array. The property name correspondently must be an object property, map key or array index.
If the property does not exist or introspection fails this method doesn’t do anything and doesn’t throw any errors.
SetProperty(obj any, name string, value any)
- obj: any - object to write a property to.
- name: string - name of the property to set.
- value: any - new value for the property to set.