AppFuseQuickStart_it

This is version 6. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

1. Installa J2SE 1.4.2+ ed imposta la variabile di ambiente JAVA_HOME in modo che punti alla tua directory di installazione.
2. Scarica la versione sorgente di AppFuse o effettua un checkout del modulo appfuse da CVS (cvs -d :pserver:[email protected]:/cvs co appfuse).
3. 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) per ottenere i riferimenti su internet a questi pacchetti e vedere dove li installo di solito.
4. Installa MySQL 3.23.x+ (si raccomanda la versione 4.1.7).
   NOTA: Se stai usando MySQL 4.1.7, assicurati di utilizzare il set caratteri UTF-8 ed InnoDB come tipo tabella. Ecco come.
5. Imposta un server SMTP locale 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.
6. Copia lib/junit3.8.1/junit.jar in $ANT_HOME/lib.
   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.
7. Se hai intenzione di usare iBATIS (invece di Hibernate) o un framework web diverso da Struts, installalo ora usando le istruzioni qui sotto.
8. 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.
   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.
9. 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?
10. 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.

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

Installazioni Opzionali

• Se vuoi usare iBATIS come framework di persistenza, vedi il README.txt in extras/ibatis.
• Se vuoi usare Spring come framework web, vedi il README.txt in extras/spring.
• Se vuoi usare WebWork come framework web, vedi il README.txt in extras/webwork.
• Se vuoi usare JSF come framework web, vedi il README.txt in extras/jsf.
• Se vuoi usare Tapestry come framework web, vedi il README.txt in extras/tapestry.

• 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 e webwork. 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.