Cómo mapear objetos en Java con MapStruct

MapStruct es un generador de código que simplifica la implementación de mapeos entre objetos de Java permitiendo realizar este proceso de forma rápida y sencilla. Comúnmente en aplicaciones multicapa de Java se suele requerir mapear diferentes modelos de objetos, por ejemplo, entidades y DTO. Si se realiza de una manera manual puede ser tedioso y propenso a errores. Este es el propósito de MapStruct, simplificar el proceso de mapeo entre objetos. A diferencia de otras librerías, MapStruct genera los mapeos en tiempo de compilación, lo que permite un mejor rendimiento y una comprobación de errores más rápida.

MapStruct al ser un procesador de anotaciones se puede utilizar desde la línea de comandos usando Maven o Gradle, así como desde un IDE como IntelliJ IDEA o Eclipse.

Instalación

Para este ejemplo vamos a utilizar Maven, por lo que es necesario agregar lo siguiente al archivo pom.xml.


<span><properties></span>
    <span><org.mapstruct.version></span>1.6.3<span></org.mapstruct.version></span>
<span></properties></span>
<span><dependencies></span>
    <span><dependency></span>
        <span><groupId></span>org.mapstruct<span></groupId></span>
        <span><artifactId></span>mapstruct<span></artifactId></span>
        <span><version></span>${org.mapstruct.version}<span></version></span>
    <span></dependency></span>
<span></dependencies></span>
<span><build></span>
    <span><plugins></span>
        <span><plugin></span>
            <span><groupId></span>org.apache.maven.plugins<span></groupId></span>
            <span><artifactId></span>maven-compiler-plugin<span></artifactId></span>
            <span><version></span>3.8.1<span></version></span>
            <span><configuration></span>
                <span><source></span>1.8<span></source></span> <span><!-- Dependiendo de tu proyecto --></span>
                <span><target></span>1.8<span></target></span> <span><!-- Dependiendo de tu proyecto --></span>
                <span><annotationProcessorPaths></span>
                    <span><path></span>
                        <span><groupId></span>org.mapstruct<span></groupId></span>
                        <span><artifactId></span>mapstruct-processor<span></artifactId></span>
                        <span><version></span>${org.mapstruct.version}<span></version></span>
                    <span></path></span>
                    <span><!-- Otras dependencias de procesadores de anotaciones --></span>
                <span></annotationProcessorPaths></span>
            <span></configuration></span>
        <span></plugin></span>
    <span></plugins></span>
<span></build></span>
<span><properties></span>
    <span><org.mapstruct.version></span>1.6.3<span></org.mapstruct.version></span>
<span></properties></span>

<span><dependencies></span>
    <span><dependency></span>
        <span><groupId></span>org.mapstruct<span></groupId></span>
        <span><artifactId></span>mapstruct<span></artifactId></span>
        <span><version></span>${org.mapstruct.version}<span></version></span>
    <span></dependency></span>
<span></dependencies></span>

<span><build></span>
    <span><plugins></span>
        <span><plugin></span>
            <span><groupId></span>org.apache.maven.plugins<span></groupId></span>
            <span><artifactId></span>maven-compiler-plugin<span></artifactId></span>
            <span><version></span>3.8.1<span></version></span>
            <span><configuration></span>
                <span><source></span>1.8<span></source></span> <span><!-- Dependiendo de tu proyecto --></span>
                <span><target></span>1.8<span></target></span> <span><!-- Dependiendo de tu proyecto --></span>
                <span><annotationProcessorPaths></span>
                    <span><path></span>
                        <span><groupId></span>org.mapstruct<span></groupId></span>
                        <span><artifactId></span>mapstruct-processor<span></artifactId></span>
                        <span><version></span>${org.mapstruct.version}<span></version></span>
                    <span></path></span>
                    <span><!-- Otras dependencias de procesadores de anotaciones --></span>
                <span></annotationProcessorPaths></span>
            <span></configuration></span>
        <span></plugin></span>
    <span></plugins></span>
<span></build></span>
<properties>
    <org.mapstruct.version>1.6.3</org.mapstruct.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${org.mapstruct.version}</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source> <!-- Dependiendo de tu proyecto -->
                <target>1.8</target> <!-- Dependiendo de tu proyecto -->
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                    <!-- Otras dependencias de procesadores de anotaciones -->
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>