Raible's Wiki: AppFuseQuickStart

At line 1 changed 1 line.

[AppFuse]'s main purpose is to help you quickly accelerate the start of your webapp. Here are the basic steps to creating a new project with it.

El principal propósito de AppFuse es para darte una base a partir de la cual puedes desarrollar tu aplicación web.

A continuación son los pasos a seguir para crear un nuevo proyecto.

At line 3 removed 9 lines.

# Install J2SE 1.4.2+ and set a JAVA_HOME environment variable pointing to your installation directory.

# [Download|https://appfuse.dev.java.net/servlets/ProjectDocumentList] the source version or checkout the ''appfuse'' module from CVS (cvs -d :pserver:[email protected]:/cvs co appfuse). <div class="note" style="margin: 10px"> __NOTE:__ You can download AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 and MySQL 4.1.11 (for Windows) using [the all-in-one installer|https://appfuse.dev.java.net/files/documents/1397/13863/appfuse-installer-1.8.zip]. View this package's [README.txt|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/extras/myjavapack/README-dist.txt] for more information.</div>

# Install Ant 1.6.2+ and set an ANT_HOME environment variable. Install Tomcat 4.1.x+ (recommend 5.0.28) and set a CATALINA_HOME environment variable to point to your Tomcat installation. Checkout my [development environment setup|DevelopmentEnvironment] to get links for these packages and to see where I usually install them.

# Install MySQL 3.23.x+ (recommend 4.1.7). <div class="note" style="margin: 10px"> __NOTE:__ If you're using MySQL 4.1.7, make sure to use a UTF-8 character set and an InnoDB table type. [Here's how|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].

# [Setup a local SMTP server|AppFuseSMTP] or change mail.properties (in the web/WEB-INF/classes directory) and build.properties (in the root -- for log4j messages) to point to an existing one - they default to ''localhost''.

# Copy lib/junit3.8.1/junit.jar to $ANT_HOME/lib.<div class="note" style="margin: 10px">__NOTE:__ You may see an ant-junit.jar file already in $ANT_HOME/lib. This jar is not the JUnit library, rather it is for the Ant junit task which will use the junit.jar that you place here.</div>

# If you're planning on using iBATIS (instead of Hibernate) or a web framework other than Struts, install that now (instructions below). After the install completes, run __ant new__ from the appfuse directory. You will be prompted for an application name, database name and package name. After entering these, a directory containing your new application will be created in the same directory as appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __WARNING:__ Some application values will not work - don't use "test", anything with "appfuse" in it or anything that starts with numbers. Also, two dashes (-) in a name will mess things up.</div>

# Navigate to your new project's directory and run __ant setup__ (or __ant setup-db setup-tomcat deploy__) to create the database, configure Tomcat and deploy your application. The database setup will only work if your root user has no password. You can change this in build.properties if necessary. Need [assistance with mysql setup|assistance with ant setup]?

# If you want to test and make sure everything works, run __ant test-all__ - make sure Tomcat is stopped when you do this. Next, run __ant test-reports__ - there will be a message after it runs telling you how you can view the generated reports.

At line 13 changed 1 line.

After you've confirmed your installation using the above steps - take a look at the [Tutorials|Articles] to see how to develop with AppFuse.

# Instale el J2SE 1.4.2+ y configure la variable JAVA_HOME de manera tal que apunte hacia el directorio donde lo instaló.

# [Baje|https://appfuse.dev.java.net/servlets/ProjectDocumentList] el código fuente o haga un checkout del módulo 'appfuse'' a partir de CVS (cvs -d :pserver:[email protected]:/cvs co appfuse). <div class="note" style="margin: 10px"> __NOTE:__ Puede bajar AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 yMySQL 4.1.11 (para Windows) usando [el instalador|https://appfuse.dev.java.net/files/documents/1397/13863/appfuse-installer-1.8.zip]. Lea el fichero [README.txt|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/extras/myjavapack/README-dist.txt] para mas información.</div>

# Instale Ant 1.6.2+ y configure la variable ANT_HOME. Instale Tomcat 4.1.x+ (recomendado version 5.0.28) y configure tambien la variable CATALINA_HOME de manera tal que apunte hacia el directorio donde está instalado el servidor Tomcat. Revise mi [preparacion de ambiente para desarrollo|DevelopmentEnvironment] para obtener los enlaces a estos paquetes y ver donde yo los instalo normalmente.

# Instale la base de datos MySQL 3.23.x+ (recomendado 4.1.7). <div class="note" style="margin: 10px"> __NOTE:__ Siu esta usando la version MySQL 4.1.7, asegurese que esta usando el codigo UTF-8 character y una tabla de tipo InnoDB

. [Cómo hacerlo|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].

# [Instale un servidor local SMTP |AppFuseSMTP] o cambie el fichero mail.properties (en el subdirectorio /WEB-INF/classes) asi como el fichero build.properties (que se encuentra en el directorio raiz -- para los mensajes log4j) para que apunte a un servidor SMTP existente - por defecto, apuntan a ''localhost''.

