Einfache Bean-Mappings mit MapStruct 1.2

Transkript

1 t Frankfurt am Main Thomas Much Einfache Bean-Mappings mit MapStruct #ittage

2 Wer steht hier vorne? Thomas Much Agile Developer Coach & XP Coder (Java et al.) Mag coole kleine Tools & Libs (und erzählt gerne darüber #ittage

3 Java und Beans, eine lange Geschichte Form JPA Typsicheres, Beans DTOs POJOs Entities schnelles Bean-Mapping! JavaBeans JAXB Entities

4 Klassische Architekturen (J2EE)

5 Was Java EE & Co. versprechen

6 Die Realität

7 Moderne Realität! Domain Model A Transport Model A Domain Model B Bounded Context A Bounded Context B

8 Das = "CUSTOMERS") public class Customer { public class CustomerDTO Long id; long id; long customerid; String customerid; String name; String Title title; String title; getters and setters! getters and setters!

9 kann aufwendig werden DTO JPA Entity REST Entity JAXB Entity View Bean

10 Mapping-Implementation wie? Selber programmieren Alle Getter/Setter von Hand aufrufen Eigene Reflection-Routinen Reflection-basierte Bibliotheken: Apache BeanUtils, Dozer, Probleme: Aufwand, fehlende Typsicherheit, Performance

11 Performance Performance!

12 Annotationsprozessor, der Mapping-Code (Quelltext!) generiert. Keine Reflection! Typsicher und schnell. Mind. Java 6, spezielle Unterstützung für Java 8+ Minimale Laufzeitabhängigkeit (< 20 K) bzw. gar keine (je nach Komponentenmodell)

13 Versionen MapStruct 1.0 (2015) MapStruct 1.1 (2016) MapStruct 1.2 (2017)

14 JARs (Dependencies) Java 8+ Java 6 / 7 Java 6+, unnötig zur Laufzeit

15 Beispiel JPA-Entity = "CUSTOMERS") public class Customer { public class CustomerDTO Long id; long id; long customerid; String customerid; String name; String Title title; getters and setters! Alle public-properties sollen gemappt werden (auch aus Oberklassen) String title; getters and setters!

16 Wünsch dir was! public interface CustomerMapper { CustomerDTO customer2dto(customer customer);

17 Wünsch dir = "cdi") public interface CustomerMapper { CustomerDTO customer2dto(customer private CustomerMapper mapper; CustomerDTO dto = mapper.customer2dto( customer );

18 Die Implementation generieren Wie erzeugen wir aus dem Interface die Mapping-Implementation? Speichern z.b. in Eclipse. Genauer: Compiler aufrufen (z.b. via Maven/Gradle) Annotationsprozessor erledigt den Rest! Live Demo

19 @Generated( value = "org.mapstruct.ap.mappingprocessor", date = " T16:41: ", Generierter Quelltext comments = "version: Beta3, compiler: Eclipse JDT (IDE)..." public class CustomerMapperImpl implements CustomerMapper public CustomerDTO customer2dto(customer customer) { if (customer == null) { return null; Thread-sicher. CustomerDTO customerdto = new CustomerDTO(); customerdto.setcustomerid(string.valueof(customer.getcustomerid())); if (customer.getid()!= null) { customerdto.setid(string.valueof(customer.getid())); Clean Code. Leicht zu lesen. customerdto.setname(customer.getname()); if (customer.gettitle()!= null) { return customerdto; sind optional

20 Kein Injection-Container? Kein public interface CustomerMapper { CustomerMapper INSTANCE = Mappers.getMapper( CustomerMapper.class ); CustomerDTO customer2dto(customer customer); CustomerDTO dto = CustomerMapper.INSTANCE.customer2DTO( customer );

21 Typ- (& Wert-) Sicherheit WARN / ERROR / IGNORE Policy global setzen oder pro Mapper (oder Default verwenden)

22 Grundlegende public interface dateformat="dd.mm.yyyy") ) CustomerDTO customer2dto(customer customer);

23 Enum-Werte public interface CustomerMapper source="<any_unmapped>") DtoTitle title2dtotitle(title title); CustomerDTO customer2dto(customer customer); Siehe MappingConstants

24 Viele implizite Umwandlungen Primitive Datentypen Wrapper (inkl. null-checks) Number-Typen (incl. Big ) andere Number-Typen & Präzisionen String so ziemlich alles (inkl. Enums & Date/Number-Formate) Date/Calendar Joda Java 8 Date/Time JAXB Elemente, Collections

25 public interface CustomerMapper { CustomerDTO customer2dto(customer public class Customer { Das ist alles! Address address; other properties getters and setters!

26 Referenz-Mapping public interface CustomerMapper { CustomerDTO customer2dto(customer customer); AddressDTO address2dto(address address);

27 Andere Mapper public interface CustomerMapper { CustomerDTO customer2dto(customer public interface AddressMapper { AddressDTO address2dto(address address);

28 Eigener public interface CustomerMapper { CustomerDTO customer2dto(customer customer); default AddressDTO address2dto(address address) { AdressDTO dto = new AddressDTO(); custom mapping code return dto; Alternativ mit einer abstrakten Klasse

29 Alten Mapping-Code public interface CustomerMapper { CustomerDTO customer2dto(customer customer); public class LegacyAddressMapper { public AddressDTO address2dto(address address) { custom mapping code return dto; Default Constructor oder statische Mapping- Methode nötig.

30 Mehrere public interface PrintLabelMapper source="address.city") PrintLabelDTO customeraddress2dto( Customer customer, Address address); Pfad-Ausdrücke können generell in "source" und "target" verwendet werden.

31 Updates & public interface CustomerMapper { CustomerDTO customer2dto(customer customer); Alternativ void updatecustomerdto(customer CustomerDTO dto); Target-Typ als Max. Rückgabe Customer dto2customer(customerdto dto);

32 Mappings public interface CustomerMapper ) CustomerDTO customer2dto(customer void updatecustomerdto(customer CustomerDTO Customer dto2customer(customerdto dto);

33 Context-Parameter Aufruf eigenem Code public interface CustomerMapper { CustomerDTO customer2dto(customer Locale locale); Wird in der generierten Implementation durchgereicht! AddressDTO address2dto(address Locale locale);

34 Eigene Mapper mit public class JpaEntityMapper private EntityManager manager; public <T extends BaseEntity> T resolve(long Class<T> entityclass) { return (id!= null)? manager.find(entityclass, id) : null;

35 Bean-Fabriken public class DtoFactory { public CustomerDTO createcustomerdto() { return new CustomerDTO(); public class EntityFactory { public <T extends BaseEntity> T createentity(@targettype Class<T> entityclass) { return entityclass.newinstance();

36 Streams & Collections von public interface CustomerMapper { CustomerDTO customer2dto(customer customer); List<CustomerDTO> list2list(list<customer> customer); List<CustomerDTO> array2list(customer[] customer); CustomerDTO[] set2array(set<customer> customer); List<CustomerDTO> stream2list(stream<customer> cust); Stream<CustomerDTO> set2stream(set<customer> cust);

37 Streams & Collections von public interface StreamCollectionMapper { Set<Long> int2long(stream<integer> stream); Stream<Long> int2long(list<integer> List<String> date2string(list<date> Map<String,String> map2map(map<long,date> map);

38 Exceptions Jede Checked Exception, die nicht an der Mapping-Methode deklariert ist, wird als RuntimeException weitergeworfen.

39 In Mapping-Aufrufe wird mitgeliefert aber besser CDI-Decorators verwenden.

40 MapStruct SPI Accessor Naming Strategy (Zugriffsmethoden) anpassen z.b. Fluent API statt Getter/Setter Mapping-Ausnahmen Bestimmte Typen vom automatischen Mapping ausschließen

41 Viele weitere Möglichkeiten Konstante Werte & Java-Ausdrücke als "source". Default-Werte, wenn die Quelle null ist. Reihenfolge von Setter-Aufrufen ("dependson"). Angepasste null-prüfungen & Default-null-Werte. Zentrale Mapping-Konfigurationen Auswahl mehrdeutiger Mapping-Methoden per Qualifier oder Name

42 Integration in Build-Tools javac SPI MapStruct einfach auf den Classpath packen! Maven, Ant, Gradle MapStruct-Dokumentation enthält (einfache) Setup-Anleitung: MapStruct-Dependency hinzufügen, Annotationsprozessor aktivieren.

43 Eclipse Plug-in Code Completion Quick Fixes

44 IntelliJ Plug-in Code Completion Goto Declaration Find Usages

45 Neu in MapStruct 1.2 Unterstützung für Java 8 Streams. Mappings für public-felder. Automatische Generierung von Sub-Mapping-Methoden. Integration mit Project Lombok. Unterstützung für Java 9 (experimentell).

46 Lombok vs. public interface CustomerMapper { CustomerDTO customer2dto(customer public class CustomerDTO { private long id; private String customerid; private = "CUSTOMERS") public class Customer Long id; private String title; Getter und Setter!

47 Lombok vs. public interface CustomerMapper { Manipuliert AST- Bytecode CustomerDTO customer2dto(customer customer); Generiert public class CustomerDTO { private long id; private String customerid; private String = "CUSTOMERS") public class Customer Long id; private String title; Getter und Setter!

48 MapStruct Fazit Hervorragend produktiv einsetzbar! Generierter Code ist schnell, einfach und lesbar. Flexible (Custom-)Mappings. Einfache Einbindung in div. Komponentenmodelle. Ausführliche und gut geschriebene Dokumentation.

49 Neugierig geworden?

50 Die Entwickler: Danke!

51 t Frankfurt am Main Vielen Dank! #ittage