ARSoftware.ObjectMapper 2.4.4

ARSoftware.ObjectMapper

This simple project is built to allow mapping an object into another object using a configuration file written in JSON.

Currently only JSON → JSON mapping is available, but there is potential to add other types in future.

JSON Configuration Documentation

Regular Properties

Basic properties can be mapped using a dollar sign followed by the path to the property on the input object.

{
  "TargetProperty": "$Nested.Property.Path",
  "TargetPropertyTwo": "$PropertyPath"
}

Fixed values can be defined by forgoing the dollar sign.

{
  "TargetProperty": "Fixed String Value",
  "TargetFixedInteger": 1
}

Nested Objects

Nested objects are mapped using a sub configuration, these sub configurations are designed in the same way as the overarching main configuration

{
  "TargetObject": {
    "TargetNestedProperty": "$Source.Property.Path",
    "TargetNestedPropertyFixed": 12
  }
}

Array Mapping

Arrays can be defined using a sub configuration defining both a source and map property, the source does not require a dollar sign. The map property can be either an object or a single value/mapped field

Object values:

{
  "TargetArray": {
    "source": "Path.To.Array",
    "map": {
      "TargetArrayProperty": "$Path.To.Source.Inside.Array"
    }
  }
}

Single values:

{
  "TargetArray": {
    "source": "Path.To.Array",
    "map": "$Path.To.Source.Inside.Array"
  }
}

Functions/Expressions

There are a few functions available to use within the configuration file, and will be executed during the mapping process. These functions are not case-sensitive. Currently available functions are:

• concat(arg1, arg2, ...) - Concatenates all the arguments
• upper(arg) - Transforms the argument to upper case
• lower(arg) - Transforms the argument to lower case
• join(separator, arg1, arg2, ...) - Joins the arguments using the separator
• guid() - Generates a new Guid
• now() - Current DateTime (local)
• slug(arg) - Creates a slug of the input

As well as the above there are some functions which are for more specific/unique cases (based on my own requirement). There is the ability to convert from MongoDB BinData into a C Sharp Legacy UUID (Guid).

• csuuid(arg) - Converts a BinData object into a standard C# Guid.

{
  "TargetProperty": "Guid()",
  "TargetSlugProperty": "Slug($SourceProperty)",
  "FullName": "Concat($FirstName, ' ', $LastName)"
}