¿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:
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:
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>
Donde en <mainClass> indicamos los paquetes y clase Main.
Clic derecho sobre el proyecto -> Build para generar el *.jar
En este caso veremos como nuestro jar ha crecido, esto porque ademas del código de nuestra aplicación (4KB), adjunto las clases de la librería JSoup.
Y para terminar, lo ejecutamos desde consola:
java -jar TestMaven-1.0.1-jar-with-dependencies.jar
enjoy!!!
Kotlin es un lenguaje de programación relativamente nuevo que ha ido ganando terreno en el desarrollo de aplicaciones pa[...]
El Tangram es un juego chino muy antiguo, esta compuesto por 7 piezas: un paralelogramo (romboide), un cuadrado y 5 triá[...]
Segunda y ultima parte del post dedicado a la creación de un microservicio en lenguaje java utilizando el framework Spar[...]
MVC es un patrón de arquitectura de software que separa una aplicación en tres componentes lógicos principales. Estos s[...]
Un ProgressDialog muestra una ventana con un texto y una barra de progreso que indica el tiempo que tarda una tarea en r[...]
En esta oportunidad, se deja a disposición de la comunidad de programadores de Bolivia y también porque no, del que quie[...]
