mapstruct-kotlin-builder

KotlinBuilder annotation for plugin for mapstruct

License	MIT License
Categories	Kotlin Languages MapStruct General Purpose Libraries Bean Mapping
GroupId	com.github.pozo
ArtifactId	mapstruct-kotlin
Last Version	1.4.0.0
Release Date	Jul 25, 2020
Type	jar
Description	mapstruct-kotlin-builder KotlinBuilder annotation for plugin for mapstruct
Project URL	https://github.com/Pozo/mapstruct-kotlin
Source Code Management	https://github.com/Pozo/mapstruct-kotlin/tree/master

Download mapstruct-kotlin

Filename	Size
mapstruct-kotlin-1.4.0.0.pom
mapstruct-kotlin-1.4.0.0.jar	1 KB
mapstruct-kotlin-1.4.0.0-sources.jar	797 bytes
mapstruct-kotlin-1.4.0.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.pozo/mapstruct-kotlin/ -->
<dependency>
    <groupId>com.github.pozo</groupId>
    <artifactId>mapstruct-kotlin</artifactId>
    <version>1.4.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.pozo/mapstruct-kotlin/
implementation 'com.github.pozo:mapstruct-kotlin:1.4.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.pozo/mapstruct-kotlin/
implementation ("com.github.pozo:mapstruct-kotlin:1.4.0.0")

Apache Buildr

'com.github.pozo:mapstruct-kotlin:jar:1.4.0.0'

Apache Ivy

<dependency org="com.github.pozo" name="mapstruct-kotlin" rev="1.4.0.0">
  <artifact name="mapstruct-kotlin" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.pozo', module='mapstruct-kotlin', version='1.4.0.0')
)

Scala SBT

libraryDependencies += "com.github.pozo" % "mapstruct-kotlin" % "1.4.0.0"

Leiningen

[com.github.pozo/mapstruct-kotlin "1.4.0.0"]

Dependencies

runtime (1)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.3.72

Project Modules

There are no modules declared in this project.

mapstruct-kotlin

Since mapstruct 1.3.0.Beta2 it's possible to use builders for immutable classes. According to the documentation you can implement your custom builder provider logic. This project take advantage of this and provide a custom BuilderProvider for kotlin data classes.

So instead of this (source)

data class PersonDto(var firstName: String?, var lastName: String?, var phone: String?, var birthdate: LocalDate?) {
    // Necessary for MapStruct
    constructor() : this(null, null, null, null)
} 

We can do this

@KotlinBuilder
data class PersonDto(val firstName: String, val lastName: String, val phone: String, val birthdate: LocalDate)

With a mapper

@Mapper
interface PersonMapper {
    fun map(person: Person): PersonDto
}

Usage

First apply kapt plugin

apply plugin: 'kotlin-kapt'

Then add these to your project as dependency

api("com.github.pozo:mapstruct-kotlin:1.3.1.2")
kapt("com.github.pozo:mapstruct-kotlin-processor:1.3.1.2")

Check out the directory example for a basic usage example.

Versioning

For example in case of 1.3.1.1 the first part 1.3.1 is the mapstruct version number and the last digit 1 reserved for future patches.

Project structure

• mapstruct-kotlin-builder contains only the KotlinBuilder annotation
• mapstruct-kotlin-processor responsible for generating the builders for the kotlin data classes with the help of a custom DefaultBuilderProvider
• example responsible for demonstrating this library usage

Build and run the example application

./gradlew -p example clean build

TODO

• Map with custom types are not working
• Look over kotlin-builder-annotation project and replace with class generating module (builder-processor)
• Writing tests
• Versioning and release process

Licensing

Please see LICENSE file

Contact

Zoltan Polgar - [email protected]

Please do not hesitate to contact me if you have any further questions.

Versions

Version
1.4.0.0 Jul 25, 2020
1.3.1.2 Apr 13, 2020
1.3.1.1 Jan 19, 2020
1.3.1.0 Dec 27, 2019