Sono passati ormai più di due anni dal post che spiegava come creare un progetto con JSF, Spring e Hibernate/JPA. E’ arrivato il momento di aggiornarlo a Maven, con tutte le nuove dipendenze!

Un archetipo tutto nuovo

Ovviamente se si parla di migrare il progetto a Maven, non possiamo che partire da un archetipo. Cercando in rete, quello più interessante è lo Spring Knappsack archetype, anche se:

  • non è aggiornato alle ultime versioni
  • non è diviso in moduli

Tutte cose a cui si può rimediare piuttosto facilmente. Abbiamo quindi deciso di partire da questo archetipo, aggiustate le dipendenze e dividerlo in due moduli (web e services).

Il risultato è quindi un nuovo archetipo Maven che potete usare direttamente da Maven Central aggiornato ad oggi a JSF 2.2 (Mojarra 2.2.5), Spring 4.0.1, JPA 2.1 (Hibernate 4.3.1) e ottimizzato per Tomcat 7.

Creare un nuovo progetto

Come usarlo quindi? Per chi lavora con Eclipse, creare un nuovo progetto Maven è molto semplice: basta selezionare “Maven Project” dal menu dei nuovi progetti e scegliere l’archetipo come in figura:

archetype

Per chi è affezionato alla riga di comando invece, al posto di pochi click basta questo “semplice” comando:

mvn archetype:generate -DgroupId=mydomain -DartifactId=myproject -Dversion=0.0.1-SNAPSHOT -Dpackage=it.mypackage -DarchetypeGroupId=it.cosenonjaviste -DarchetypeArtifactId=jsf2-spring4-jpa2-archetype -DarchetypeVersion=1.0.3

Voilà! In pochi secondo è tutto configurato!

Struttura del progetto

Da dove cominciare quindi per capire com’è strutturato il nostro nuovo progetto? A differenza dell’archetipo originale “Spring Knappsack”, questo archetipo organizza le risorse in due moduli Maven:
archetype-prj-modules

  • [projectName]-services: strato di servizi come l’implementazione della business logic e delle connessioni al database.
  • [projectName]-web: strato di web presentation, composto da pagine e controller web.

Così possiamo organizzare le risorse in modo più strutturato.

Dove sono i file di configurazione?

File come il web.xml, faces-config.xml e il persistence.xml non hanno bisogno di presentazioni se avete bisogno di questo archetipo. Non ci sono grosse sorprese su dove trovarli:

  • i primi due sono nel modulo web in myproject-web/src/main/webapp/WEB-INF
  • il terzo nel modulo dei servizi in myproject-services/src/main/resources/META-INF

Il web.xml è configurato per lavorare con la specifica 3.0 di Servlet, il faces-config.xml per JSF 2.2 e il persistence.xml per JPA 2.1

. Da notare che in questi ultimi due file i namespaces sono cambiati:

<?xml version="1.0" encoding="UTF-8"?>
<faces-config
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd"
    version="2.2">
...


<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd"
	version="2.1">

...

Quello che è cambiato in realtà è il dominio: da java.sun.com a xmlns.jcp.org … e così si chiude uno degli ultimi riferimenti alla vecchia e cara Sun 🙁

E Spring?

La vera domanda è proprio questa: e i file di configurazione di Spring dove sono? Spring ha i suoi posti canonici e i suoi nomi canonici per i file di configurazione, ma non è così fiscale come i descrittori precedenti.

In Eclipse, se avete gli Spring Tools (che consiglio e che potete installare comodamente dal Marketplace), vi indica già la strada per i file di configurazione:

  • myproject-web/src/main/webapp/WEB-INF/spring/application-context.xml: attiva la component scan per i package e include il file di configurazione del necessario per la connessione e la gestione del database.
  • myproject-services/src/main/resources/spring/db.xml: definisce i bean come il dataSource o il transactionManager per la comunicazione con il database. Molto probabilmente questo file non cambierà mai: i dati variabili sono contenuti del file di properties associato (db.properties).

Metadati di Eclipse

Questo archetipo è stato creato a partire da un progetto Eclipse (Kepler nello specifico) per cui comprende i metadati per applicare la facet giuste per caratterizzare il progetto nel vostro workspace. Su alcune versioni di Eclipse è capitato che alla creazione del progetti vi fossero degli errori nell’applicazione del facet JPA 2.1: con un paio di project update dal menu Maven si risolve velocemente il problema!

Non resta quindi che augurarvi buon download!!

Share:

83 Posts

Sono un software engineer focalizzato nella progettazione e sviluppo di applicazioni web in Java. Presso OmniaGroup ricopro il ruolo di Tech Leader sulle tecnologie legate alla piattaforma Java EE 5 (come WebSphere 7.0, EJB3, JPA 1 (EclipseLink), JSF 1.2 (Mojarra) e RichFaces 3) e Java EE 6 con JBoss AS 7, in particolare di CDI, JAX-RS, nonché di EJB 3.1, JPA2, JSF2 e RichFaces 4. Al momento mi occupo di ECM, in particolar modo sulla customizzazione di Alfresco 4 e sulla sua installazione con tecnologie da devops come Vagrant e Chef. In passato ho lavorato con la piattaforma alternativa alla enterprise per lo sviluppo web: Java SE 6, Tomcat 6, Hibernate 3 e Spring 2.5. Nei ritagli di tempo sviluppo siti web in PHP e ASP. Per maggiori informazioni consulta il mio curriculum pubblico. Follow me on Twitter - LinkedIn profile - Google+

You might also like:

JBoss 7 ed EclipseLink 2: una coppia quasi perfetta – Parte I (a.k.a. weaving statico con Ant)

Gli Application Server (AS) basati sulle specifiche Java EE ci permettono spostare una applicazione da uno all’altro senza problemi, e allo stesso tempo ci mettono in condizione di essere in grado di lavorare indistintamente con uno o l’altro AS… questo almeno in teoria! In pratica invece ci scontriamo con tutte le configurazioni specifiche di ogni AS, nonché con deployment descriptors proprietari che variano da server a server. Di solito quindi, una volta scelto l’AS su cui lavorare, è bene affidarsi a tutte le implementazioni delle specifiche che esso porta con se, per avere meno problemi possibile. Prendiamo per esempio JBoss 7, che come implementazione di JPA ha Hibernate. Finché usiamo questa implementazione della specifica JPA, funziona tutto correttamente: se però abbiamo bisogno di passare per esempio ad EclipseLink, perché magari preferiamo qualche sua caratteristica peculiare, dobbiamo armarci di pazienza e rimboccarci le maniche!

04/10/2012 Read more