Cara mengatur Automapper di ASP.NET Core

Saya relatif baru di .NET, dan saya memutuskan untuk menangani .NET Core daripada belajar "cara lama". Saya menemukan artikel terperinci tentang pengaturan AutoMapper untuk .NET Core di sini , tetapi apakah ada langkah-langkah yang lebih sederhana untuk seorang pemula?

Saya menemukan jawabannya! Berikut detailnya:

1. Tambahkan Paket AutoMapper utama ke solusi Anda melalui NuGet .

2. Tambahkan Paket Injeksi Ketergantungan AutoMapper ke solusi Anda melalui NuGet .

3. Buat kelas baru untuk profil pemetaan. (Saya membuat kelas di direktori solusi utama yang disebut MappingProfile.csdan menambahkan kode berikut.) Saya akan menggunakan objek Userdan UserDtosebagai contoh.

   public class MappingProfile : Profile {
       public MappingProfile() {
           // Add as many of these lines as you need to map your objects
           CreateMap<User, UserDto>();
           CreateMap<UserDto, User>();
       }
   }

4. Kemudian tambahkan AutoMapperConfiguration di Startup.csseperti yang ditunjukkan di bawah ini:

   public void ConfigureServices(IServiceCollection services) {
       // .... Ignore code before this
   
      // Auto Mapper Configurations
       var mappingConfig = new MapperConfiguration(mc =>
       {
           mc.AddProfile(new MappingProfile());
       });
   
       IMapper mapper = mappingConfig.CreateMapper();
       services.AddSingleton(mapper);
   
       services.AddMvc();
   
   }

5. Untuk memohon objek yang dipetakan dalam kode, lakukan sesuatu seperti berikut ini:

   public class UserController : Controller {
   
       // Create a field to store the mapper object
       private readonly IMapper _mapper;
   
       // Assign the object in the constructor for dependency injection
       public UserController(IMapper mapper) {
           _mapper = mapper;
       }
   
       public async Task<IActionResult> Edit(string id) {
   
           // Instantiate source object
           // (Get it from the database or whatever your code calls for)
           var user = await _context.Users
               .SingleOrDefaultAsync(u => u.Id == id);
   
           // Instantiate the mapped data transfer object
           // using the mapper you stored in the private field.
           // The type of the source object is the first type argument
           // and the type of the destination is the second.
           // Pass the source object you just instantiated above
           // as the argument to the _mapper.Map<>() method.
           var model = _mapper.Map<UserDto>(user);
   
           // .... Do whatever you want after that!
       }
   }

Saya harap ini membantu seseorang memulai dengan ASP.NET Core! Saya menyambut setiap umpan balik atau kritik karena saya masih baru di dunia .NET!

Langkah Untuk Menggunakan AutoMapper dengan ASP.NET Core.

Langkah 1. Menginstal AutoMapper.Extensions.Microsoft.DependencyInjection dari Paket NuGet.

Langkah 2. Buat Folder di Solusi untuk menjaga Pemetaan dengan Nama "Pemetaan".

Langkah 3. Setelah menambahkan folder Pemetaan kami telah menambahkan kelas dengan Nama " MappingProfile " nama ini dapat menjadi sesuatu yang unik dan baik untuk dipahami.

Di kelas ini, kita akan Mempertahankan semua Pemetaan.

Langkah 4. Menginisialisasi Mapper di Startup "ConfigureServices"

Di Kelas Startup, kita Perlu Menginisialisasi Profil yang telah kita buat dan juga Mendaftar Layanan AutoMapper.

  Mapper.Initialize(cfg => cfg.AddProfile<MappingProfile>());

  services.AddAutoMapper();

Cuplikan Kode untuk memperlihatkan Metode ConfigureServices di mana kita perlu Menginisialisasi dan Mendaftar AutoMapper.

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }


    public void ConfigureServices(IServiceCollection services)
    {
        services.Configure<CookiePolicyOptions>(options =>
        {
            // This lambda determines whether user consent for non-essential cookies is needed for a given request.
            options.CheckConsentNeeded = context => true;
            options.MinimumSameSitePolicy = SameSiteMode.None;
        });


        // Start Registering and Initializing AutoMapper

        Mapper.Initialize(cfg => cfg.AddProfile<MappingProfile>());
        services.AddAutoMapper();

        // End Registering and Initializing AutoMapper

        services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);

    }}

