AutoMapper.Collection - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #llm #android #deep-learning #docker #macos #nodejs #awesome #cli #awesome-list #security #pytorch #openai

AutoMapper.Collection

(★ 256)

AutoMapper support for updating existing collections by equivalency

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
  - release.yml
- NuGet.Config
- NuGet.exe
- NuGet.targets
- - AutoMapper.Collection.csproj
  - PrimitiveExtensions.cs
  - ReflectionHelper.cs
  - TypeExtensions.cs
  - TypeHelper.cs
- - AutoMapper.Collection.EntityFramework.csproj
  - Extensions.cs
  - GenerateEntityFrameworkPrimaryKeyPropertyMaps.cs
  - IPersistence.cs
  - Persistence.cs
- - AutoMapper.Collection.EntityFramework.Tests.csproj
  - EntityFramworkTests.cs
  - MappingTestBase.cs
- - AutoMapper.Collection.LinqToSQL.csproj
  - GetLinqToSQLPrimaryKeyProperties.cs
  - IPersistence.cs
  - Persistence.cs
  - PersistenceExtensions.cs
- - AutoMapper.Collection.Tests.csproj
  - InheritanceWithCollectionTests.cs
  - MapCollectionWithEqualityTests.cs
  - MapCollectionWithEqualityThreadSafetyTests.cs
  - MappingTestBase.cs
  - NullableIdTests.cs
  - OptionsTests.cs
  - ValueTypeTests.cs
- Key.snk
.gitattributes
.gitignore
AutoMapper.Collection.sln
build.ps1
Directory.Build.props
global.json
icon.png
LICENSE
Push.ps1
README.md
version.props

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/AutoMapper/AutoMapper.Collection

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AutoMapper.Collection

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. .NET

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
.NET SDK dotnet 명령어를 쓰기 위한 SDK입니다.

dotnet restore

프로젝트에 필요한 패키지를 내려받습니다.

dotnet run

프로젝트를 빌드하고 바로 실행합니다.

✅ dotnet run 실행 후 터미널에 나타나는 안내 메시지나 주소를 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="https://s3.amazonaws.com/automapper/logo.png" alt="AutoMapper">

# AutoMapper.Collection
Adds ability to map collections to existing collections without re-creating the collection object.

Will Add/Update/Delete items from a preexisting collection object based on user defined equivalency between the collection's generic item type from the source collection and the destination collection.

[![NuGet](http://img.shields.io/nuget/v/AutoMapper.Collection.svg)](https://www.nuget.org/packages/AutoMapper.Collection/)

## How to add to AutoMapper?
Call AddCollectionMappers when configuring
```
Mapper.Initialize(cfg =>
{
    cfg.AddCollectionMappers();
    // Configuration code
});
```
Will add new IObjectMapper objects into the master mapping list.

## Adding equivalency between two classes
Adding equivalence to objects is done with EqualityComparison extended from the IMappingExpression class.
```
cfg.CreateMap<OrderItemDTO, OrderItem>().EqualityComparison((odto, o) => odto.ID == o.ID);
```
Mapping OrderDTO back to Order will compare Order items list based on if their ID's match
```
Mapper.Map<List<OrderDTO>,List<Order>>(orderDtos, orders);
```
If ID's match, then AutoMapper will map OrderDTO to Order

If OrderDTO exists and Order doesn't, then AutoMapper will add a new Order mapped from OrderDTO to the collection

If Order exists and OrderDTO doesn't, then AutoMapper will remove Order from collection

## Why update collection? Just recreate it 
ORMs don't like setting the collection, so you need to add and remove from preexisting one.

This automates the process by just specifying what is equal to each other.

## Can it just figure out the ID equivalency for me in Entity Framework?
`Automapper.Collection.EntityFramework` or `Automapper.Collection.EntityFrameworkCore` can do that for you.

```
Mapper.Initialize(cfg =>
{
    cfg.AddCollectionMappers();
// entity framework
    cfg.SetGeneratePropertyMaps<GenerateEntityFrameworkPrimaryKeyPropertyMaps<DB>>();
// entity framework core
cfg.SetGeneratePropertyMaps<GenerateEntityFrameworkCorePrimaryKeyPropertyMaps<DB>>();
    // Configuration code
});
```
User defined equality expressions will overwrite primary key expressions.

## What about comparing to a single existing Entity for updating?
Automapper.Collection.EntityFramework does that as well through extension method from of DbSet<TEntity>.

Translate equality between dto and EF object to an expression of just the EF using the dto's values as constants.
```
dbContext.Orders.Persist().InsertOrUpdate<OrderDTO>(newOrderDto);
dbContext.Orders.Persist().InsertOrUpdate<OrderDTO>(existingOrderDto);
dbContext.Orders.Persist().Remove<OrderDTO>(deletedOrderDto);
dbContext.SubmitChanges();
```
**Note:** This is done by converting the OrderDTO to Expression<Func<Order,bool>> and using that to find matching type in the database.  You can also map objects to expressions as well.

Persist doesn't call submit changes automatically

## Where can I get it?

First, [install NuGet](http://docs.nuget.org/docs/start-here/installing-nuget). Then, install [AutoMapper.Collection](https://www.nuget.org/packages/AutoMapper.Collection/) from the package manager console:
```
PM> Install-Package AutoMapper.Collection
```

### Additional packages

#### AutoMapper Collection for Entity Framework
```
PM> Install-Package AutoMapper.Collection.EntityFramework
```

#### AutoMapper Collection for Entity Framework Core
```
PM> Install-Package AutoMapper.Collection.EntityFrameworkCore
```

#### AutoMapper Collection for LinqToSQL
```
PM> Install-Package AutoMapper.Collection.LinqToSQL
```