Bitcora

Instalacin y primer proyecto con OpenXava 5

mframosm@yahoo.com.ar

1. Se sugiere que durante el desarrollo de esta bitcora se vaya elaborando un diccionario con
palabras, comandos, expresiones nuevas. Es muy importante porque evidencia que estamos
aprendiendo. Tambin se sugiere ir marcando con color de fondo las lneas que vamos
trabajando para evidenciar nuestro avance.
2. En las siguientes expresiones se debe respetar las maysculas y minsculas.
3. Es necesario instalar java.
1. http://www.java.com/es/download/help/windows_manual_download.xml
2. Se deben descargar e instalar ambas versiones, la de 64 y la 32 bits.
3. Despus del proceso de instalacin (64 bits) se crearon automticamente las siguientes
carpetas:
1. C:/Archivos de programa/java/jdk1.8.0_25 y
2. C:/Archivos de programa/java/jre1.8.0_25
4. Despus del proceso de instalacin (32 bits) se crearon automticamente las siguientes
carpetas::
1. C:/Program Files (x86)/jre1.8.0_25
4. Crear una carpeta openxava5 EMPX en disco C: D: E: F: etc..... (la unidad que desees y tengas
acceso).
5. Descargar Eclipse IDE for Java EE Developers desde: https://www.eclipse.org/downloads/
segn tu maquina (32 o 64 bits)
6. Descomprimir el archivo descargado y copiarlo dentro de la carpeta openxava5 EMPX.
7. Descargar la ltima versin de Openxava desde: http://sourceforge.net/projects/openxava/files/
tambin puedes descargar desde la pgina oficial de openxava
http://www.openxava.org/downloads aunque en este ltimo caso debes registrarte.
8. Descomprimir el archivo descargado y copiarlo dentro de la carpeta openxava5 EMPX.
9. Descargar el drive de Postgresql para java desde: http://jdbc.postgresql.org/download.html en
nuestro caso descargamos: JDBC41 Postgresql Driver, Version 9.3-1101
10.
Copiar el drive en la carpeta ...\openxava-x.x\tomcat\lib (x.x representa la versin de
OpenXava que descargaste, cada vez que aparece x.x se deber cambiar por la versin que
descargaste)
11.
Descargar Postgresql desde:
12.
Instalar Postgresql, el usuario por default es postgres, para el password te
recomendamos uses openxava
13.
Verificar que al instalar Postgesql, tambin se haya instalado el programa pgAdminIII.
14.
Ejecutar pgAdminIII, crea un conexin que puedes llamar ConexEmpx y crear la base
de datos bdempx.
15.
Ejecutar eclipse: (entramos a la carpeta de eclipse y ejecutamos eclipse.exe)
recomendamos crear un acceso directo y copiarlo al escritorio.
16.
Seleccionar como workspace la ruta: C:\openxava5 EMPX\openxava-x.x\workspace
17.
Crear un proyecto:
1. File > New > Project > Java Project > Next > (Nombre del proyecto: Empx) > Finish
(Verificar en Eclipse el proyecto creado, observa que solo tiene la carpeta scr)
18.
Construimos el proyecto OpenXava:
1. OpenXavaTemplate > CreateNewProject.xml (clic derecho) > Run As > Ant Build
(Selecciona la primera opcin), observar el avance del proceso en la parte inferior derecha
de la pantalla (si no se visualiza maximiza la pantalla).

2.

Es probable que aparezca un error como el siguiente: The specified JRE installation does not
exist

1. Sugerimos el siguiente procedimiento para resolver el problema:

