Maven Project for SugarCRM Java Web Services Client
Nel corso di un precedente articolo abbiamo visto come creare un client Java per i Web Services di SugarCRM utilizzando il framework Apache CXF (versione 2.5.x), inoltre l’intero progetto creato appositamente per la stesura dell’articolo, è disponibile all’interno del repository GitHub raggiungibile all’indirizzo:
In questo periodo sono in fase di migrazione del sistema di build di una serie di progetti Java da Ant a Maven, ho approfittato quindi dell’occasione per riportare anche questo progetto del client Java di SugarCRM su Maven.
Così come fatto per il precedente progetto, ho pensato bene di pubblicare anche questo progetto convertito per Maven sul repository GitHub raggiungibile all’indirizzo:
Visto che adesso il progetto è sotto il controllo di Maven e solitamente cerco di evitare di scrivere troppo (sia linee di codice sia a linee di comando), ho fatto in modo da non dovermi preoccupare di eseguire il tool wsdl2java, tanto pensa a tutto Maven, in breve: mvn install. In pochi istanti avrete l’artifact (da utilizzare poi in altri progetti) più un semplice test del client tramite JUnit. Tanto per non far mancar nulla, ho eseguito anche il deploy del site, raggiungibile all’indirizzo:
- https://www.dontesta.it/projects/maven/sites/sugarcrmce-64-v4-soap-api/
Dato che non ho la possibilità di eseguire il deploy del progetto su di un repository pubblico e quindi facilitarvi nell’inserimento come dipendenza nei vostri progetti qualora necessario, sappiate che siete comunque liberi di fare il checkout del progetto e il successivo build, ottenendo in questo modo l’artifact.
La via forse più semplice (o almeno abituale) e che propongo per eseguire il build del progetto, richiede i seguenti requisiti:
- Java Development Kit (JDK) 1.6
- Eclipse Helios o Indingo
- Maven Integration for Eclipse
- Maven SCM Connector for Git
Soddisfatti i requisiti elencati in precedenza, è possibile andare avanti con il checkout del progetto e il successivo build. Tramite l’ausilio di alcune figure cercherò di illustrare il procedimento. Iniziate aprendo il vostro Eclipse, e dal menù File =>; Import selezionare la voce Checkout Maven Project from SCM, così come mostrato in Figura 1.
Figura 1. Checkout Maven Project from SCM
Il secondo step prevede la selezione del repository, specificandone il tipo e l’URL. In questo particolare caso il tipo di repository è Git e la URL da indicare è: git://github.com/amusarra/MVNSugarCRMCE64v4APISOAPLibrary.git. Qualora il connettore SCM non fosse presente in elenco è possibile installarlo tramite l’apposito link all’M2E MarketPlace (vedi Figura 2).
Figura 2. Configurazione del connettore più repository SCM
E’ possibile lasciare le impostazione predefinite per quel che riguarda la locazione su file system del progetto, così come indicato in Figura 3.
Figura 3. Selezione della locazione del Progetto
Terminata la configurazione dell’import, confermata dalla pressione del pulsante Finish, inizia il processo di checkout (della durata di poco meno di un minuto), al termine del quale viene mostrato il contenuto del progetto appena importato (vedi Figura 4).
Figura 4. Progetto dopo il completamento del checkout
A questo punto non resta altro che eseguire il processo di build dal menu (contestuale del progetto) Run AS =>; Maven Install, così come indicato in Figura 5.
Figura 5. Esecuzione del Goal Maven Install
Avviato il processo di build, in console vedrete una serie d’informazioni sulle operazioni (Goal), tra le quali: wsdl2java e Test. In Figura 6 (in rosso) è evidenziata la fase di generazione del client Java dal WSDL, mentre in Figura 7 è evidenziata la fase di test del client appena generato.
Per quanto riguarda il test, è stata realizzata una semplice classe JUnit, eseguita poi dal plugin Maven Surefire subito dopo la fase di compilazione. Il test esegue i seguenti due item sul server di SugarCRM:
- Get ServerInfo
- Login
|
1 2 3 4 |
# Dati di accesso a SugarCRM sugarcrm.username=admin sugarcrm.password=Admin123 sugarcrm.WSDL=http://shirus-crm1.phpfogapp.com/service/v4/soap.php?wsdl&style=rpc&use=literal |
Figura 6. Console che mostra in particolare l'esecuzione di wsdl2java
Figura 7. Esecuzione del test JUnit
La directory target del progetto, dopo il processo di build, conterrà una serie di nuove directory e file, uno dei file più importanti è per l’appunto artifact (un file jar) che si chiama sugarcrmce-64-v4-soap-api-0.0.1-SNAPSHOT.jar da utilizzare in possibili altri progetti. A seguire una serie di figure che mostrano alcune parti del site di distribuzione creato da Maven stesso tramite il comando: mvn site.
Figura 8. Site: Dipendenze di Progetto
Figura 9. Site: Build Plugin
Figura 10. Site: Source Repository
Conclusioni
Ho voluto sfruttare il progetto del client Java SugarCRM per indurre la vostra curiosità verso questo strumento potente che prende il nome di Maven. Si tratta di un strumento completo per la gestione di progetti software Java, in termini di compilazione del codice, distribuzione, documentazione e collaborazione del team di sviluppo. E’ errato arrivare alla conclusione che Maven sia “solamente” un altro strumento di build o che si tratti di una semplice sostituzione di Ant. Anche se in forma “stringata” abbiamo avuto modo di verificare come questo strumento faciliti determinate operazioni consentendo un risparmio di tempo notevole.
