/$$ /$$ /$$ /$$
| $$$ /$$$ | $$ |__/
| $$$$ /$$$$ /$$$$$$ /$$$$$$ /$$$$$$ | $$$$$$$ /$$ /$$$$$$
| $$ $$/$$ $$ /$$__ $$ /$$__ $$ /$$__ $$| $$__ $$| $$ /$$__ $$
| $$ $$$| $$| $$ \ $$| $$ \__/| $$ \ $$| $$ \ $$| $$| $$ \ $$
| $$\ $ | $$| $$ | $$| $$ | $$ | $$| $$ | $$| $$| $$ | $$
| $$ \/ | $$| $$$$$$/| $$ | $$$$$$$/| $$ | $$| $$| $$$$$$$
|__/ |__/ \______/ |__/ | $$____/ |__/ |__/|__/ \____ $$
| $$ | $$
| $$ | $$
|__/ |__/
Morphiq is a versatile tool that enhances object mapping and transformation in C# using attribute-based configurations. It simplifies the process of converting objects between different types, making it ideal for scenarios such as data transfer objects (DTOs), view models, and response objects in web APIs.
- Attribute-Based Mapping: Use attributes to define custom mappings, default values, and properties to ignore.
- Custom Mapping Methods: Define custom mapping logic using methods specified by attributes.
- Default Value Handling: Automatically set default values for properties when the source property is null.
- Property Ignoring: Exclude specific properties from the mapping process using ignore attributes.
- Flexible Configuration: Apply additional configuration to the target object during the mapping proces
using Morphiq;
public class Entity
{
public string Name { get; set; } = "John Doe";
public int Age { get; set; } = 30;
}
public class DTO
{
public string Name { get; set; } = string.Empty;
public int Age { get; set; }
}
var entity = new Entity();
var dto = entity.MorphTo<DTO>();
Console.WriteLine(dto.Name); // Output: John Doe
Console.WriteLine(dto.Age); // Output: 30Some attributes are available to control the behavior of the mapping.
using Morphiq;
using Morphiq.Attributes;
public class Entity
{
public string Name { get; set; } = "John Doe";
[IgnoreProperty]
public int Age { get; set; } = 30;
}
public class DTO
{
public string Name { get; set; }
public int Age { get; set; }
}
var entity = new Entity();
var dto = entity.MorphTo<DTO>();
Console.WriteLine(dto.Name); // Output: John Doe
Console.WriteLine(dto.Age); // Output: 0 (default value)using Morphiq;
using Morphiq.Attributes;
public class Entity
{
[MorphToDefaultValue("Unknown")]
public string Name { get; set; }
public int Age { get; set; } = 30;
}
public class DTO
{
public string Name { get; set; }
public int Age { get; set; }
}
var entity = new Entity();
var dto = entity.MorphTo<DTO>();
Console.WriteLine(dto.Name); // Output: Unknown
Console.WriteLine(dto.Age); // Output: 30using Morphiq;
using Morphiq.Attributes;
public class Entity
{
public string Name { get; set; } = "John Doe";
public int Age { get; set; } = 30;
[MorphToCustomMapping(nameof(MapName))]
public string FullName { get; set; } = "John Doe";
private string MapName(object value)
{
return $"Mapped: {value}";
}
}
public class DTO
{
public string Name { get; set; }
public int Age { get; set; }
public string FullName { get; set; }
}
var entity = new Entity();
var dto = entity.MorphTo<DTO>();
Console.WriteLine(dto.Name); // Output: John Doe
Console.WriteLine(dto.Age); // Output: 30
Console.WriteLine(dto.FullName); // Output: Mapped: John Doeusing Morphiq;
public class Entity
{
public string Name { get; set; } = "John Doe";
public int Age { get; set; } = 30;
}
public class DTO
{
public string Name { get; set; }
public int Age { get; set; }
}
var entity = new Entity();
var dto = entity.MorphTo<DTO>(x => x.Name = "Jane Doe");
Console.WriteLine(dto.Name); // Output: Jane Doe
Console.WriteLine(dto.Age); // Output: 30Run the following command in your project directory:
dotnet add package Morphiq --version 0.1.0This project is licensed under the MIT License - see the LICENSE file for details.