# Copie el fichero lib/junit3.8.1/junit.jar en el subdirectorio $ANT_HOME/lib.<div class="note" style="margin: 10px">__NOTA:__ Podra notar que ya existe un fichero ant-junit.jar en el subdirectorio $ANT_HOME/lib. Este fichero jar no es la biblioteca JUnit, sino que es usado por una tarea Ant que usará el fichero junit.jar que sera guardado en este subdirectorio.</div>

# A partir del subdirectorio appfuse, ejecute __ant new__. En la pantalla le apareceran tres datos a entrar: el nombre de la aplicación, nombre de la base de datos y nombre de paquete a usar en tu aplicación. Luego de haber introducido estos datos, un subdirectorio conteniendo tu nueva aplicación se creará al mismo nivel que appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __ADVERTENCIA:__ Algunos caracteres no se pondrán usar dentro de las palabras claves a entrar como "test", no use tampoco nada que contenga "appfuse" o que empiece con numeros.Dos caracteres (-) tambien son invalidos.</div>

# A partir del subdirectorio recien creado ejecute __ant setup__ (o __ant setup-db setup-tomcat deploy__) para crear la base de datos, configurar Tomcat e instalar la aplicacion. La instalacion de la base de datos solo funcionara si el usuario root no tiene palabra clave. Puede modificar este comportamiento en el fichero build.properties si es necesario. Necesita [ayuda con la instalacion de mysql|assistance with ant setup]?

# Si quieres probar que todo funciona perfectamente, puedes ejecutar __ant test-all__ - asegurate que Tomcat no se este ejecutando cuando efectue esta operacion. Luego, ejecute run __ant test-reports__ - un mensaje aparecera despues de terminar su ejecucion avisandole que puede revisar los reportes generados.

At line 15 changed 6 lines.

__Optional Installations__

* If you'd like to use [iBATIS|http://ibatis.com] as a persistence framework option, view the README.txt in {{extras/ibatis}} or run __ant install-ibatis__.

* If you'd like to use [Spring|http://www.springframework.org/docs/reference/mvc.html] as the web framework, view the README.txt in {{extras/spring}} or run __ant install-springmvc__.

* If you'd like to use [WebWork|http://www.opensymphony.com/webwork] as the web framework, view the README.txt in {{extras/webwork}} or run __ant install-webwork__.

* If you'd like to use [JSF|http://myfaces.apache.org/] as the web framework, view the README.txt in {{extras/jsf}} or run __ant install-jsf__.

* If you'd like to use [Tapestry|http://jakarta.apache.org/tapestry] as the web framework, view the README.txt in {{extras/tapestry}} or run __ant install-tapestry__.

Despues de haber confirmado su instalacion siguiendo las etapas mencionadas, puede referirse a los

[Tutoriales|Articles] para saber como desarrollar con AppFuse.

At line 22 changed 2 lines.

* If you'd like you can write a script to automate the creation and testing of your project from AppFuse. There are a couple in CVS that I use for testing: [spring+ibatis|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] and [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. Note that using "appfuse" in a real-world project name is a bad idea as it'll find/replace things it shouldn't.

* If you don't want to install iBATIS, Spring MVC, WebWork, JSF or Tapestry - you should delete their installers in the {{extras}} folder before checking your project into source control.

__Instalaciones opcionales__

* Si quiere usar [iBATIS|http://ibatis.com] como capa de persistencia, lea el fichero README.txt que se encuentra en {{extras/ibatis}}.

* Si quieres usar [Spring|http://www.springframework.org/docs/reference/mvc.html] como arquitectura web, lea el fichero README.txt que se encuentra en {{extras/spring}}.

* Si quieres usar [WebWork|http://www.opensymphony.com/webwork] como arquitectura web, lea el fichero README.txt que se encuentra en {{extras/webwork}}.

* Si quieres usar [JSF|http://myfaces.apache.org/] como arquitectura web, lea el fichero README.txt que se encuentra en{{extras/jsf}}.

* Si quieres usar [Tapestry|http://jakarta.apache.org/tapestry] como arquitectura web,lea el fichero README.txt que se encuentra en {{extras/tapestry}}.

At line 25 changed 1 line.

<div class="note" style="margin-left: 40px"> __NOTE:__ These installers will modify the Eclipse classpath, but not the IDEA one. You'll need to modify that manually.</div>

* Si quieres, puedes escribir un script para automatizar la creacion y prueba de tu proyecto a partir de AppFuse. Hay dos scripts en CVS que utilizo para mis pruebas: [spring+ibatis|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/Attic/test-spring.sh?content-type=text/plain] y [webwork|https://appfuse.dev.java.net/nonav/source/browse/*checkout*/appfuse/Attic/test-webwork.sh?content-type=text/plain]. Note que usando "appfuse" como nombre de proyecto es una mala idea ya que encontrara/reemplazara textos donde no debiera.

* Si no quiere instalar iBATIS, Spring MVC, WebWork, JSF o Tapestry - debes borrar los instaladores que se encuentran en el subdirectorio {{extras}} antes the ponerlo en una aplicacion de control de codigo

<div class="note" style="margin-left: 40px"> __NOTA:__ Estos instaladores modificaran el classpath en Eclipse , peron no el de IDEA. Debe modificarlo manualmente.</div>

Raible's Wiki

AppFuse

Other Applications

AppFuseQuickStart_es