Langkah 5. Dapatkan Output.

Untuk mendapatkan hasil yang dipetakan kita perlu memanggil AutoMapper.Mapper.Map dan lulus Tujuan dan Sumber yang tepat.

AutoMapper.Mapper.Map<Destination>(source);

CodeSnippet

    [HttpPost]
    public void Post([FromBody] SchemeMasterViewModel schemeMaster)
    {
        if (ModelState.IsValid)
        {
            var mappedresult = AutoMapper.Mapper.Map<SchemeMaster>(schemeMaster);
        }
    }

Saya ingin memperluas jawaban @ theutz - yaitu baris ini:

// services.AddAutoMapper(typeof(Startup));  // <-- newer automapper version uses this signature.

Ada bug ( mungkin ) di AutoMapper.Extensions.Microsoft.DependencyInjection versi 3.2.0. (Saya menggunakan .NET Core 2.0)

Ini ditangani dalam masalah GitHub ini . Jika kelas Anda mewarisi kelas Profil AutoMapper ada di luar perakitan di mana Anda kelas Startup adalah mereka mungkin tidak akan terdaftar jika injeksi AutoMapper Anda terlihat seperti ini:

services.AddAutoMapper();

kecuali jika Anda secara eksplisit menentukan majelis mana yang akan dicari profil AutoMapper.

Ini dapat dilakukan seperti ini di Startup Anda. Konfigurasi Layanan:

services.AddAutoMapper(<assembies> or <type_in_assemblies>);

di mana "assemblies" dan "type_in_assemblies" arahkan ke majelis tempat kelas Profile di aplikasi Anda ditentukan. Misalnya:

services.AddAutoMapper(typeof(ProfileInOtherAssembly), typeof(ProfileInYetAnotherAssembly));

Saya kira (dan saya menekankan kata ini) bahwa karena mengikuti penerapan parameterless overload (kode sumber dari GitHub ):

public static IServiceCollection AddAutoMapper(this IServiceCollection services)
{
     return services.AddAutoMapper(null, AppDomain.CurrentDomain.GetAssemblies());
}

kami mengandalkan CLR yang memiliki perakitan JITed yang berisi profil AutoMapper yang mungkin atau mungkin tidak benar karena hanya dipasangkan ketika dibutuhkan (lebih detail dalam pertanyaan StackOverflow ini ).

jawaban theutz di sini sangat bagus, saya hanya ingin menambahkan ini:

Jika Anda membiarkan profil pemetaan Anda mewarisi MapperConfigurationExpressionalih-alih Profile, Anda dapat dengan mudah menambahkan tes untuk memverifikasi pengaturan pemetaan Anda, yang selalu berguna:

[Fact]
public void MappingProfile_VerifyMappings()
{
    var mappingProfile = new MappingProfile();

    var config = new MapperConfiguration(mappingProfile);
    var mapper = new Mapper(config);

    (mapper as IMapper).ConfigurationProvider.AssertConfigurationIsValid();
}

Saya memecahkannya dengan cara ini (mirip dengan di atas tetapi saya merasa itu adalah solusi yang lebih bersih) untuk .NET Core 2.2 / Automapper 8.1.1 w / Extensions.DI 6.1.1.

Buat kelas MappingProfile.cs dan isi konstruktor dengan Maps (Saya berencana menggunakan satu kelas untuk menampung semua pemetaan saya)

    public class MappingProfile : Profile
    {
        public MappingProfile()
        {
            CreateMap<Source, Dest>().ReverseMap();
        }
    }

Di Startup.cs, tambahkan di bawah ini untuk menambahkan ke DI (argumen assembly adalah untuk kelas yang menyimpan konfigurasi pemetaan Anda, dalam kasus saya, ini adalah kelas MappingProfile).

//add automapper DI
services.AddAutoMapper(typeof(MappingProfile));

Di Kontroler, gunakan seperti yang Anda lakukan pada objek DI lainnya

    [Route("api/[controller]")]
    [ApiController]
    public class AnyController : ControllerBase
    {
        private readonly IMapper _mapper;

        public AnyController(IMapper mapper)
        {
            _mapper = mapper;
        }

        public IActionResult Get(int id)
        {
            var entity = repository.Get(id);
            var dto = _mapper.Map<Dest>(entity);

            return Ok(dto);
        }
    }

