Automapper C# (개발자를 위한 작동 방식)

Automapper의 주요 기능

• 코드 간소화: Automapper는 속성 매핑을 자동화하여 수동 코드 필요성을 크게 줄여 오류를 방지하고 시간을 절약합니다.
• 매핑 구성의 유연성: Automapper는 광범위한 매핑 시나리오를 수용할 수 있도록 매핑 구성의 세부적인 맞춤화를 허용합니다.
• 성능 효율성: 라이브러리는 큰 및 복잡한 객체 모델을 처리하도록 설계되어 있으며, 성능 상의 큰 부담이 없습니다.

패키지 매니저 콘솔을 통한 설치

패키지 매니저 콘솔에서 간단한 명령어를 실행하여 프로젝트에 Automapper를 쉽게 설치할 수 있습니다:

Install-Package AutoMapper

기본 매핑 구성 설정

Automapper를 사용하기 위한 기본 단계는 매핑 구성을 정의하는 것입니다. 이는 입력 객체(소스) 속성이 출력 객체(대상)로 어떻게 전송되어야 하는지를 지정하는 작업을 포함합니다.

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

Dim config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of SourceClass, DestinationClass)()
End Sub)
Dim mapper As IMapper = config.CreateMapper()

• 위의 예에서는 SourceClass에서 DestinationClass로 속성을 매핑하는 매핑 구성이 생성됩니다.
• 이 구성을 사용하여 IMapper의 인스턴스가 생성됩니다.

복잡한 객체 모델 평면화

Automapper의 강점 중 하나는 복잡한 객체 모델을 평면화할 수 있는 능력입니다. 이 기능은 중첩된 객체를 처리할 때 특히 유용하며, 이러한 중첩된 속성을 평면 목적 클래스 구조로 매핑할 수 있게 합니다.

다양한 객체 유형 처리

Automapper는 사용자 도메인 객체, DTO, 심지어는 보기 모델을 비롯한 다양한 객체 유형 간의 매핑을 능숙하게 처리하여 다양한 데이터 전송 요구에 대한 다재다능한 솔루션을 제공합니다.

예제 1: 간단한 매핑

사용자 엔티티의 속성을 사용자 DTO로 매핑해야 하는 시나리오를 고려해 보십시오:

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

Public Class User
	Public Property FirstName() As String
	Public Property LastName() As String
	Public Property Address() As String
	Public Property City() As String
End Class

Public Class UserDTO
	Public Property FullName() As String
	Public Property Address() As String
	Public Property City() As String
End Class

' Mapping Configuration
Private config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of User, UserDTO)().ForMember(Function(dest) dest.FullName, Function(opt) opt.MapFrom(Function(src) src.FirstName & " " & src.LastName))
End Sub)
Private mapper As IMapper = config.CreateMapper()
Private user As New User With {
	.FirstName = "John",
	.LastName = "Doe",
	.Address = "123 Street",
	.City = "CityName"
}
Private userDto As UserDTO = mapper.Map(Of UserDTO)(user)

• 이 예제는 User과 UserDTO 간의 매핑을 보여주며, UserDTO의 FullName은 User의 FirstName과 LastName의 연결입니다.

예제 2: 복잡한 객체로 고급 매핑

보다 복잡한 시나리오에서 중첩된 사용자 정보를 가진 주문 객체를 단순화된 주문 DTO로 매핑해 보십시오:

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

Public Class Order
	Public Property OrderedBy() As User
	' Other properties...
End Class

Public Class OrderDTO
	Public Property FullName() As String
	' Other properties...
End Class

' Mapping Configuration
Private config = New MapperConfiguration(Sub(cfg)
	cfg.CreateMap(Of Order, OrderDTO)().ForMember(Function(dest) dest.FullName, Function(opt) opt.MapFrom(Function(src) src.OrderedBy.FirstName & " " & src.OrderedBy.LastName))
End Sub)
Private mapper As IMapper = config.CreateMapper()
Private order As New Order With {
	.OrderedBy = New User With {
		.FirstName = "Jane",
		.LastName = "Doe"
	}
}
Private orderDto As OrderDTO = mapper.Map(Of OrderDTO)(order)

• 이 예제는 중첩된 OrderedBy 세부 정보를 포함한 Order 객체에서 평면 OrderDTO으로 매핑하여 사용자 이름을 단일 FullName 속성에 추출하고 결합하는 방법을 보여줍니다.

버전 9.0에서는 AutoMapper가 정적 API (Mapper.Initialize)에서 인스턴스 기반 API로 전환되었습니다. 이 변화는 유연성을 향상시키며 특히 의존성 주입을 사용하는 현대 애플리케이션에 더 적합합니다. 9.0 미만의 버전을 사용하는 경우 정적 API 방식을 사용할 수 있습니다. 그러나 최신 버전의 경우 위의 예제에 설명된 인스턴스 기반 API를 채택하는 것이 권장됩니다.

Iron Software Suite의 주요 구성 요소

1. IronPDF PDF 관리 : 이 구성 요소는 개발자가 PDF를 생성, 읽기, 편집, 서명할 수 있게 합니다. 웹 기반 데이터를 사용하여 보고서나 문서를 생성하는 데 특히 유용한 HTML PDF 변환 기능도 제공합니다.

   

2. IronXL Excel 파일 처리: IronXL은 Office Interop 없이도 Excel 파일을 다룰 수 있게 하여 데이터 조작 및 분석 작업을 간소화합니다.

   

3. IronOCR for 텍스트 추출: 125개 이상의 다양한 언어를 지원하여 이미지에서 텍스트를 추출할 수 있게 해, 국제 프로젝트에 매우 다재다능합니다.

   

4. IronBarcode for QR 및 바코드 지원: QR 코드와 바코드를 읽고 작성할 수 있게 하여 재고 관리, 추적, 기타 관련 작업의 기능을 확장합니다.

Automapper와의 상호 보완성

C#의 다른 객체 모델 간 속성 매핑에 뛰어난 Automapper가 있는 동안, Iron Software의 라이브러리는 다양한 데이터 형식 및 유형을 처리하는 도구를 제공하여 기능을 확장합니다. 예를 들어, Automapper를 사용하여 사용자 도메인 객체를 DTO로 변환한 후, IronPDF를 사용하여 PDF 형식으로 종합 보고서를 생성할 수 있습니다. 유사하게, Automapper를 사용하여 추출하거나 변환한 데이터는 IronXL을 사용하여 Excel 파일 작업으로 추가로 조작하거나 분석할 수 있습니다.