viernes, 10 de agosto de 2007

Montando Appfuse en Eclipse

Hola a todos, en esta entrada explico de forma breve pero util la instalación y montaje del conocido Appfuse WebWork en eclipse, appfuse es una aplicación open source j2ee que implementa spring framework, patrones, manager, dao, y vistas, y puede trabajar con ibatis e hibernate para acceder a la base de datos que puede ser mysql, postgresql, oracle u otras.
Esta explicación te servira para Windows y Linux, no lo he probado en otras plataformas, y te sirve solo como introducción y ayuda, las demás configuraciones de bases de datos(properties.xml), servidor de correo(mail.properties),etc. las tendrás que configurar tu. Como no tengo mucho tiempo de sacar pantallazos y ese tipo de cosas me he permitido de hacer esta explicación en pocos pasos, lo demas lo dejo a tu experticia.

1.- debes abrir una ventana de tu explorador he ingresar la sigte url para bajar Appfuse Webwork:

https://appfuse.dev.java.net/servlets/ProjectDocumentList?folderID=6196

2.- una vez en la página busca y baja el archivo:

appfuse-webwork-1.9.4-src.zip que pesa alrededor de 27 megas

bajalo y copialo a tu carpeta de proyectos o desarrollo de tu equipo y descomprimelo.

3.- si todo va bien cuando se descomprime se generara una carpeta de nombre:

appfuse

4.- una vez hecho esto, debes abrir eclipse o netbeans, te recomiendo que por primera vez lo hagas en eclipse.

5.- y ya en eclipse debes ir a los menús:

file --> new --> proyect -->, se va a abrir una ventana donde debes seleccionar la primera opcion:

java proyect y luego presionar botón next o siguiente si esta en spanish.

6.- te pedira un nombre para el proyecto a montar, puedes poner cualquier nombre, pero te aconsejo que sea appfuse

7.- seguidamente y en la misma ventana debes seleccionar el chekbox 'create proyect from existing source' y dar la ruta de tu proyecto appfuse

8.- luego debes hacer click en boton next y en la siguiente ventana next y finish, ahí te montara appfuse en tu eclipse que podras ver el navigator o browser de archivos al costado izquierdo de tu ide eclipse.

9.- una vez hecho esto debes configurar base de datos local en el archivo properties.xml que esta en la raiz del proyecto, en ese archivos existen conexiones de ejemplo que puedes ocupar.

puedes tener varias conexiones a distintas bases de datos en el mismo archivo, solo tienes que comentar las que no ocupas.

appfuse.war se llama el archivo que generara eclipse, para esta tarea se apoyara con ant, el que automatiza el deploy en tu eclipse, si no lo tienes ve i bajalo de la sigte. url:

http://ant.apache.org/

te recomiento la version 1.7, la desenpaquetas en tu equipo en algún directorio para este tipo de librerias, luego vas al menu superior de eclipse, window --> sho view --> ant

Esto abrira un explorador en el cual debes agregar el buid.xml del proyecto, para que puedas trabajar con tu proyecto y ant (la tarea de ant es ejecutar tag de el build.xml de tu proyecto)

appfuse puede trabajar con distintas bases de datos, en mi caso tengo postgreSQL 8.2 intalada en mi debian, y ant no la crea por lo tanto la debes crear con el gestor de base de datos, el pgAdmin3, Webmin, o por consola, esta configuracion de base de datos es la que debes tener en tu properties.xml

Ahora ya tienes listo tu eclipse con ant, para deployar el proyecto y trabajar con la base de datos(dbload y dbprepare), para esto en ant debes ejecutar los siguientes task

clean: limpia el directorio de tu proyecto de archivos generados con la compilacion.

dbprepare: genera automaticamente las tablas y relaciones en tu base de datos.

dbload: carga la primera información de ejemplo en tu base de datos que contiene el archivo sample-data.xml del directorio metadata/sql

package web, undeploy

start tomcat: inicia el servidor tomcat de tu maquina local, para esto debes tener en la carpeta plugin de tu eclipse el archivo de sysdeo para tomcat

deploy war: genera el archivo appfuse.war y lo copia a tu webapp de tomcat

y finalmente deploy web

Ahora para ver tu appfuse debes abrir tu explorador en la dirección:

http://localhost:8080/appfuse

el user es tomcat y
la passwd es tomcat

o para admin mraible como user y tomcat como clave

para apoyo puedes ir a las sigtes url's

http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseEclipse_es

o escribirme un email o comentarios, tratate de sacar todas las dudas.

Saludos y suerte !!

4 comentarios:

Leandro Tapia dijo...

Jorge,

el archivo para la configuracion de correos mail.properties y no mail.properties.xml como tú lo indicas, buen post y gran aporte

=D

Anónimo dijo...

hola, segui tus pasos y funciono perfecto, gracias

firmando electronicamente adobe acrobat dijo...

Muchas gracias por tu exposición, que es muy clara y precisa. De Primera Categoría !

Dante dijo...

Muchas gracias tambien me funciono, ahora dejo este video por alguien quedo con la duda..
https://www.youtube.com/watch?v=du1V9WvRU08