https://github.com/jesty/mapstrukt
Improved Mapstruct support for Kotlin
https://github.com/jesty/mapstrukt
Last synced: 2 months ago
JSON representation
Improved Mapstruct support for Kotlin
- Host: GitHub
- URL: https://github.com/jesty/mapstrukt
- Owner: jesty
- License: apache-2.0
- Created: 2019-04-03T21:27:07.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-04-24T13:35:48.000Z (about 6 years ago)
- Last Synced: 2025-01-25T21:11:31.299Z (4 months ago)
- Language: Kotlin
- Homepage:
- Size: 168 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.adoc
- License: LICENSE
Awesome Lists containing this project
README
# Mapstrukt
This project aims to improve the support of http://mapstruct.org/[Mapstruct] to Kotlin.
This is a simple code generator that works beside the http://mapstruct.org/[Mapstruct] code generation, in order to add some extension functions to entities converted using http://mapstruct.org/[Mapstruct].
So, you can use the converter method you definied, already on the source entity:
[source,kotlin]
----
val person = Person("Samuel", "Jackson", "0123 334466", LocalDate.of(1948, 12, 21))
val personDto = person.convertToDto
----
instead of:
[source,kotlin]
----
val person = Person("Samuel", "Jackson", "0123 334466", LocalDate.of(1948, 12, 21))
val converter = Mappers.getMapper(PersonConverter::class.java)
val personDto = converter.convertToDto(person)
----
*Under the hood* what the generator does is to generate a Kotlin Object with some extension function, for instance, in the example above the generator creates:
[source,kotlin]
----
package com.github.jesty
import org.mapstruct.example.kotlin.dto.PersonDto
import org.mapstruct.example.kotlin.model.Person
object Mapstrukt {
fun org.mapstruct.example.kotlin.model.Person.convertToDto(): PersonDto = org.mapstruct.factory.Mappers.getMapper(org.mapstruct.example.kotlin.converter.PersonConverter::class.java).convertToDto(this)
}
----
The example project in `mapstrukt-example` folder is copied from https://github.com/mapstruct/mapstruct-examples/tree/master/mapstruct-kotlin-gradle.
# Code generator setup
The generator isn't available in any Maven repository, so you need to install it locally running in `mapstrukt` folder:
----
./gradlew build
----
After you can configure your plugin as shown below:
.build.gradle.kts
[source,kotlin]
----
import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
plugins {
kotlin("jvm") version "1.2.71"
kotlin("kapt") version "1.2.71"
}
group = "org.mapstruct.examples"
version = "1.0.0-SNAPSHOT"
repositories {
mavenLocal()
mavenCentral()
}
dependencies {
compile(kotlin("stdlib-jdk8"))
compile("org.mapstruct:mapstruct:1.3.0.Final")
kapt("org.mapstruct:mapstruct-processor:1.3.0.Final")
kapt("com.github.jesty:mapstrukt:1.0.0-SNAPSHOT")
testCompile("org.junit.jupiter:junit-jupiter-api:5.3.1")
testCompile("org.junit.jupiter:junit-jupiter-engine:5.3.1")
testCompile("org.assertj:assertj-core:3.11.1")
}
tasks.withType {
kotlinOptions.jvmTarget = "1.8"
}
val test by tasks.getting(Test::class) {
useJUnitPlatform { }
}
----