S01L03 - Programa Java HelloWorld con Maven

html

Crear un Proyecto Maven en IntelliJ IDEA: Una Guía Completa
Tabla de Contenidos

Introducción
Configurando Tu Proyecto Maven

Iniciando IntelliJ IDEA y Comenzando un Nuevo Proyecto
Configurando los Detalles del Proyecto


Entendiendo pom.xml

Configurando Fuente y Objetivo del Compilador
Definiendo el Tipo de Empaquetado


Creando y Gestionando Paquetes

Agregando Código de Ejemplo


Construyendo y Ejecutando Tu Aplicación

Ejecutando la Aplicación en IntelliJ IDEA
Generando el Archivo JAR Usando Maven


Problemas Comunes y Solución de Problemas
Conclusión


Introducción
Bienvenido a esta guía completa sobre cómo crear un proyecto Maven en IntelliJ IDEA. Si eres un principiante o un desarrollador con conocimientos básicos que busca optimizar la gestión de tus proyectos Java, Maven es una herramienta esencial en tu conjunto de herramientas. Esta guía te guiará a través del proceso de configuración de un proyecto Maven, configurando ajustes esenciales, escribiendo código de ejemplo y construyendo tu aplicación en un archivo JAR.
¿Por Qué Usar Maven?
Maven simplifica la automatización de la construcción del proyecto, la gestión de dependencias y los estándares de estructura del proyecto. Mejora la productividad al proporcionar un sistema de construcción uniforme y reduce las complejidades involucradas en la gestión de proyectos grandes.
Pros y Contras de Usar Maven


Pros
Cons


Simplifica la gestión de dependencias
Curva de aprendizaje más pronunciada para principiantes


Estandariza la estructura del proyecto
Puede ser verboso con la configuración


Facilita la integración con IDEs
Depurar problemas de Maven puede ser desafiante


Mejora la automatización de la construcción
Puede introducir sobrecarga para proyectos pequeños


Cuándo Usar Maven
Maven es ideal para proyectos Java de mediana a gran escala que requieren procesos de construcción estandarizados y una gestión eficiente de dependencias. Es particularmente beneficioso cuando se colabora en equipos, asegurando consistencia a través de los entornos de desarrollo.

Configurando Tu Proyecto Maven
Iniciando IntelliJ IDEA y Comenzando un Nuevo Proyecto

Abre IntelliJ IDEA: Inicia la aplicación IntelliJ IDEA en tu computadora.
Crear un Nuevo Proyecto: Haz clic en la opción "New Project" desde la pantalla de bienvenida o navega a File > New > Project.

    

    

    Figura 1: Iniciando un Nuevo Proyecto en IntelliJ IDEA.
  

Configurando los Detalles del Proyecto

Seleccionar Maven: En la ventana "New Project", elige Maven como tu tipo de proyecto.

    

    

    Figura 2: Seleccionando Maven como el Tipo de Proyecto.
  
Nombre y Ubicación del Proyecto:

Nombre: Ingresa Hello World.
Ubicación: Usa la ubicación predeterminada de Idea Project o especifica un directorio preferido.


Versión de JDK: Selecciona JDK 17, la versión de Soporte a Largo Plazo (LTS), asegurando compatibilidad y estabilidad.
Maven Archetype: Omite la selección de un arquetipo Maven para mayor simplicidad.
Group ID y Artifact ID:

Group ID: Ingresa org.studyeasy.
Artifact ID: Ingresa hello-world (asegúrate de que no tenga espacios).


Finalizar Creación: Haz clic en Create para generar la estructura del proyecto Maven.


Entendiendo pom.xml
El archivo pom.xml es el corazón de tu proyecto Maven, gestionando la configuración del proyecto, dependencias y ajustes de construcción.
Configurando Fuente y Objetivo del Compilador




		
		
			
			
Java
			
			<project xmlns="http://maven.apache.org/POM/4.0.0" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.studyeasy</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
</project>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
				
						<project xmlns="http://maven.apache.org/POM/4.0.0" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.studyeasy</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
 
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
</project>
					
				
			
		


Figura 3: Configuración de Ejemplo de pom.xml.
Explicación:

maven.compiler.source y maven.compiler.target: Ambos están configurados a 17, alineándose con la versión de JDK seleccionada.
packaging: Definido como jar para especificar el tipo de artefacto de salida.

Definiendo el Tipo de Empaquetado
Configurar el tipo de empaquetado a jar asegura que el proceso de construcción genere un archivo JAR, un formato común para aplicaciones Java.

Creando y Gestionando Paquetes
Agregando Código de Ejemplo
Tras la creación del proyecto, IntelliJ IDEA genera los directorios necesarios y un archivo Java de ejemplo.

Paquete Predeterminado: Navega al directorio src/main/java para encontrar el archivo main.java.
Creando un Nuevo Paquete (si es necesario):

