Kotlin Object Multiplatform Mapper

data class DestinationObject(     val id: Int,     val stringToInt: Int ) {     var intToString: String = "" }

Чтобы отобразить одно в другое, достаточно пометить класс-приёмник аннотацией KOMMMap:

@KOMMMap(from = SourceObject::class) data class DestinationObject(     val id: Int,     val stringToInt: Int ) {     var intToString: String = "" }

В результате будет сгенерирован вот такой метод-расширение:

fun SourceObject.toDestinationObject(): DestinationObject = DestinationObject(     id = id,     stringToInt = stringToInt.toInt() ).also {      it.intToString = intToString.toString() }

Feature of KOMM

Как можно заметить @KOMMMap( from = SourceObject::class, config = MapConfiguration( tryAutoCast = false ) )

В результате, при попытки отображения свойств без использования конвертера (о нем ниже), будет брошено исключение.

Конечно часто надо отображать свойства с одними именами в свойства с другими. Для этого в KOMM есть MapFrom аннотация:

class SourceObject {     //...     val userName = "user" }  @KOMMMap(from = SourceObject::class) data class DestinationObject(     //...     @MapFrom("userName")     val name: String )

Важное замечание!

KOMM поддерживает multimapping — когда в один класс можно отображать из нескольких. В этом случае для аннотаций полей можно указывать, для какого именно класса-источника применять кастомизацию:

@KOMMMap(     from = FirstSourceObject::class ) @KOMMMap(     from = SecondSourceObject::class ) data class DestinationObject(     @MapFrom("userId", [SecondSourceObject::class])     val id: Int )

Для остальных будут применяться настройки по умолчанию.

Для особого конвертирования можно использовать конвертер. Например:

class CostConverter(source: SourceObject) : KOMMConverter<SourceObject, Double, String>(source) {      override fun convert(sourceMember: Double) = "$sourceMember ${source.currency}" }  class SourceObject {     val cost = 499.99 }  @KOMMMap(from = SourceObject::class) data class DestinationObject(     @MapConvert<SourceObject, CostConverter>(CostConverter::class)     val cost: String ) {     @MapConvert<SourceObject, CostConverter>(CostConverter::class, "cost")     var otherCost: String = "" }

У конвертеров в качестве указателя, для какого именно источника применить аннотацию, выступает generic тип.

В результате, будет сгенерирован такой метод:

fun SourceObject.toDestinationObject(): DestinationObject = DestinationObject(     cost = CostConverter(this).convert(cost) ).also {      it.otherCost = CostConverter(this).convert(cost) }

Как видно, весь объект-источник передается как свойство класса конвертера, а в метод конвертации передается еще и свойство-источник.

В случае, если свойство, объявленное через конструктор, не может быть получено из объекта-источника, его нужно пометить аннотацией с resolver’ом. Аннотацию можно применять и к свойствам, объявленным вне конструктора:

class DateResolver(destination: DestinationObject?) : KOMMResolver<DestinationObject, Date>(destination) {          override fun resolve(): Date = Date.from(Instant.now()) }  @KOMMMap(from = SourceObject::class) data class DestinationObject(     @MapDefault<DateResolver>(DateResolver::class)     val activeDate: Date ) {     @MapDefault<DateResolver>(DateResolver::class)     var otherDate: Date = Date.from(Instant.now()) }

На выходе будет:

fun SourceObject.toDestinationObject(): DestinationObject = DestinationObject(     activeDate = DateResolver(null).resolve() ).also {      it.otherDate = DateResolver(it).resolve() }

Обратите внимание, что в качестве параметра конструктора resolver’а мы получаем либо null — если отображаемое свойство объявлено в конструкторе, либо же уже существующий объект-приёмник.

Так же поддерживается null substitute:

class IntResolver(destination: DestinationObject?): KOMMResolver<DestinationObject, Int>(destination) {      override fun resolve() = 1 }  data class SourceObject(     val id: Int? )  @KOMMMap(     from = SourceObject::class ) data class DestinationObject(     @NullSubatitute(MapDefault(IntResolver::class))     val id: Int ) {     @NullSubatitute(MapDefault(IntResolver::class), "id")     var otherId: Int = 0 }  //...  fun SourceObject.toDestinationObject(): DestinationObject = DestinationObject(     id = id ?: IntResolver(null).resolve() ).also {     it.otherId = id ?: IntResolver(it).resolve() }