Di Startup.cs saya (Core 2.2, Automapper 8.1.1)

services.AddAutoMapper(new Type[] { typeof(DAL.MapperProfile) });            

Dalam proyek akses data saya

namespace DAL
{
    public class MapperProfile : Profile
    {
        // place holder for AddAutoMapper (to bring in the DAL assembly)
    }
}

Dalam definisi model saya

namespace DAL.Models
{
    public class PositionProfile : Profile
    {
        public PositionProfile()
        {
            CreateMap<Position, PositionDto_v1>();
        }
    }

    public class Position
    {
        ...
    }

Saya suka banyak jawaban, terutama yang @saineshwar. Saya menggunakan .net Core 3.0 dengan AutoMapper 9.0, jadi saya merasa sudah waktunya untuk memperbarui jawabannya.

Apa yang berhasil bagi saya adalah di Startup.ConfigureServices (...) daftarkan layanan dengan cara ini:

    services.AddAutoMapper(cfg => cfg.AddProfile<MappingProfile>(), 
                               AppDomain.CurrentDomain.GetAssemblies());

Saya pikir sisa jawaban @saineshwar tetap sempurna. Tetapi jika ada yang tertarik kode controller saya adalah:

[HttpGet("{id}")]
public async Task<ActionResult> GetIic(int id)
{
    // _context is a DB provider
    var Iic = await _context.Find(id).ConfigureAwait(false);

    if (Iic == null)
    {
        return NotFound();
    }

    var map = _mapper.Map<IicVM>(Iic);

    return Ok(map);
}

Dan kelas pemetaan saya:

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap<Iic, IicVM>()
            .ForMember(dest => dest.DepartmentName, o => o.MapFrom(src => src.Department.Name))
            .ForMember(dest => dest.PortfolioTypeName, o => o.MapFrom(src => src.PortfolioType.Name));
            //.ReverseMap();
    }
}

----- EDIT -----

Setelah membaca dokumen yang terhubung dalam komentar oleh Lucian Bargaoanu, saya pikir lebih baik untuk mengubah jawaban ini sedikit.

Tanpa parameter services.AddAutoMapper() (yang memiliki jawaban @saineshwar) tidak berfungsi lagi (setidaknya untuk saya). Tetapi jika Anda menggunakan perakitan NuGet AutoMapper.Extensions.Microsoft.DependencyInjection, kerangka kerja ini dapat memeriksa semua kelas yang memperpanjang AutoMapper.Profile (seperti tambang, MappingProfile).

Jadi, dalam kasus saya, di mana kelas milik majelis pelaksana yang sama, pendaftaran layanan dapat dipersingkat menjadi services.AddAutoMapper(System.Reflection.Assembly.GetExecutingAssembly());
(Pendekatan yang lebih elegan bisa menjadi ekstensi tanpa parameter dengan pengkodean ini).

Terima kasih, Lucian!

Saya menggunakan AutoMapper 6.1.1 dan asp.net Core 1.1.2.

Pertama-tama, tentukan kelas Profil yang diwarisi oleh Kelas Profil Automapper. Saya Membuat antarmuka IProfile yang kosong, tujuannya hanya untuk menemukan kelas-kelas jenis ini.

 public class UserProfile : Profile, IProfile
    {
        public UserProfile()
        {
            CreateMap<User, UserModel>();
            CreateMap<UserModel, User>();
        }
    }

Sekarang buat kelas yang terpisah misalnya Pemetaan

 public class Mappings
    {
     public static void RegisterMappings()
     {            
       var all =
       Assembly
          .GetEntryAssembly()
          .GetReferencedAssemblies()
          .Select(Assembly.Load)
          .SelectMany(x => x.DefinedTypes)
          .Where(type => typeof(IProfile).GetTypeInfo().IsAssignableFrom(type.AsType()));

            foreach (var ti in all)
            {
                var t = ti.AsType();
                if (t.Equals(typeof(IProfile)))
                {
                    Mapper.Initialize(cfg =>
                    {
                        cfg.AddProfiles(t); // Initialise each Profile classe
                    });
                }
            }         
        }

    }

Sekarang di Proyek web MVC Core di file Startup.cs, di konstruktor, panggil kelas Pemetaan yang akan menginisialisasi semua pemetaan pada saat memuat aplikasi.

