Apéndice A. Obtención y compilación del código

A.1. Descarga y compilación del código fuente disponible en CVS

El proyecto utiliza Maven como herramienta de gestión. Tan sólo se necesita seguir los siguientes pasos:

  1. Instalar Maven (al menos versión 1.0).

  2. Ejecutar la siguiente instrucción en una única línea para obtener los últimos fuentes de CVS.

    maven scm:checkout-project 
      -Dmaven.scm.method=cvs 
      -Dmaven.scm.cvs.module=. 
      -Dmaven.scm.cvs.root=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/oness 
      -Dmaven.scm.checkout.dir=oness[2]
  3. Una vez hecho se puede ejecutar maven en el directorio de cualquier módulo, o maven multiproject:artifact en el directorio doc para compilar todos los módulos y generar las librerías (ficheros jar) y las aplicaciones web (ficheros war).

A.2. Compilación a partir del código fuente descargado

  1. Obtener el módulo deseado a partir de la página web [Sourceforge] y descomprimirlo en un directorio, por ejemplo si se obtiene oness-party-model-src-0.2 descomprimirlo a un directorio undirectorio/party/model (el nombre no importa, sólo asegúrese de que hay dos niveles de directorios si el nombre del módulo es oness-x-y-version o tres si es oness-x-y-z-version)

  2. Obtener oness-common-maven y descomprimirlo en undirectorio/common/maven (el nombre es importante)

  3. Ya se puede ejecutar maven en el directorio del módulo descargado, por ejemplo para compilar las clases java se puede utilizar maven java:compile, o maven jar para generar la librería jar. Consulte la documentación de Maven para saber todas las posibilidades que ofrece.

A.3. Configuración de la base de datos para los tests

La configuración de la conexión a la base de datos por defecto está en el módulo oness-common-model, en el fichero src/conf/dataSource.properties, que debería servir para una instalación por defecto de MySQL.

Si se desea cambiar la base de datos, usuario o contraseña se puede añadir algunas de las siguientes propiedades en el fichero $HOME/build.properties que tendrán precedencia sobre los valores por defecto:

maven.junit.sysproperties=dataSource.password \
    dataSource.username \
    dataSource.url \
    dataSource.driverClassName \
    hibernate.dialect

# If you want to use postgres
dataSource.username=yourpostgresusername
dataSource.password=
dataSource.url=jdbc:postgresql:yourdatabasename
dataSource.driverClassName=org.postgresql.Driver
hibernate.dialect=net.sf.hibernate.dialect.PostgreSQLDialect

En caso de que no se desee ejecutar los test de unidad se puede ejecutar Maven con el parámetro -Dmaven.test.skip=true.

A.4. Usando eclipse

Si desea utilizar eclipse necesitará instalar algunas librerías en el repositorio local de Maven, si no desea modificar los ficheros de proyecto de eclipse. Para realizarlo se debe llamar a maven jar:install-snapshot en los módulos que necesite o maven multiproject:install-snapshot en el módulo doc para instalar las librerías de todos los módulos.



[2] Para obtener la versión concreta presentada como proyecto de fin de carrera se puede añadir -Dmaven.scm.cvs.sticky.tag=UDC