In der Softwareentwicklung ist das Mapping von Datenstrukturen eine g\u00e4ngige Anforderung, insbesondere in Anwendungen, die Daten zwischen verschiedenen Schichten austauschen. Java-Entwickler stehen h\u00e4ufig vor der Herausforderung, komplexe Objekte von einer Form in eine andere zu transformieren. Dabei kann es sich beispielsweise um die Umwandlung von Datenbankentit\u00e4ten in DTOs (Data Transfer Objects) handeln oder um die Transformation von API-Requests in Dom\u00e4nenobjekte.<\/p>\n\n\n\n
Um diesen Prozess effizienter und weniger fehleranf\u00e4llig zu gestalten, bietet die Mapstruct-Library eine leistungsstarke und flexible L\u00f6sung. Mapstruct ist eine Java-basierte Annotation-Processor-Bibliothek, die zur Kompilierzeit Mapping-Code generiert. In diesem Artikel werden wir die grundlegenden Konzepte von Mapstruct, deren Konfiguration und einige erweiterte Funktionen durchgehen.<\/p>\n\n\n\n
Mapstruct zielt darauf ab, den m\u00fchsamen und fehleranf\u00e4lligen Prozess des Schreibens von Mapping-Code zu automatisieren. Dies wird durch den Einsatz von Annotationen erreicht, die an den Mapping-Schnittstellen und Methoden definiert werden. Diese Annotationen werden zur Kompilierzeit verarbeitet, um den notwendigen Code zu generieren, der die Mappings ausf\u00fchrt.<\/p>\n\n\n\n
Um Mapstruct in einem Java-Projekt zu verwenden, m\u00fcssen zun\u00e4chst die notwendigen Abh\u00e4ngigkeiten in der F\u00fcr Gradle sieht die Konfiguration \u00e4hnlich aus:<\/p>\n\n\n Ein grundlegendes Beispiel f\u00fcr einen Mapper k\u00f6nnte die Transformation zwischen einem Nun definieren wir ein Mapper-Interface, das Mapstruct verwendet, um die Konvertierung durchzuf\u00fchren:<\/p>\n\n\n Durch die Annotation Die Verwendung des generierten Mappers ist unkompliziert:<\/p>\n\n\n Neben den grundlegenden Mappings bietet Mapstruct eine Reihe erweiterter Funktionen, um komplexere Anforderungen abzudecken.<\/p>\n\n\n\n Manchmal erfordern Mappings benutzerdefinierte Logik oder spezifische Anpassungen. Dies kann durch die Verwendung von In diesem Beispiel wird das F\u00fcr komplexere Transformationen kann die Auch Standardwerte k\u00f6nnen gesetzt werden, falls ein Quellfeld null ist:<\/p>\n\n\n Mapstruct unterst\u00fctzt auch das Mapping von Collections wie Listen und Sets:<\/p>\n\n\n Bei verschachtelten Objekten kann Mapstruct automatisch die entsprechenden Unterobjekte mappen:<\/p>\n\n\n In diesem Beispiel werden die Felder des verschachtelten Manchmal ist es notwendig, zus\u00e4tzliche Logik vor oder nach dem Mapping-Prozess auszuf\u00fchren. Hierf\u00fcr bietet Mapstruct die Mapstruct ist eine leistungsstarke Bibliothek, die den Aufwand f\u00fcr das Schreiben und Pflegen von Mapping-Code erheblich reduziert. Durch die Annotation-basierte Konfiguration und die automatische Codegenerierung zur Kompilierzeit wird der Mapping-Prozess nicht nur schneller, sondern auch weniger fehleranf\u00e4llig. Die Unterst\u00fctzung f\u00fcr komplexe Mappings, benutzerdefinierte Logik und Erweiterbarkeit machen Mapstruct zu einer wertvollen Erg\u00e4nzung im Werkzeugkasten eines jeden Java-Entwicklers.<\/p>\n\n\n\n Obwohl dieser Artikel nur die grundlegenden und einige erweiterte Funktionen von Mapstruct behandelt, gibt es noch viele weitere Aspekte zu entdecken, wie die Integration mit anderen Frameworks, komplexere Mapping-Strategien und Optimierungen. Entwickler sind daher eingeladen, die offizielle Dokumentation und weitere Ressourcen zu konsultieren, um das volle Potenzial von Mapstruct auszusch\u00f6pfen.<\/p>\n","protected":false},"excerpt":{"rendered":" Einleitung In der Softwareentwicklung ist das Mapping von Datenstrukturen eine g\u00e4ngige Anforderung, insbesondere in Anwendungen, die Daten zwischen verschiedenen Schichten austauschen. Java-Entwickler stehen h\u00e4ufig vor der Herausforderung, komplexe Objekte von einer Form in eine andere zu transformieren. Dabei kann es sich beispielsweise um die Umwandlung von Datenbankentit\u00e4ten in DTOs (Data Transfer Objects) handeln oder um […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-463","post","type-post","status-publish","format-standard","hentry","category-plain_java"],"_links":{"self":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/463","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=463"}],"version-history":[{"count":1,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/463\/revisions"}],"predecessor-version":[{"id":464,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/463\/revisions\/464"}],"wp:attachment":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=463"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=463"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}pom.xml<\/code> (f\u00fcr Maven) oder build.gradle<\/code> (f\u00fcr Gradle) hinzugef\u00fcgt werden. Ein Beispiel f\u00fcr Maven:<\/p>\n\n\n<dependency<\/span>><\/span>\n <groupId<\/span>><\/span>org.mapstruct<\/groupId<\/span>><\/span>\n <artifactId<\/span>><\/span>mapstruct<\/artifactId<\/span>><\/span>\n <version<\/span>><\/span>1.5.0<\/version<\/span>><\/span>\n<\/dependency<\/span>><\/span>\n<dependency<\/span>><\/span>\n <groupId<\/span>><\/span>org.mapstruct<\/groupId<\/span>><\/span>\n <artifactId<\/span>><\/span>mapstruct-processor<\/artifactId<\/span>><\/span>\n <version<\/span>><\/span>1.5.0<\/version<\/span>><\/span>\n <scope<\/span>><\/span>provided<\/scope<\/span>><\/span>\n<\/dependency<\/span>><\/span><\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\nimplementation 'org.mapstruct:mapstruct:1.5.0'<\/span>\nannotationProcessor 'org.mapstruct:mapstruct-processor:1.5.0'<\/span><\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nErstellen von Mapper-Interfaces<\/h5>\n\n\n\n
User<\/code>-Entit\u00e4t und einem UserDTO<\/code> sein. Zuerst definieren wir die beiden Klassen:<\/p>\n\n\npublic<\/span> class<\/span> User<\/span> <\/span>{\n private<\/span> Long id;\n private<\/span> String name;\n private<\/span> String email;\n \/\/ Getter und Setter<\/span>\n}\n\npublic<\/span> class<\/span> UserDTO<\/span> <\/span>{\n private<\/span> Long id;\n private<\/span> String name;\n \/\/ Getter und Setter<\/span>\n}<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nimport<\/span> org.mapstruct.Mapper;\nimport<\/span> org.mapstruct.factory.Mappers;\n\n@Mapper\npublic interface UserMapper {\n UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);\n\n UserDTO userToUserDTO(User user);\n User userDTOToUser(UserDTO userDTO);\n}<\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n@Mapper<\/code> und die Methode Mappers.getMapper(UserMapper.class)<\/code> wird Mapstruct angewiesen, die Implementierung dieses Interfaces zur Kompilierzeit zu generieren.<\/p>\n\n\n\nNutzung des Mappers<\/h5>\n\n\n\n
public<\/span> class<\/span> UserService<\/span> <\/span>{\n public<\/span> UserDTO getUserDTO(User user) {\n return<\/span> UserMapper.INSTANCE.userToUserDTO(user);\n }\n}<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nErweiterte Mapstruct-Funktionen<\/h4>\n\n\n\n
Anpassung von Mappings<\/h5>\n\n\n\n
@Mapping<\/code>-Annotationen erreicht werden:<\/p>\n\n\nimport<\/span> org<\/span>.mapstruct<\/span>.Mapping<\/span>;\n\n@Mapper<\/span>\npublic interface UserMapper {\n @Mapping<\/span>(source = \"email\"<\/span>, target = \"contactEmail\"<\/span>)\n UserDTO userToUserDTO(User user);\n}<\/code><\/span>Code-Sprache:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nemail<\/code>-Feld des User<\/code>-Objekts auf das contactEmail<\/code>-Feld des UserDTO<\/code>-Objekts gemappt.<\/p>\n\n\n\nVerwendung von Expression und Default Values<\/h5>\n\n\n\n
expression<\/code>-Eigenschaft der @Mapping<\/code>-Annotation verwendet werden:<\/p>\n\n\n@Mapping<\/span>(target = \"fullName\"<\/span>, expression = \"java(user.getFirstName() + ' ' + user.getLastName())\"<\/span>)\nUserDTO userToUserDTO(User user);<\/code><\/span>Code-Sprache:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n@Mapping<\/span>(target = \"status\"<\/span>, defaultValue = \"ACTIVE\"<\/span>)\nUserDTO userToUserDTO(User user);<\/code><\/span>Code-Sprache:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nCollection Mappings<\/h5>\n\n\n\n
@Mapper\npublic<\/span> interface<\/span> UserMapper<\/span> <\/span>{\n List<\/span><UserDTO> usersToUserDTOs(List<\/span><User> users);\n}<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nNested Mappings<\/h5>\n\n\n\n
public<\/span> class<\/span> Address<\/span> <\/span>{\n private<\/span> String street;\n private<\/span> String city;\n \/\/ Getter und Setter<\/span>\n}\n\npublic<\/span> class<\/span> User<\/span> <\/span>{\n private<\/span> Long id;\n private<\/span> String name;\n private<\/span> Address address;\n \/\/ Getter und Setter<\/span>\n}\n\npublic<\/span> class<\/span> UserDTO<\/span> <\/span>{\n private<\/span> Long id;\n private<\/span> String name;\n private<\/span> String street;\n private<\/span> String city;\n \/\/ Getter und Setter<\/span>\n}\n\n@Mapper\npublic<\/span> interface<\/span> UserMapper<\/span> <\/span>{\n @Mapping(source = \"address.street\"<\/span>, target = \"street\"<\/span>)\n @Mapping(source = \"address.city\"<\/span>, target = \"city\"<\/span>)\n UserDTO userToUserDTO(User user);\n}<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nAddress<\/code>-Objekts auf die entsprechenden Felder im UserDTO<\/code> gemappt.<\/p>\n\n\n\nVor- und Nachbearbeitungsmethoden<\/h5>\n\n\n\n
@BeforeMapping<\/code> und @AfterMapping<\/code>-Annotationen:<\/p>\n\n\n@Mapper<\/span>\npublic interface UserMapper {\n\n @AfterMapping<\/span>\n default void afterMapping(User user, @MappingTarget UserDTO userDTO) {\n userDTO<\/span>.setFullName<\/span>(user<\/span>.getFirstName<\/span>() + \" \" + user<\/span>.getLastName<\/span>());\n }\n}<\/code><\/span>Code-Sprache:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nFazit<\/h4>\n\n\n\n