Mappings.RegisterMappings();

Untuk ASP.NET Core (diuji menggunakan 2.0+ dan 3.0), jika Anda lebih suka membaca dokumentasi sumber: https://github.com/AutoMapper/AutoMapper.Extensions.Microsoft.DependencyInjection/blob/master/README.md

Jika tidak, ikuti 4 langkah ini berfungsi:

1. Instal AutoMapper.Extensions.Microsoft.DependancyInjection dari nuget.

2. Cukup tambahkan beberapa kelas profil.

3. Kemudian tambahkan di bawah ini ke kelas startup.cs Anda. services.AddAutoMapper(OneOfYourProfileClassNamesHere)

4. Kemudian cukup Suntikkan IMapper di pengontrol Anda atau di mana pun Anda membutuhkannya:

public class EmployeesController {

    private readonly IMapper _mapper;

    public EmployeesController(IMapper mapper){

        _mapper = mapper;
    }

Dan jika Anda ingin menggunakan ProjectTo sekarang cukup:

var customers = await dbContext.Customers.ProjectTo<CustomerDto>(_mapper.ConfigurationProvider).ToListAsync()

Untuk AutoMapper 9.0.0:

public static IEnumerable<Type> GetAutoMapperProfilesFromAllAssemblies()
    {
        foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
        {
            foreach (var aType in assembly.GetTypes())
            {
                if (aType.IsClass && !aType.IsAbstract && aType.IsSubclassOf(typeof(Profile)))
                    yield return aType;
            }
        }
    }

Profilperpile:

public class OrganizationProfile : Profile
{
  public OrganizationProfile()
  {
    CreateMap<Foo, FooDto>();
    // Use CreateMap... Etc.. here (Profile methods are the same as configuration methods)
  }
}

Di Startup Anda:

services.AddAutoMapper(GetAutoMapperProfilesFromAllAssemblies()
            .ToArray());

Dalam Pengontrol atau layanan: Suntikkan mapper:

private readonly IMapper _mapper;

Pemakaian:

var obj = _mapper.Map<TDest>(sourceObject);

Pada versi terbaru dari core asp.net Anda harus menggunakan inisialisasi berikut:

services.AddAutoMapper(typeof(YourMappingProfileClass));

Asp.Net Core 2.2 dengan AutoMapper.Extensions.Microsoft.DependencyInjection.

public class MappingProfile : Profile
{
  public MappingProfile()
  {
      CreateMap<Domain, DomainDto>();
  }
}

Di Startup.cs

services.AddAutoMapper(typeof(List.Handler));

Untuk menambah apa yang disebutkan Arve Systad untuk pengujian. Jika karena alasan apa pun Anda seperti saya dan ingin mempertahankan struktur warisan yang disediakan dalam solusi theutz, Anda dapat mengatur MapperConfiguration seperti:

var mappingProfile = new MappingProfile();
var config = new MapperConfiguration(cfg =>
{
    cfg.AddProfile(mappingProfile);
});
var mapper = new Mapper(config);

Saya melakukan ini di NUnit.

services.AddAutoMapper (); tidak bekerja untuk saya. (Saya menggunakan Asp.Net Core 2.0)

Setelah mengkonfigurasi seperti di bawah ini

   var config = new AutoMapper.MapperConfiguration(cfg =>
   {                 
       cfg.CreateMap<ClientCustomer, Models.Customer>();
   });

inisialisasi mapper IMapper mapper = config.CreateMapper ();

dan menambahkan objek mapper ke layanan sebagai layanan singleton. Tambahkan Adingleton (mapper);

dengan cara ini saya dapat menambahkan DI ke controller

  private IMapper autoMapper = null;

  public VerifyController(IMapper mapper)
  {              
   autoMapper = mapper;  
  }

dan saya telah menggunakan seperti di bawah ini dalam metode tindakan saya

  ClientCustomer customerObj = autoMapper.Map<ClientCustomer>(customer);

tentang theutz jawaban, tidak perlu menentukan parrameter mapper IMapper pada konstruktor controller.

Anda dapat menggunakan Mapper karena ia adalah anggota statis di sembarang tempat kode.

public class UserController : Controller {
   public someMethod()
   {
      Mapper.Map<User, UserDto>(user);
   }
}