Raible's Wiki: AppFuseQuickStart

At line 1 changed 1 line.

Lo scopo principale di [AppFuse] è aiutarti nel dare una rapida accelerata all'avvio di una webapp. Qui ci sono i passi di base per la creazione di un nuovo progetto con esso.

<div class="note">__NB:__ Questo wiki ed il suo contenuto sono dedicati ad AppFuse 1.x. Se preferisci utilizzare AppFuse 2.x, prego vedi il nuovo wiki su [http://appfuse.org]. Puoi trovare la QuickStart Guide per la 2.x su [http://appfuse.org/display/APF/AppFuse+QuickStart]. Grazie!</div>

At line 3 changed 10 lines.

# Installa J2SE 1.4.2+ ed imposta una variabile di ambiente JAVA_HOME che punti alla tua directory di installazione.

# [Scarica|https://appfuse.dev.java.net/servlets/ProjectDocumentList] la versione sorgente o effettua un checkout del modulo ''appfuse'' da CVS (cvs -d :pserver:[email protected]:/cvs co appfuse).

# Installa Ant 1.6.2+ ed imposta una variabile ANT_HOME. Installa Tomcat 4.1.x+ (raccomandata la 5.0.28) ed imposta un variabile di ambiente CATALINA_HOME che punti alla tua installazione di Tomcat. Controlla le [impostazioni del mio ambiente di sviluppo|DevelopmentEnvironment] per ottenere i collaegamenti a questi pacchetti e vedere dove li installo di solito.

# Installa MySQL 3.23.x+ (raccomandata la 4.1.7). <div class="note" style="margin: 10px"> __NOTA:__ Se stai usando MySQL 4.1.7, assicurati di usare il set caratteri UTF-8 ed InnoDB come tipo tabella. [Ecco come|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].</div>

# [Imposta un server SMTP locale|AppFuseSMTP] o modifica i file mail.properties (nella directory web/WEB-INF/classes) e build.properties (nella root -- per i messaggi di log4j) per puntare ad uno esistente - come default indicano ''localhost''.

# Copia lib/junit3.8.1/junit.jar in $ANT_HOME/lib.<div class="note" style="margin: 10px">__NOTA:__ Puoi vedere un file ant-junit.jar già in $ANT_HOME/lib. Questo jar non è la libreria JUnit, piuttosto serve al task di Ant junit che userà il junit.jar che metti qui.</div>

# Se hai in programma di usare iBATIS (invece di Hibernate) o un framework web diverso da Struts, installalo ora usando le istruzioni sotto.

# Esegui __ant new__ dalla directory di appfuse. Ti verrà chiesto un nome per l'applicazione, uno per il database ed uno per il package. Dopo averli inseriti, verrà creata una directory contenente la tua nuova applicazione nella stessa directory di appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __ATTENZIONE:__ Alcuni valori per il nome applicazione non funzioneranno - non usare "test", qualsiasi cosa con "appfuse" al suo interno o qualsiasi cosa inizi con dei numeri. Inoltre, due trattini (-) in un nome scombineranno le cose.</div>

# Naviga nella directory del tuo nuovo progetto ed esegui __ant setup__ (o __ant setup-db setup-tomcat deploy__) per creare il database, configurare Tomcat ed effettuare il deploy della tua applicazione. L'impostazione del database funzionerà solo se il tuo utente root è privo di password. Puoi modificare questo in build.properties se necessario. Hai bisogno di [assistenza per impostare mysql|assistance with ant setup]?

# Se vuoi testare ed assicurarti che tutto funzioni, esegui __ant test-all__ - assicurati che Tomcat sia terminato quando lo fai. Dopo, esegui __ant test-reports__ - ci sarà un messaggio dopo l'esecuzione che ti dirà come puoi visualizzare i report generati.

Lo scopo principale di [AppFuse] è aiutarti nel rendere quanto più rapida possibile la fase di avvio dello sviluppo di una nuova webapp. Ecco i passi fondamentali per la creazione di un nuovo progetto.

At line 14 changed 1 line.

Dopo aver confermato la tua installazione seguendo i passi sopra - dai un'occhiata ai [Tutorial|Articles] per vedere come si sviluppa con AppFuse.

# Installa J2SE 1.4.2+ ed imposta la variabile di ambiente JAVA_HOME in modo che punti alla tua directory di installazione.

# [Scarica|https://appfuse.dev.java.net/servlets/ProjectDocumentList] la versione sorgente di AppFuse o effettua un checkout del modulo ''appfuse'' da CVS (cvs -d :pserver:[email protected]:/cvs co appfuse).

# Installa Ant 1.6.2+ ed imposta la variabile ANT_HOME. Installa Tomcat 4.1.x+ (si raccomanda la versione 5.5.20) ed imposta la variabile di ambiente CATALINA_HOME in modo che punti alla tua installazione di Tomcat. Vedi le [impostazioni del mio ambiente di sviluppo (in inglese)|DevelopmentEnvironment] per ottenere i riferimenti su internet a questi pacchetti e vedere dove li installo di solito.

# Installa MySQL 3.23.x+ (si raccomanda la versione 4.1.7). <div class="note" style="margin: 10px"> __NOTA:__ Se stai usando MySQL 4.1.7, assicurati di utilizzare il set caratteri UTF-8 ed InnoDB come tipo tabella. [Ecco come|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].</div>

# [Imposta un server SMTP locale|AppFuseSMTP] o modifica i file mail.properties (nella directory web/WEB-INF/classes) e build.properties (nella root -- per i messaggi di log4j) per puntare ad uno esistente - come default indicano ''localhost''.

# Copia lib/junit3.8.1/junit.jar in $ANT_HOME/lib.<div class="note" style="margin: 10px">__NOTA:__ Puoi vedere un file ant-junit.jar già in $ANT_HOME/lib. Questo jar non è la libreria JUnit, ma serve al task di Ant junit che userà il junit.jar che metti qui.</div>

# Se hai intenzione di usare iBATIS (invece di Hibernate) o un framework web diverso da Struts, installalo ora usando le istruzioni qui sotto.

# Esegui __ant new__ dalla directory di appfuse. Ti verrà chiesto un nome per l'applicazione, uno per il database ed uno per il package. Dopo averli inseriti, verrà creata una directory contenente la tua nuova applicazione nella stessa directory di appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __ATTENZIONE:__ Non tutti i valori possibili come nome applicazione vanno bene - non usare "test", qualsiasi cosa che contenga "appfuse" al suo interno oppure inizi con dei numeri. Inoltre, se usi due trattini (-) in un nome corri il rischio di scombinare le cose.</div>

# Vai nella directory del tuo nuovo progetto ed esegui __ant setup__ (o __ant setup-db setup-tomcat deploy__) per creare il database, configurare Tomcat ed effettuare il deploy della tua applicazione. L'impostazione automatica del database funzionerà solo se il tuo utente root è privo di password. Se necessario, puoi modificare queste impostazioni nel build.properties. Hai bisogno di [assistenza per impostare mysql|assistance with ant setup]?

# Se vuoi effettuare una verifica per esser sicuro che tutto funzioni, esegui __ant test-all__ - controlla che Tomcat sia spento quando lo fai. Dopo, esegui __ant test-reports__ - al termine dell'esecuzione apparirà un messaggio che ti dirà come poter visualizzare i report generati.

At line 16 added 4 lines.

<div class="note" style="margin-left: 40px"> __NOTA:__ Alcuni test Canoo dipendono dai messaggi dell'applicazione e falliscono con il locale in italiano.</div>

Dopo aver verificato la tua installazione seguendo i passi sopra indicati - dai un'occhiata ai [Tutorial|Articles] per vedere come si sviluppa con AppFuse.

At line 20 changed 5 lines.

* Se vuoi usare [iBATIS|http://ibatis.com] come opzione di persistence framework, vedi il README.txt in {{extras/ibatis}}.

* Se vuoi usare [Spring|http://www.springframework.org/docs/reference/mvc.html] come web framework, vedi il README.txt in {{extras/spring}}.

* Se vuoi usare [WebWork|http://www.opensymphony.com/webwork] come web framework, vedi il README.txt in {{extras/webwork}}.

* Se vuoi usare [JSF|http://myfaces.apache.org/] come web framework, vedi il README.txt in {{extras/jsf}}.

* Se vuoi usare [Tapestry|http://jakarta.apache.org/tapestry] come web framework, vedi il README.txt in {{extras/tapestry}}.

* Se vuoi usare [iBATIS|http://ibatis.com] come framework di persistenza, vedi il README.txt in {{extras/ibatis}}.

* Se vuoi usare [Spring|http://www.springframework.org/docs/reference/mvc.html] come framework web, vedi il README.txt in {{extras/spring}}.

* Se vuoi usare [WebWork|http://www.opensymphony.com/webwork] come framework web, vedi il README.txt in {{extras/webwork}}.

* Se vuoi usare [JSF|http://myfaces.apache.org/] come framework web, vedi il README.txt in {{extras/jsf}}.

* Se vuoi usare [Tapestry|http://jakarta.apache.org/tapestry] come framework web, vedi il README.txt in {{extras/tapestry}}.

At line 26 changed 2 lines.

* Se vuoi puoi scrivere uno script per automatizzare la creazione ed il test del tuo progetto da AppFuse. Ce ne sono un paio in CVS che utilizzo per effettuare i test: [spring+ibatis|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] e [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. Nota che usare "appfuse" all'interno di un nome di progetto reale è una cattiva idea in quanto cerchierà/sostituirà cose che non dovrebbe.

* Se non vuoi installare iBATIS, Spring MVC, WebWork, JSF o Tapestry - dovresti cancellare i loro installer nella cartella {{extras}} prima di mettere il tuo progetto sotto source control.

* Se vuoi, puoi scrivere uno script per automatizzare la creazione ed il test del tuo progetto con AppFuse. Ce ne sono un paio in CVS che utilizzo personalmente per effettuare i test: [spring+ibatis|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] e [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. Nota che usare "appfuse" all'interno del nome del tuo progetto reale non è una buona idea in quanto potrebbero verificarsi sostituzioni nei nomi non previste.

* Se non intendi usare iBATIS, Spring MVC, WebWork, JSF o Tapestry - cancella i rispettivi installer presenti nella cartella {{extras}} prima di mettere il sorgente del tuo progetto sotto controllo di revisione.

At line 29 changed 1 line.

<div class="note" style="margin-left: 40px"> __NOTA:__ Questi installer modifcheranno il tuo classpath in Eclipse, ma non quello di IDEA. Quello dovrai modificarlo manualmente.</div>

<div class="note" style="margin-left: 40px"> __NOTA:__ Questi installer modificano il classpath in Eclipse, ma non quello di IDEA, che dovrai modificare manualmente.</div>

Raible's Wiki

AppFuse

Other Applications

AppFuseQuickStart_it