Announcing fFastMapper release 0.5

fFastMapper is ready and available via NuGet.

Use “Install-Package fFastMapper”

fFastMapper is a component to map property values between objects.

  • Maps are statically defined based upon the types being mapped
    • Only a single map exists in the system for mapping object X to object Y
  • By default, mappings are bi-directional
  • Mappings of complex objects fail silently (no null reference exceptions)
  • Mapping actions are performed very quickly
    • In my tests of a simple object map run one million times, AutoMapper took about 38 times as long to complete the mapping
    • AutoMapper took 342,179,880 ticks
      fFastMapper took 8,836,513 ticks
      Direct coded function took 7,004,837 ticks
  • Auto-initializes map on first use based on name and type matching.

Usage:

Quick Start:

using Grax.fFastMapper;


var dest =  fFastMap.MapperFor<SourceType,DestinationType>(source);

or

var dest = new DestinationType();
fFastMap.Map(source,dest);

or

var dest = new DestinationType()
fFastMap.MapperFor<SourceType,DestinationType>(source, dest);

Global Configuration (affects maps not created yet):

using Grax.fFastMapper;

            fFastMap
                .GlobalSettings()
                .SetAutoInitialize(false)
                .SetDefaultMappingDirection(fFastMap.MappingDirection.LeftToRight);

Map Configuration (affects property mapping functions (ClearMappers, AddDefaultPropertyMappers, AddPropertyMapper, DeletePropertyMapper that run after this command)

            fFastMap
                .MapperFor<n1, n2>()
                .SetMappingDirection(fFastMap.MappingDirection.LeftToRight)

Mapping Functions

            fFastMap
                .MapperFor<n1, n2>()
                .ClearMappers()
                .AddDefaultPropertyMappers()
                .DeletePropertyMapper(left => left.Id)
                .AddPropertyMapper(left => left.Id, right => right.Id);

Debugging/Testing Functions

fFastMap.MapperFor<n1,n2>().Mappings() gives you a List of Tuples where the Item1 property is a string representation of the left (source) side of the mapping and the Item2 property is a string representation of the right (destination) side of the mapping.

fFastMap.MapperFor<n1,n2>().MappingsView() gives you a string describing all of the mappings for these types.

Tips

ClearMappers will remove all mappings.  It will not cause the Map command to fail, just no data will be mapped when that command runs.

Please note that any "MapperFor<n1,n2>" is equivalent to any other.  i.e.
var x = fFastMap.MapperFor<n1,n2>();
var z = fFastMap.MapperFor<n1,n2>();

x.ClearMappers();

y.Map(source,dest); // all Mappers were just cleared in previous line.  No data transferred.

Home
Contact
Improve Your Life
Improve Your Team
Improve Your Code
Opinion
Software Projects

David Walker

David Walker is a Secure Software Consultant, a Certified Secure Software Lifecycle Professional (CSSLP), and a Professional Scrum Master. He believes in secure and reliable software and productive happy teams. He lives in Orlando with his lovely wife Lynn and his 2 dogs.