openxava / documentación / Eclipse Web Tools Platform

Ésta es una guía para configurar WTP para ejecutar y depurar aplicaciones OpenXava dentro de Eclipse.
Eclipse Web Tools Platform (WTP) nos ayuda a desarrollar aplicaciones J2EE con Eclipse.
En el caso de OpenXava podemos usar WTP para arrancar el Tomcat (o tu servidor de aplicaciones preferido) dentro de Eclipse, de esta forma podemos ver los efecto de los cambios sin redesplegar y también podemos depurar.
Todas las aplicaciones OpenXava creadas desde OpenXavaPlantilla son compatibles con WTP.
Este documento nos guía para poder ejecutar la aplicación MiEscuela, que viene con OpenXava, usando WTP.

Añadir Tomcat a nuestro Eclipse

• Ve a Windows > Preferences > Server > Installed Runtimes.
• Pulsa en Add.
• Escoge Apache > Apache Tomcat 5.5.
• Pulsa en Next.
• Rellena:
  • Name: Apache Tomcat v5.5
  • Tomcat installation directory: La ruta de tu Tomcat (puedes usar el Tomcat que viene con OpenXava en la carpeta openxava-3.0.x/tomcat)
  • JRE: Escoge un Java 5.
• Pulsa en Finish.
• Pulsa en OK en Preferences Dialog para cerrarlo.

¡Advertencia! Si no usas el Tomcat incluido en OpenXava tienes que copiar jta.jar y ejb.jar de openxava-3.0.x/tomcat/common/lib a la carpeta common/lib de tu Tomcat.

Crear un servidor Tomcat

• Ve a la pestaña Server. Si no existe, añádela (Windows > Show view > Other > Server > Servers).
• En la pestaña Server pulsa Botón Derecho > New > Server.
• Selecciona en Server runtime: Apache Tomcat v5.5.
• Pulsa en Next.
• Añade MiEscuela a Configured projects.
• Pulsa en Finish.

Definir las fuentes de datos

Ahora tenemos en nuestro workspace un proyecto llamado Servers. Dentro de este proyecto tenemos una carpeta llamada Tomcat v5.5 Server @ localhost-config. Pon ahí un archivo llamado context.xml con el siguiente contenido:

<!-- The contents of this file will be loaded for each web application -->
<Context>
 
    <!-- Default set of monitored resources -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
 
    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <Manager pathname="" />
 
    <Resource name="jdbc/OpenXavaDS" auth="Container" type="javax.sql.DataSource"
       maxActive="20" maxIdle="5" maxWait="10000"
       username="sa" password="" driverClassName="org.hsqldb.jdbcDriver"
       url="jdbc:hsqldb:file:/java/openxava-3.0/tomcat/data/openxava-db"/>
 
    <Resource name="jdbc/MiEscuelaDS" auth="Container" type="javax.sql.DataSource"
       maxActive="20" maxIdle="5" maxWait="10000"
       username="sa" password="" driverClassName="org.hsqldb.jdbcDriver"
       url="jdbc:hsqldb:file:/java/openxava-3.0/tomcat/data/mi-escuela-db"/>
 
</Context>

Hemos de cambiar /java/openxava-3.0 por la ruta donde tengamos el OpenXava instalado.

Arrancar el servidor y probar la aplicación

• Para el portal OpenXava (stop-portal.sh/.bat) si lo tienes arrancado.
• Ve a Server tab.
• Pulsa en Botón Derecho en Tomcat v5.5 Server > Start
• Espera hasta que el Tomcat arranque.
• Abre un navegador de internet y ve a http://localhost:8080/MiEscuela/xava/module.jsp?application=MiEscuela&module=Profesor

Desarrollando con WTP

Después de seguir estos pasos si cambiamos el código Java solo necesitamos pulsar en Build All (o Ctrl-B) e ir a nuestro navegador para ver la aplicación actualizada. Si tocamos un archivo XML tendremos que ejecutar la tarea ant reconstruir, refrescar nuestro proyecto y usar nuestro navegador para ver el resultado.

Además, podemos arrancar el Tomcat en modo depuración y así usar el depurador del Eclipse.