2. OpenXavaTemplate > CreateNewProject.xml (clic derecho) > Run As > Ant build
(seleccionamos la segunda fila).
3. Seleccionamos la pestaa JRE
4. Seleccionamos el radio buttom: Run in the same JRE as the workspace
5. Hacemos clic en Environment luego OK. (observar que se rellenan los campos en la
pantalla que se muestran como no editables)
6. Hacemos clic en Apply, Close.
3. Luego construimos el proyecto: OpenXavaTemplate > CreateNewProject.xml (clic
derecho) > Run As > Ant build (seleccionamos la primera fila).
4. Aparece una ventana, Ingresamos el nombre del proyecto: Empx.
5. Esperar hasta que aparezca: BUILD SUCCESSFUL en la Consola.
6. Observa el despliegue del proyecto Empx (ahora aparece con carpetas adicionales, se
sugiere navegar lor ellas para familiarizarse con sus contenidos)
19.
Configuramos Tomcat en eclipse:
1. Windows > Preferences > Server > Runtime Environments > Add
2. Seleccionar Apache Tomcat v7.0 luego Next
3. Hacer clic en Browse y seleccionar la ruta de tomcat dentro de OpenXava: C:\openxava5
EMPX\openxava-x.x\tomcat luego Aceptar
4. Hacemos clic en el combo de JRE: si solo aparece una opcin hacer clic en Installed JREs,
selaccionar la versin de java que aparece, luego OK.
5. Hacemos clic nuevamente en el combo de JRE y seleccionamos la opcin de java que
tenemos instalada.
6. Cerramos el proceso con Finish y OK.
7. Hacemos visible la pestaa Server en la cosola.
8. Window > Show View > Other > Server > Servers y OK.
9. Verificar que se ha creado la pestaa Server en la consola.
10. Hacer clic en No servers available. Clic this link to create a new server.
11. Selecionamos Tomcat v7.0 Server y luego Finish.
12. Observar que en la venta de proyectos aparece el proyecto Server.
13. En la pestaa Server. Hacer clic derecho en Tomcat v7.9 Server at localhost (Stopped
Republish).
14. Add and Remove > Seleccionar Empx > Add > Finish (Observar que Empx ha pasado a la
ventana derecha)
20.
Crear la fuente de datos para conectar Tomcat con Postgresql.
1. Editar el archivo Server > Tomcat v7.0 Server al localhost-config > context.xml > source
2. Agregar al final del archivo: (Se sugiere interpretar cada lnea)
<Resource name="jdbc/EmpxDS" auth="Container"
type="javax.sql.DataSource"
maxActive="20" maxIdle="5" maxWait="10000"
username="postgres" password="openxava"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/bdempx"/>

21.
1.
2.

Configurar la persistencia.
En el proyecto Empx editar el archivo persistence > META-INF > persistence.xml
Eliminamos el contenido actual y lo reemplazamos con el cdigo del siguiente recuadro. (Se
sugiere interpretar cada una de las lneas)

<?xml version="1.0" encoding="UTF-8"?>

<persistence xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
version="1.0">
<!-- Tomcat + PostgreSQL -->
<persistence-unit name="default">
<non-jta-data-source>java:comp/env/jdbc/EmpxDS</non-jta-data-source>
<class>org.openxava.session.GalleryImage</class>
<properties>
<!-- Dialecto de PostgreSQL -->
<property name="hibernate.dialect"
value="org.hibernate.dialect.PostgreSQLDialect"/>
</properties>
</persistence-unit>
<!-- JUnit PostgreSQL -->
<persistence-unit name="junit">
<properties>
<!-- Clase del controlador de PostgreSQL -->
<property name="hibernate.connection.driver_class"
value="org.postgresql.Driver"/>
<!-- Dialecto de PostgreSQL -->
<property name="hibernate.dialect"
value="org.hibernate.dialect.PostgreSQLDialect"/>
<property name="hibernate.connection.url"
value="jdbc:postgresql://localhost/bdempx"/>
<!-- El usuario de la base datos -->
<property name="hibernate.connection.username" value="postgres"/>
<!-- La contrasea del usuario de la base de datos -->
<property name="hibernate.connection.password" value="openxava"/>
</properties>
</persistence-unit>
</persistence>

22.
1.
2.

Actualizamos build.xml
En el proyecto Empx editar el archivo build.xml
Cambiar la lnea:
<property name="schema.path" value="PUT HERE THE PATH OF YOUR JDBC DRIVER"/>

