Index / Java / Aplicaciones java con Maven

Aplicaciones java con Maven

Autor jc mouse domingo, junio 25, 2017

¿Qué es Maven?

Maven es una herramienta de software para la gestión y construcción de proyectos Java. Provee un conjunto de estándares de construcción, un modelo de repositorio de artefactos y un motor de software que administra y describe los proyectos. Maven utiliza un Project Object Model (POM) para describir el proyecto de software a construir, sus dependencias de otros módulos y componentes externos, y el orden de construcción de los elementos.

Para crear proyectos java con Maven se usan comandos, sin embargo el soporte para Maven está totalmente integrado en NetBeans por lo que desarrollar un proyecto que utiliza el framework Maven es casi idéntico al desarrollo de un proyecto standar, sin embargo existen algunas diferencias relacionadas con la forma en que Maven crea proyectos y trabaja con dependencias, diferencias que iremos aprendiendo a reconocer y utilizar en este post.

En este tutorial se muestra como crear una aplicación java con Maven, el IDE Netbeans y una librería para el parseo de HTML Jsoup.

Necesitamos:

Netbeans 8.x
Conexión a internet
JSoup Librería para parsear HTML (https://jsoup.org/)

Paso 1: El Proyecto Maven

Archivo → New Project → en Category seleccionamos «Maven» → y en Projects seleccioamos «Java Application«, presionamos siguiente para continuar.

En la siguiente ventana escribimos el nombre del proyecto «TestMaven» e indicamos su ubicación

Pero tenemos unos cuantos campos más que rellenar:

ID del Artefacto: TestMaven, es el nombre del proyecto (sin espacios)
ID del Grupo: com.jcmouse, indica a que organización/grupo pertenece este artefacto (org.java, bo.edu.umss, etc) , un grupo puede tener varios artefactos, pero un artefacto solo puede pertenecer a un grupo.
Versión: 1.0.1, tal cual se refiere a la versión del artefacto
Paquete: com.jcmouse.testmaven, son las carpetas donde ira el código java

Para crear el proyecto, presionamos «Terminar»

La estructura del proyecto es ligeramente diferente a la de una aplicación standar de Java SE pero ya veremos que no hay nada que temer, ya que funcionan casi de la misma forma.

Paso 2. Dependencias

Cuando trabajamos con una aplicación standar de Java SE, descargamos las librerías (*.jar) que necesitamos y las colocamos en la carpeta «Bibliotecas«, en Maven lo que hacemos es declarar esas librerías en el archivo POM ( Project Object Model)

Si ingresamos a la sección de descarga de JSOUP (https://jsoup.org/download), tenemos la opción de descargar el *.JAR pero más abajo encontraremos la opción de como usar la librería con Maven

En el proyecto en netbeans, clic derecho sobre la carpeta «Dependencias» → Agregar dependencias, en la ventana que aparece rellenamos los campos de JSOUP como se ve en la siguiente imagen:

Para agregar las dependencias, presionamos el botón «agregar» y veremos como aparece la librería JSOUP en la sección de dependencias

Y si abrimos el archivo pom.xml con doble clic, vemos como se agrego en XML las dependencias a la librería JSOUP

de igual forma, si presionamos el botón de «Grafica» se nos pintara una representación de la dependencia

Paso 3: Usando la dependencia

La dependencia se usa igual que cualquier otra librería, lo único que cambio en maven, es la forma de hacer referencia a dicha librería.

En la carpeta de fuentes, crea una clase Main.java, clic derecho sobre el proyecto → Properties (Propiedades).

Debemos también indicar al proyecto que esta clase, es la clase principal, clic en Ejecutar, en Main Class, presionando el botón examinar, seleccionamos la clase Main que acabos de crear y clic en Aceptar para guardar los cambios.

A continuación agregamos el siguiente código:

package com.jcmouse.testmaven;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.select.Elements;
/**
 * @see http://www-jc-mouse.net
 * @author mouse
 */
public class Main {
    
    public static void main(String[] args) {
        //Codigo HTML
        String HTML = "<html><head>"
                + "<title>Mi Primera Pagina Web</title>"
                + "</head>"
                + "<body>HOLA MUNDO CRUEL!!!</body>"
                + "</html>";
        //se obtiene etiquetas HTML
        Document document = Jsoup.parse(HTML);
        Elements allElements = document.getAllElements();        
        allElements.stream().forEach((element) -> {
            System.out.println( element.nodeName() + " " + element.ownText());
        });
    }
    
}

La librería JSOUP nos sirve para parsear etiquetas HTML, el código de arriba es un ejemplo trivial cuyo único objetivo es demostrar el uso de una librería con Maven.

Paso 4. Ejecución

Al igual que un proyecto standar java se, ejecutamos con clic derecho sobre el proyecto → run

~~Importante~~, si es la primera vez que usas Maven, la compilación y ejecución del proyecto se tardara unos minutos (deprendiendo de tu conexión a internet) esto porque Maven debe descargar algunas otras librerías que necesita para funcionar, ademas de que esta creando un repositorio local en tu computadora. De eso hablaremos en otra ocasión.

El resultado en consola de este proyecto es el siguiente:

Paso 5. Ejecutables

Como mencionamos en un principio la estructura de una aplicación en Netbeans con Maven es diferente a la de una aplicación standar java se, y esto es igual con sus carpetas en el disco.

En la carpeta SRC se guardan las fuentes del proyecto, mientras en la carpeta TARGET, se encuentran otros archivos referentes a Maven, la compilación y los ejecutables JAR.

Si hacemos Clic derecho sobre el proyecto -> Build y abrimos la carpeta target, veremos que se genero un archivo jar ejecutable «TestMaven-1.0.1.jar«, pero este jar no contiene el archivo manifest donde se indica la clase principal Main y las dependencias de este, si tratamos de ejecutarlo tendremos problemas. A continuación dos formas de generar ejecutables con proyectos con Maven.

Generar solo Jar Ejecutable

Abre el archivo pom.xml y antes de la etiqueta </project> agrega el siguiente código:

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.0.2</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <mainClass>com.jcmouse.testmaven.Main</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>

Donde en <mainClass> indicamos los paquetes y clase Main.

Clic derecho sobre el proyecto -> Build para generar el *.jar

Nuestra aplicación no cuenta con interfaz por lo que deberemos ejecutarlo desde consola, es decir:

~~Importante~~ en este caso la librería JSoup debería estar en el PATH o en la misma carpeta que nuestro archivo TestMaven-1.0.1.jar, caso contrario nos dará error (java.lang.NoClassDefFoundError: org/jsoup/Jsoup).

Ejecutable JAR con dependencias

Abre el archivo pom.xml y antes de la etiqueta </project> agrega el siguiente código:

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.0.0</version>
                <configuration>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                    <archive>
                        <manifest>
                            <mainClass>com.jcmouse.testmaven.Main</mainClass>
                        </manifest>
                    </archive>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>                         
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>