MapZilla

MapZilla is a derivate Work of Automapper (version 14) from Jimmy Bogard

A convention-based object-object mapper.

MapZilla uses a fluent configuration API to define an object-object mapping strategy. MapZilla uses a convention-based matching algorithm to match up source to destination values. MapZilla is geared towards model projection scenarios to flatten complex object models to DTOs and other simple objects, whose design is better suited for serialization, communication, messaging, or simply an anti-corruption layer between the domain and application layer.

New to MapZilla? Check out the Getting Started Guide page first.

Overview

• Getting Started Guide
  • What is MapZilla?
  • Why use MapZilla?
  • How do I use MapZilla?
  • Where do I configure MapZilla?
  • How do I test my mappings?
• Understanding Your Mappings

Features

• Configuration
  • Profile Instances
  • Naming Conventions
  • Replacing characters
  • Recognizing pre/postfixes
  • Global property/field filtering
  • Configuring visibility
  • Configuration compilation
• Configuration Validation
  • Overriding configuration errors
  • Selecting members to validate
  • Custom validations
• Dependency Injection
  • Examples
  • Low level API-s
  • Queryable Extensions
• Projection
• Nested Mappings
• Lists and Arrays
  • Handling null collections
  • Polymorphic element types in collections
• Construction
• Flattening
  • IncludeMembers
• Reverse Mapping and Unflattening
  • Customizing reverse mapping
  • IncludeMembers
• Mapping Inheritance
  • Runtime polymorphism
  • Specifying inheritance in derived classes
  • As
  • Inheritance Mapping Priorities
• Attribute Mapping
  • Type Map configuration
  • Member configuration
• Dynamic and ExpandoObject Mapping
• Open Generics
• Queryable Extensions
  • Query Provider Limitations
  • The instance API
  • Preventing lazy loading/SELECT N+1 problems
  • Custom projection
  • Custom Type Conversion
  • Custom destination type constructors
  • String conversion
  • Explicit expansion
  • Aggregations
  • Parameterization
  • Recursive models
  • Supported mapping options
• Expression Translation (UseAsDataSource)
  • Mapping Flattened Properties to Navigation Properties
  • Supported Mapping options
  • UseAsDataSource
• MapZilla.Extensions.EnumMapping
  • Usage
  • Default Convention
  • ReverseMap Convention
  • Testing

Extensibility

• Custom Type Converters
• Custom Value Resolvers
  • Custom constructor methods
  • The resolved value is mapped to the destination property
  • Customizing the source value supplied to the resolver
  • Passing in key-value to Mapper
  • ForPath
  • Resolvers and conditions
• Conditional Mapping
  • Preconditions
• Null Substitution
• Value Converters
• Value Transformers
• Before and After Map Action
  • Using IMappingAction

Examples

The source code contains unit tests for all of the features listed above. Use the GitHub search to find relevant examples.

Housekeeping

The latest builds can be found at NuGet