Mapping объектов с помощью MapStruct

В огромном приложении Android с Clean Architecture много рутинной работы, связанной с отображением объектов между различными слоями. Хорошим решением будет автоматизация этого процесса.

В этой статье рассматривается опыт использования библиотеки MapStruct ^[1], которая помогает mapp-ить объекты.

Библиотека очень гибка в настройке. И позволяет минимизировать написание шаблонного кода.

Вот пример того, как реализовать gradle зависимости в вашем проекте.

plugins {
   kotlin("kapt") version "1.9.22"
}
dependencies {
   implementation("org.mapstruct:mapstruct:1.6.0")
   kapt("org.mapstruct:mapstruct-processor:1.6.0")
}

Нажмите Синхронизировать ваш проект и начнем с самого простого и элементарного примера. Допустим, у нас есть два объекта:

data class PersonResponse(
   val id: Long,
   val name: String,
   val birthday: String
)
data class Person(
   val id: Long,
   val name: String,
   val birthday: String,
)

Для создания mapper-a нам необходимо создать интерфейс:

@Mapper
interface MapperPerson {
  
    fun userResponseToUser(userResponse: PersonResponse): Person
  
companion object {
    val INSTANCE = Mappers.getMapper(MapperPerson::class.java)
   }
}

Вот и все! Mapping уже работает.

@Test
fun `test map PersonResponse to Person`() {
   val response = PersonResponse(1, "John", "2024.01.01")
   val person = MapperPerson.INSTANCE.personResponseToPerson(response)
   assert(person.name == "John")
}

Mapping вложенного объекта

Давайте рассмотрим немного более сложный случай.

data class PersonResponse(
   val id: Long,
   val name: String,
   val birthday: String,
   val educationResponse: EducationResponse
)

data class EducationResponse(
   val universityName: String
)

data class Person(
   val id: Long,
   val name: String,
   val birthday: String,
   val education: Education
)

data class Education(
   val universityName: String
)

Поэтому нам нужно изменить mapper следующим образом:

@Mapper(uses = [MapperEducation::class])
interface MapperPerson {
  
@Mapping(source = "userResponse.educationResponse", target = "education")
fun personResponseToPerson(userResponse: PersonResponse): Person

companion object {
     val INSTANCE = Mappers.getMapper(MapperPerson::class.java)
   }
}

@Mapper
interface MapperEducation {
  
   fun map(educationResponse: EducationResponse) : Education
  
}

И тест пройден.

@Test
fun `test map PersonResponse to Person`() {
    val response = PersonResponse(
        id = 1,
        name = "John",
        birthday = "2024.01.01",
        educationResponse = EducationResponse("University")
    )
    val person = MapperPerson.INSTANCE.personResponseToPerson(response)
    assert(person.name == "John")
}

В статье рассмотрены базовые случаи mapping-a с использованием библиотеки MapStruct. Более сложные случаи будут рассмотрены в следующих статьях. Спасибо за внимание!