Haz clic derecho en src/main/java.
Selecciona New > Package.
Nombrarlo org.studyeasy.


Código de Ejemplo: Aquí hay un programa Java simple para mostrar un mensaje de bienvenida.





		
		
			
			
Java
			
			package org.studyeasy;

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello and welcome.");
    }
}
			
				
					
				
					1
2
3
4
5
6
7
				
						package org.studyeasy;
 
public class Main {
    public static void main(String[] args) {
        System.out.println("Hello and welcome.");
    }
}
					
				
			
		


Figura 4: Código Java de Ejemplo con Comentarios.
Explicación:

Declaración de Paquete: org.studyeasy asegura una estructura de código organizada.
Clase Principal: Contiene el método main, el punto de entrada de la aplicación.
Declaración de Impresión: Muestra "Hello and welcome." en la consola.


Construyendo y Ejecutando Tu Aplicación
Ejecutando la Aplicación en IntelliJ IDEA

Ejecutar el Programa:

Haz clic en el botón Run en la barra de herramientas.
Alternativamente, haz clic derecho en la clase Main y selecciona Run 'Main.main()'.


    

    Figura 5: Ejecutando la Aplicación.
  
Salida:




		
		
			
			
Java
			
			Hello and welcome.
			
				
					
				
					1
				
						Hello and welcome.
					
				
			
		


Esto confirma que la aplicación se está ejecutando correctamente.


Generando el Archivo JAR Usando Maven

Editar Configuración:

Navega a Run > Edit Configurations.
Haz clic en el ícono + para agregar una nueva configuración.
Selecciona Maven.


Definir Objetivos de Maven:

Línea de Comandos: Ingresa clean package.

clean: Elimina el directorio target para asegurar una construcción limpia.
package: Compila el código y lo empaqueta en un archivo JAR como se define en pom.xml.



      

      Figura 6: Configurando Objetivos de Maven.
    

Ejecutar la Construcción de Maven: Haz clic en Apply y luego en Run. Maven ejecutará los objetivos definidos, generando el archivo JAR en el directorio target.
Manejando Advertencias:

Podrías encontrarte con advertencias relacionadas con el archivo manifest. Estas son comunes y pueden ser abordadas en tutoriales posteriores.




Problemas Comunes y Solución de Problemas
Error en el Archivo Manifest
Después de generar el archivo JAR, intentar ejecutarlo puede resultar en un error en el archivo manifest. Esto ocurre porque el JAR carece de los metadatos necesarios para ejecutar el método main.
Solución:

Define el mainClass en el pom.xml para especificar el punto de entrada.





		
		
			
			
Java
			
			<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>org.studyeasy.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
				
						<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>org.studyeasy.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
					
				
			
		


Explicación:

maven-jar-plugin: Especifica la configuración del plugin JAR.
mainClass: Apunta a la clase Main que contiene el método main.


Reconstruir el Proyecto: Ejecuta clean package nuevamente para generar el JAR actualizado con el manifest correcto.

Enfoque Alternativo:

Usa el Shade Plugin de Maven u otros plugins de ensamblaje para necesidades de empaquetado más complejas.


Conclusión
Crear un proyecto Maven en IntelliJ IDEA es un proceso simplificado que mejora tu flujo de trabajo en el desarrollo de Java. Siguiendo esta guía, has aprendido cómo configurar un proyecto Maven, configurar ajustes esenciales, escribir código de ejemplo y construir tu aplicación en un archivo JAR ejecutable. La estructura estandarizada y las capacidades de gestión de dependencias de Maven lo convierten en una herramienta invaluable tanto para principiantes como para desarrolladores experimentados.
Conclusiones Clave

Integración de Maven: Se integra perfectamente con IntelliJ IDEA, simplificando la configuración del proyecto.
Configuración de pom.xml: Centraliza los ajustes del proyecto, dependencias e instrucciones de construcción.
Proceso de Construcción Eficiente: Comandos como clean package automatizan las construcciones y el empaquetado.
Solución de Problemas: Entender problemas comunes como errores en el archivo manifest es crucial para un desarrollo fluido.

Aprovecha Maven para elevar tus proyectos Java, asegurando consistencia, escalabilidad y eficiencia en tus esfuerzos de desarrollo.


  #Maven #IntelliJIDEA #Java #DesarrolloJava #GuíaMaven #ProgramaciónJava #GestiónDeProyectos #AutomatizaciónDeConstrucción #Dependencias #ConfiguraciónMaven
Pros	Cons
Simplifica la gestión de dependencias	Curva de aprendizaje más pronunciada para principiantes
Estandariza la estructura del proyecto	Puede ser verboso con la configuración
Facilita la integración con IDEs	Depurar problemas de Maven puede ser desafiante
Mejora la automatización de la construcción	Puede introducir sobrecarga para proyectos pequeños