maven




Ejemplo del uso de Maven
Uso de maven tomando la aplicación Formul@ como ejemplo
Índice
1. OBJETO DE ESTE DOCUMENTO 3
2. INSTALACIÓN. 3
3. CREACIÓN DEL PROYECTO 4
4. ESTRUCTURA DEL PROYECTO MAVEN. MIGRACIÓN DE LOS CONtENIDOS. 7
5. DEFINICIÓN DE NUESTRAS DEPENDENCIAS. 9
6. EMPAQUETAMIENTO DEL PROYECTO. 16
7. PLUGINS DE MAVEN 16
8. OTRAS INFORMACIONES 18
9. GENERACIÓN DEL SITIOWEB 20
10. INFORMES PARA ANALIZAR LA CALIDAD. 24
11. FICHERO DESCRIPTOR PARA FORMULA. POM.XML 25

1. OBJETO DE ESTE DOCUMENTO

El objetivo de este documento es ilustrar el uso de maven con una aplicación java ya creada, la aplicación web Formul@.

2. INSTALACIÓN.

Pasos para la instalación de maven 2

1) Desempaquetamos el archivo maven-2.0.x-bin.tar.gz que nos podemos bajar de lapágina de maven http://maven.apache.org/download.html en la ruta donde deseemos instalarlo.
- tar zxvf maven-2.0.x-bin.tar.gz “o”
- unzip maven-2.0.x.zip

Tras esto se creará un directorio llamado "maven-2.0.x".

2) Añadir el directorio a el PATH:
- export PATH=.:/home/prueba/maven-2.0.x /bin:$PATH “o”
- set PATH="c:\program files\maven-2.0.x\bin";%PATH%

3) Establece lavariable JAVA_HOME a la carpeta del jdk.
- export JAVA_HOME=/home/prueba/jdk1.5.0_09

4) Ejecuta "mvn –version". Si se ha instalado correctamente mostrara la versión de maven que estamos utilizando.

Después de esto solo tendremos que usar el comando mvn desde la carpeta de nuestro proyecto que contendrá un fichero llamado por defecto “pom.xml”.









3. CREACIÓN DEL PROYECTO

Paracrear el proyecto con estructura maven para Formul@ podemos hacerlo de dos formas.
1. Usando el mecanismo de arquetipos de maven: El plugin archetype de maven es toolkit para creación de platillas de proyectos.
2. Creando una carpeta con un pom.xml (que es el fichero que describe un proyecto en maven) vacío.

Explicaremos el primer mecanismo, aunque este tiene mas utilidad cuand empezamosuna aplicación desde cero.

Un archetype es un plugin que indica a maven con que que tipo de estructura tiene que crear un proyecto. En función del tipo de proyecto que queramos crear existen varios archetype, que nos permiten por ejemplo crear proyectos para struts, spring, jsf, etc.

Una lista de archetypes disponibles se puede ver en esta url:http://docs.codehaus.org/display/MAVENUSER/Archetypes+List

Usando la siguiente instrucción con el archetype maven-archetype-webapp crearemos nuestro primer proyecto para maven.

mvn archetype:create
-DgroupId=com.viavansi
-DartifactId=formula
-Dpackaging=war
-DarchetypeGroupId=org.apache.maven.archetypes
-DarchetypeArtifactId=maven-archetype-webapp
-Dversion=1.0
-DarchetypeVersion=1.0

En esta instrucciónaparecen un conjunto de elementos que se guardará en el pom.xml del proyecto y que son típicos de cualquier componente que se encuentre instalado en un repositorio maven.
1. artifacId es el nombre que le ponemos a nuestra apliacin o componete y el nombre que se usara cuando la metamos en el repositorio interno de maven.
2. groupId es el grupo dentro del repositorio al que queremos que pertenezcanuestro componente. Y suele hacer referencia a la organización, similar al paquete de una clase.
3. packaging indica el tipo de empaquetamiento que se usará con la aplicación, en este caso war.
4. version indica la versión actual de la aplicación.

Los elementos archetypeGroupId, archetypeArtifactId y archeytypeVersion tienen el mismo significado que artifactId, groupId y packaging peroreferidos al componente maven-archetype-webapp que es el archetype que vamos a usar.

Con esto solo necesitamos conexión a Internet para que maven se baje el plugin correspondiente al archetype maven-archetype-webapp, ya que es la primera vez que lo usamos, y que esta en el repositorio http://www.ibiblio.org/maven2 como se puede en la tabla anterior.
Con esto tendremos una carpeta con la...