Manual de Maven

Informe: OUT-MGN-001-2009

Versión: Elaborado el: 11 de Mayo del 2009

Proyecto: OUTSOURCING TICServicio Especializado en Tecnología de Información y Comunicaciones

Organización

OSINERGMIN Organismo Supervisor de la Inversión en Energía y Minería

MANUAL DE

MAVEN

Ámbito: Confidencial Nombre del documento: Manual de Maven.doc 1 / 9




Organización


Índice

Instalacion..........................................................................................................................3Cambiar el repositorio.......................................................................................................3Crear un aplicativo Simple................................................................................................3Definir Workspace.............................................................................................................3Comandos y librerías de los JARS....................................................................................3Servidores de Maven.........................................................................................................3Creación de Proyecto Simple............................................................................................4Empaquetas Proyecto........................................................................................................5Instalación del Proyecto....................................................................................................5Creación de Proyecto Web................................................................................................5Creación del War...............................................................................................................6Hibernate...........................................................................................................................6Como agregar un repositorio.............................................................................................7Instalar una nueva librería en tu servidor Local................................................................7Datos importante para proyectos JSF................................................................................8





Organización


Instalacion

Se copia el archivo de la página oficial de Maven (http://maven.apache.org/download.html)y se define la variable MAVEN_HOME, indicando la ruta donde se encuentra instalado:

También indicar el MAVEN_HOME dentro de la variable PATH.

Se verifica ejecutando lo siguiente:

C:\>mvn --version

Cambiar el repositorioCambiar el archive “settings.xml” del archivo d:\tools\maven-2.0.7\conf

<localRepository>d:/tools/.m2/repository</localRepository>

Crear un aplicativo SimpleC:\tutorials>mvn archetype:create -DgroupId=com.mytutorial -DartifactId=simple

C:\tutorials\simple project called “simple”C:\tutorials\simple\src “src” folder under which you have “main” & “test” etc.C:\tutorials\simple\pom.xml the basic maven Project Object Model file.

Definir el Workspacemvn -Declipse.workspace=D:\tools\workspace eclipse:add-maven-repo


http://maven.apache.org/download.html




Organización


Comandos y librerías de los JARSLos comandos que utiliza Maven se encuentran en el siguiente URLhttp://maven.apache.org/plugins/

Servidores de MavenDesde estos servidores Maven toma los JARs que luego son guardados en el servidore Local.http://repo2.maven.org/maven2/

Servidor adicionalhttp://download.java.net/maven/2/

Para buscar jars, descripción Maven. Diccionario

http://mvnrepository.com/

Creación de Proyecto SimplePara crear un proyecto simple. Debes ejecutar los siguiente comandos:

d:\tool\tutorials> cd simpled:\tool\tutorials\simple>mvn eclipse:eclipse

Para compilar

d:\tool\tutorials\simple>mvn compile

Para verificar si la variable .m2 está correctamente configurada


http://mvnrepository.com/

http://download.java.net/maven/2/

http://repo2.maven.org/maven2/

http://maven.apache.org/plugins/




Organización






Organización


Si la variable no existiese, definirla:

Si quieres agregar nuevos .jar o librerías, deberás modificar el archivo pom.xml y ejecutar el comando: “mvn eclipse:clean eclipse:eclipse”, este comando es como un re-build.

Empaquetar Proyecto

Para empaquetar un JAR o War del Proyecto, debes ejecutar los siguientes comandos:

d:\tools\tutorials\simple>mvn clean package

Con estos comandos puedes ejecutar el JAR:

d\tools\tutorial\simple>java -cp .\target\simple-1.0-SNAPSHOT.jar com.mytutorial.App

Instalación de un ProyectoPara hacer que tu aplicativo sea utilizado por otros, deberás ejecutar los siguientes comandos

D:\tools\tutorial\simple>mvn install

Creación de Proyecto Web

Para crear un proyecto Web, debes ejecutar el siguiente comando:

D:\tools\tutorial>mvn archetype:create -DgroupId=com.mytutorial -DartifactId=simpleWeb -DarchetypeArtifactId=maven-archetype-webapp

D:\tools\tutorials>cd simpleWebd:\tools\tutorials\simpleWeb>mvn eclipse:eclipse





Organización


Luego importe el proyecto:

Creación del WarEjecutar el siguiente comando:D:\tools\tutorial\simpleWeb>mvn package

HibernateDebes seguir los siguientes pasos:

1. Agregar Hibernate en el pom.xml

<dependency>

<groupId>org.hibernate</groupId><artifactId>hibernate</artifactId><version>3.2.6.ga</version>

</dependency>

2. Agregar un repositorio adicional, ya que Hibernate utiliza una dependencia que sólo se encuentra en este repositorio





Organización


<repositories><repository>

<id>maven-repository.dev.java.net</id><name>Java Dev Net Repository</name><url>http://download.java.net/maven/2/</url><releases>

<enabled>true</enabled><updatePolicy>never</updatePolicy>

</releases><snapshots>

<enabled>false</enabled></snapshots>

</repository></repositories>

Como agregar un repositorioPara ello debes agregar esta línea en pom.xml<repositories>

<repository><id>maven-repository.dev.java.net</id><name>Java Dev Net Repository</name>

<url>http://download.java.net/maven/2/</url><releases>





Incluso se puede agregar un repositorio local de la siguiente forma:

<repositories><repository>

<id>maven-repository.dev.java.net</id><name>Java Dev Net Repository</name>

<url>c:\</url><releases>









Organización


Instalar una nueva librería en tu servidor Local

Copiar el archivo en una carpeta como por ejemplo d:\tools\maven_lib y ponerle el nombre al archivo JAR indicando su versión, para nuestro ejemplo utilizaremos el siguiente nombre jsf-impl-1.2._10 y luego ejecutar el siguiente comando:

d:\tools\maven_lib> mvn install:install-file -Dfile=jsf-impl-1.2_10.jar -DgroupId=javax.faces -DartifactId=jsf-impl -Dversion=1.2_10 -Dpackaging=jar -DgeneratePom=true

-DgroupId: Es el Grupo como se guardará en el servidor local.-DartifactId: Es el nombre del artefacto.-Dversion: Versión del artefacto.

Con ello se creará un nuevo archivo dentro de una carpeta como se muestra en la imagen:

Datos importante para proyectos JSFEl JSF 1.2 requiere eclipse web facet 2.5. Necesitas abrir el archivo“org.eclipse.wst.common.project.facet.core.xml” dentro de d:\tools\tutorials\simpleWeb\.settings como se muestra abajo, modificar version=2.4 a version=2.5. Cada vez que uses el comando eclipse:clean, tienes que hacer el cambio como se muestra en la parte inferior.

Ahora abre el Eclipse y hacer Refresh (i.e. F5) simpleWeb project. Después de esto si tu verificas el Eclipse Build Path, esto debería como verse como arribar en spring-2.0.6.jar.

Documents

Manual de Maven