En este post vamos a presentar un ejemplo de como usar Maven desde Eclipse para resolver las dependencias de librerias externas del proyecto via Maven. Además podemos usar Maven para crear distribuciones (desplegables) de nuestros proyectos.
El ejemplo que vamos a usar es un proyecto web en Eclipse. Los pasos a seguir serian los siguientes:
1. Instalar Maven en el sistema. En el ejemplo usamos Maven 2.2.1.
http://maven.apache.org/download.cgi
2. Instalar el plugin de Maven 2 en Eclipse (m2eclipse). Usamos el Eclipse Marketplace para esto:
3. Una vez instalado, lo configuramos para que use nuestra instalación del punto 1 de Maven:
También seleccionamos el fichero de configuración de Maven 2:
En ese mismo fichero (settings.xml) se configura la localización del repositorio local, asi como las credenciales de acceso a través del proxy, en caso de ser necesario, para poder descargar las dependencias si éstas no existen en el repositorio local:
|
1 2 3 4 5 |
<!-- localRepository | The path to the local repository maven will use to store artifacts. | | Default: ~/.m2/repository --> <localRepository>C:\Users\lagarcia\.m2\repository</localRepository> |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
<!-- proxies | This is a list of proxies which can be used on this machine to connect to the network. | Unless otherwise specified (by system property or command-line switch), the first proxy | specification in this list marked as active will be used. |--> <proxies> <!-- proxy | Specification for one proxy, to be used in connecting to the network. | --> <proxy> <id>optional</id> <active>true</active> <protocol>http</protocol> <username>lagarcia</username> <password>XXXXXXXXX</password> <host>proxy.foo.bar</host> <port>8080</port> <nonProxyHosts>localhost</nonProxyHosts> </proxy> </proxies> |
Es conveniente también revisar la configuración del proxy desde Eclipse, pero si estamos detrás de uno de ellos y hemos podido descargar e instalar el plugin de Maven desde el Marketplace, en principio lo tendremos correcto.
4 – Mavenizar el proyecto. Una vez creado el proyecto en Eclipse, hacer lo siguiente: Seleccionar el proyecto. Hacer click sobre él son el botón derecho del ratón. Se muestra un menú pop-up. Seleccionar la opción “Configure” –> “Convert to Maven Project”
Automaticamente se creará en el proyecto un fichero pom.xml. Es en ese fichero donde podremos añadir las dependencias y las configuraciones para generar los desplegables, más adelante.
5 – Añadir las dependecias
Seleccionando el fichero pom.xml, se pueden añadir las dependencias:
- Usando la GUI que proporciona:
- O bien directamente editando en el fichero pom.xml:
|
1 2 3 4 5 |
<dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-core</artifactId> <version>4.2.12.Final</version> </dependency> |
Al guardar se actualizará automaticamente la dependencia, descargando la libreria desde el sitio por defecto (http://search.maven.org/) si no está en nuestro respositorio local, y enlazandola como “dependencia Maven” en nuestro proyecto en Eclipse para que podamos compilar sin problemas. Se pueden configurar otros destinos para descargar las librerias desde otros repositorios remotos, o incluso copiarlas directamente a nuestro repositorio local para que se recojan desde ahí.
6 – Compilar y crear distribuibles desde Maven
Puede ser conveniente compilar y crear un distribuible, como un WAR para desplegar, mediante Maven. En el ejemplo que presentamos lo usaremos para crear diferentes despliegues en función del pérfil que seleccionemos. Esto es útil porque podemos querer generar diferentes despliegues para diferentes entornos, ya que pueden tener configuraciones distintas, como URLs, rutas locales y demás.
- Creamos los perfiles con la configuración que necesitemos. En este caso creamos dos perfiles (devel y prod). En cada uno queremos compilar y generar un WAR. Además queremos que para cada uno use unos ficheros de configuración determinados, e ignore otros. Añadimos en el pom.xml lo siguiente:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
<!-- Profiles --> <profiles> <!-- Development --> <profile> <id>devel</id> <build> <finalName>MOMS_Server</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <configuration> <webResources> <resource> <directory>${basedir}/WebContent</directory> <excludes> <exclude>WEB-INF/classes/log4j.xml</exclude> <exclude>WEB-INF/classes/config/http.properties</exclude> <exclude>WEB-INF/classes/config/mail.properties</exclude> </excludes> </resource> <resource> <directory>${basedir}/configs/devel</directory> </resource> </webResources> </configuration> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.0</version> <configuration> <source>1.6</source> <target>1.6</target> </configuration> </plugin> </plugins> </build> </profile> ... </profiles> |
En este perfil indicamos los recursos web (WebContent) que queremos incluir en el perfil y dentro de ellos los que queremos excluir (los ficheros de configuración que queremos reemplazar por los que hay en /configs/devel).
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<webResources> <resource> <directory>${basedir}/WebContent</directory> <excludes> <exclude>WEB-INF/classes/log4j.xml</exclude> <exclude>WEB-INF/classes/config/http.properties</exclude> <exclude>WEB-INF/classes/config/mail.properties</exclude> </excludes> </resource> <resource> <directory>${basedir}/configs/devel</directory> </resource> </webResources> |
- Usamos Eclipse para ejecutar el perfil:
La primera vez que ejecutamos el perfil realizamos la siguiente acción: Se clica con el botón derecho del ratón sobre el proyecto. En el menu pop-up que aparece se selecciona “Run As” –> “Maven build…”. En el diálogo que aparece se puede crear una ejecución Maven que se podrá reutilizar en el futuro. Se pueden añadir los siguientes goals:
Si se marca la casilla offline, evitaremos que se intenten descargar dependencias remotas en caso de no encontrarlas en local. Con esto bastaría para que se cree dentro del proyecto, en la carpeta target, el distribuble generado. También se puede maracar Skip Tests para evitar que se compilen y se ejecuten los posibles JUnit test que puediera haber presente.
En las siguientes ejecuciones, la configuracion de Maven creada aparecerá disponible desde “Run As” –> “Run Configurations…”: