Sono diversi i motivi per cui in una applicazione si ha la necessità di effettuare la copia di un bean. Ad esempio potrebbe essere necessario integrarsi con sistemi esterni e non si vuole esporre l’intero oggetto perché alcune proprietà non sono necessarie o devono rimanere riservate (si pensi alla password di un utente). Oppure l’oggetto sorgente potrebbe non essere serializzabile. Oppure ancora potrebbe essere caratterizzato da molte proprietà, sia di tipo primitivo che complesse, generando bean annidati con profondità non trascurabile.

In queste situazioni l’esecuzione della copia del bean può essere fatta programmando un convertitore apposito per ogni bean da convertire oppure utilizzando un framework,  come ad esempio Dozer, semplificando notevolmente la generazione del codice. Dozer è un framework di mapping JavaBean-to-JavaBean  che esegue la copia in modo ricorsivo degli oggetti, eseguendo, quando necessario, la conversione automatica tra tipi. Il tutto utilizzando un approccio dichiarativo per mezzo di un file XML di configurazione (quando necessario).

Un Primo Semplice Progetto

Utilizziamo un semplice progetto java di test generato con Maven senza selezionare alcun archetype ed inseriamo la dipendenza a Dozer.

Implementiamo quindi le due classi sorgente e destinazione del mapping, per ora avendo cura di mantenere lo stesso nome per le proprietà ma utilizzando tipi differenti:

Source.java Java public class Source { private String sourceStringForInteger; private String sourceStringForLong; private String sourceStringForint; private String sourceStringForString; private SubSource subSource; /* Getter and setter */ } 1 2 3 4 5 6 7 8 9 public class Source {     private String sourceStringForInteger;     private String sourceStringForLong;     private String sourceStringForint;     private String sourceStringForString;     private SubSource subSource;       /* Getter and setter */ }

Destination.java Java public class Destination { private Integer sourceStringForInteger; private Long sourceStringForLong; private int sourceStringForint; private String sourceStringForString; private SubDestination subDestination; /* Getter and setter */ } 1 2 3 4 5 6 7 8 9 public class Destination {     private Integer sourceStringForInteger;     private Long sourceStringForLong;     private int sourceStringForint;     private String sourceStringForString;     private SubDestination subDestination;       /* Getter and setter */ }

SubSource.java Java public class SubSource { private Integer property1; private Boolean property2; /* Getter and setter */ } 1 2 3 4 5 6 public class SubSource {     private Integer property1;     private Boolean property2;     /* Getter and setter */ }

SubDestination.java Java public class SubDestination { private Integer property1; private Boolean property2; /* Getter and setter */ } 1 2 3 4 5 6 public class SubDestination {     private Integer property1;     private Boolean property2;          /* Getter and setter */ }

Per semplicità non sono state riportati i costruttori ed i metodi toString() delle quattro classi che comunque sono stati generati con i relativi tool di eclipse e che troverete nel codice sorgente.  Rammentare comunque che tutte e quattro el classi devono sempre avere un costruttore senza parametri.  Altrimenti verrà sollevata una eccezione del tipo:

Exception in thread "main" org.dozer.MappingException: java.lang.NoSuchMethodException: it.javaboss.model.Destination.<init>()

Implementiamo quindi la classe DozerMain contenente il main per l’esecuzione del mapping:

Eseguendo il main l’effetto sarà:

Dall’analisi dell’output si nota che tutte le proprietà con lo stesso nome nelle due classi non solo sono state correttamente mappate ma hanno anche subito la conversione del tipo in entrambe le direzioni della conversione. Le proprietà subDestination e subSource. invece, non sono state mappate avendo nomi differenti.

Mapping via XML

Per situazioni più complesse di mapping è necessario utilizzare un file XML descrittivo di corrispondenza tra le proprietà delle due classi oggetto del mapping. Il file è ovviamente valido sia in un senso del mapping che nel senso opposto. Creiamo quindi il file mapping.xml e posizioniamolo nella cartella resources del nostro progetto Mavem. Il file avrà il seguente aspetto:

Il costruttore della classe DozerBeanMapper accetta come parametro un array di stringhe corrispondenti ai nomi dei file di mapping, che verranno ricercati dal framework in tutto il classpath del progetto. L’inizializzazione della classe per il nostro esempio sarà quindi:

Utilizzo dell’IoC

In generale è preferibile avere una istanza del Dozer mapper per VM. Tale situazione è realizzabile in modo semplice utilizzando un framework IoC, come ad esempio Spring, opportunamente configurato in modo da istanziare il mapper in modalità singleton. Eventualmente il framework dispone di una classe di utilità che restituisce il singleton attraverso l’esecuzione di DozerBeanMapperSingletonWrapper.getInstance().

Codice Sorgente

Il codice sorgente dell’esempio e scaricabile qui dozer.