3.

Por esta otra lnea:

<property name="schema.path" value="C:/openxava5 EMPX/openxava-x.x/tomcat/lib/postgresql-9.31101.jdbc41.jar"/>

4.

Que incluye la ruta en la que se encuentra el drive .jar de Postgresql (Este camino es un
ejemplo especfico, se debe actualizar segn cada caso, Observa las diagonales)

23.

Creamos el paquete del modelo:

1. En el proyecto Empx clic derecho en scr > New > Package digitar:
org.openxava.empx.model > Finish
24.
Creamos una superclase IdComun que ser heredada por todas las otras clases y declara
la variable para la Primary Key.
1. Clic derecho en org.openxava.cobit.model > New > Class digitar: IdComun
2. Aparece este cdigo:
package org.openxava.empx.model;

public class IdComun {

}
3.

Copiamos el siguiente cdigo: (Se sugiere analizar el cdigo)

package org.openxava.empx.model;
import javax.persistence.*;
import org.hibernate.annotations.*;
import org.openxava.annotations.*;
@MappedSuperclass
public class IdComun {
@Id
@Hidden
@GeneratedValue(generator="system-uuid")
@GenericGenerator(name="system-uuid", strategy = "uuid")
@Column(length=32)
private String oid;
public String getOid() {return oid;}
public void setOid(String oid) {this.oid = oid;}
}

4.
5.
6.

Creamos la clase Cliente.

Clic derecho en org.openxava.cobit.model > New > Class digitar: Cliente
Aparece este cdigo:
package org.openxava.empx.model;
public class Cliente {
}

Copiamos el siguiente cdigo: (Se sugiere analizar el cdigo)

7.

package org.openxava.empx.model;
import javax.persistence.*;
@Entity
public class Cliente extends IdComun {
@Column(length=10)
private String dni;
public String getDni() {return dni;}
public void setDni(String dni) {this.dni = dni;}
@Column(length=100)
private String apellidos;
public String getApellidos() {return apellidos;}
public void setApellidos(String apellidos) {this.apellidos = apellidos;}
@Column(length=100)
private String nombres;
public String getNombres() {return nombres;}
public void setNombres(String nombres) {this.nombres = nombres;}
}

8.

Nota: Para generar automticamente los get y set de los atributos

1. En el men: Source > Generate Getter and Setter .... > Select All > Ok
2. La organizacin del cdigo es una preferencia particular.

25.
Actualizar Schema, este proceso crea las tablas en la base de datos, en adelante lo
denominamos: updateSchema.
26.
Ejecutar updateSchema
1. Hacer clic derecho en build-xml > Run As > Seleccionar el ltimo Ant build
2. Seleccionar solamente el checkbox de updateSchema > Apply > Run (puede solicitar
grabar archivos)
3. Observar en la consola la creacin de la entidad Cliente (de color azul).
4. Finalmente aparece: Build Sucessful
5. Si no ocurre as, verificar los mensajes de error.
27.
Iniciar la ejecucin del servidor Tomcat:
1. Clic en la pestaa Server
2. Clic en Tomcat v7.0 Server at localhost [Stopped, Republished] y hacer clic en el icono
verde de la consola (Start the server).
3. Observar el avanace del proceso en la esquina inferior derecha.
4. Finalmente aparace en la consola: Tomcat v7.0 Server at localhost [Started, Republished]
28.
Ejecutar el mdulo:
1. En el URL del navegador web digitar: http://localhost:8080/Empx/modules/Cliente
2. Ingresar usuario y contrasea (en este caso admin, admin)
3. Luego veremos como eliminar este paso.
4. Probar la aplicacin, ingresar datos, conocer las opciones bsicas de OX (modo detalle y
modo lista)
29.
Verificar la base de datos con el programa PGAdmin3 (se instal junto con postgresql)
30.
Elaborar un formato para pruebas de los programas.
1. Qu debemos probar?