Introducción a Maven - eliizquierdo/material_programacion_avanzada2026 GitHub Wiki

Vamos a introducirnos en el uso de Maven, una herramienta muy utilizada en proyectos Java para automatizar la compilación y gestionar dependencias.
Una de sus grandes ventajas es que nos permite unificar la estructura del proyecto y declarar todas sus librerías externas en un único archivo: pom.xml.

Cuando creamos un proyecto con Maven, obtenemos una estructura estándar como esta:

• /src/main/webapp: en esta carpeta colocamos los archivos web (HTML, JSP).

• pom.xml: es el corazón del proyecto, donde declaramos todo lo necesario para construirlo. En el archivo pom.xml definimos elementos como:

• groupId: el grupo o institución responsable.

• artifactId: el nombre del proyecto.

• version: la versión del artefacto.

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.utu</groupId>
  <artifactId>demo1</artifactId>
  <version>1.0</version>
</project>

Vamos a crear nuestro primer proyecto con Maven directamente desde Visual Studio Code:

1. Abrimos VSCode y seleccionamos una carpeta de trabajo con Open Folder....

Vamos a poder ver un archivo index.jsp como punto de inicio.

Para que nuestra app web funcione correctamente, vamos a agregar las dependencias para trabajar con servlets y JSTL, y los plugins para empaquetar y desplegar en Tomcat.

Dentro de <properties>, agregamos una propiedad con la ruta donde descomprimimos Tomcat:

<tomcat.home>C:\apache-tomcat-10.1.57</tomcat.home>

⚠️ Si nuestro Tomcat está en otra carpeta o tiene otro número de versión, cambiamos esta línea por la ruta real. Es el único lugar del pom.xml donde aparece la ruta.

Entre las etiquetas <dependencies>, agregamos:

<dependency>
  <groupId>jakarta.servlet</groupId>
  <artifactId>jakarta.servlet-api</artifactId>
  <version>6.0.0</version>
  <scope>provided</scope>
</dependency>
<dependency>
  <groupId>jakarta.servlet.jsp.jstl</groupId>
  <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
  <version>3.0.0</version>
</dependency>
<dependency>
  <groupId>org.glassfish.web</groupId>
  <artifactId>jakarta.servlet.jsp.jstl</artifactId>
  <version>3.0.1</version>
</dependency>

⚠️ Ojo con el groupId/artifactId: es jakarta.servlet (no javax.servlet). Tomcat 10 y versiones posteriores usan el namespace jakarta.*.

💡 La Servlet API lleva scope provided porque Tomcat ya la trae. JSTL, en cambio, no viene con Tomcat: por eso se empaqueta dentro del .war. La usaremos más adelante con las etiquetas <c:...>.

Dentro de <plugins>, vamos a incluir:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-war-plugin</artifactId>
  <version>3.4.0</version>
  <configuration>
    <failOnMissingWebXml>false</failOnMissingWebXml>
  </configuration>
</plugin>
<plugin>
  <groupId>org.codehaus.cargo</groupId>
  <artifactId>cargo-maven3-plugin</artifactId>
  <version>1.10.13</version>
  <configuration>
    <container>
      <containerId>tomcat10x</containerId>
      <home>${tomcat.home}</home>
    </container>
    <configuration>
      <type>existing</type>
      <home>${tomcat.home}</home>
    </configuration>
  </configuration>
</plugin>

• maven-war-plugin: genera el .war. Fijamos la versión para que el proyecto se compile igual en todas las máquinas.
• cargo-maven3-plugin: despliega el .war en el Tomcat que indicamos en tomcat.home.

💡 Si en una máquina Tomcat está en otra ruta, también se puede indicar al ejecutar, sin tocar el pom.xml: mvn cargo:run -Dtomcat.home=D:\otra\ruta.

⚠️ También se pueden agregar dependencias gráficamente desde la pestaña Maven, haciendo clic derecho sobre "Dependencies" → "Add Dependency".

Este es el pom.xml que usan todos los proyectos web del curso. Para un proyecto nuevo, solo cambiamos artifactId, name y finalName.

Desde la terminal integrada (Ctrl+Ñ), escribimos:

mvn clean package
mvn cargo:run

Vamos a ver que se genera un .war, y luego el proyecto se desplegará en el Tomcat 10.1 instalado, accesible en:

http://localhost:8080/demo1

Que se verá así en el navegador

Vamos a editar el archivo index.jsp para probar que todo funciona:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Hola desde VS con Maven</title>
  </head>
  <body>
    <h1>Mi primer archivo JSP</h1>
    <p>Este es mi primer proyecto creado utilizando Maven y VS</p>
  </body>
</html>

Guardamos el archivo y recargamos el navegador. Ya deberíamos ver nuestra página personalizada.

Para trabajar con servlets, vamos a crear una clase Java:

Para ir acostumbrandonos a la estructura que usaremos más adelante lo haremos así:

1. Creamos una carpeta (Folder) llamada java en /src/main
2. Creamos un package dentro de /src/main/java, llamado controlador.
3. Dentro del package controlador, creamos el archivo PrimerServlet.java. Agregamos el siguiente código (más adelante se explicará) para probar:

package controlador;
 
import java.io.IOException;
import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.*;
 
@WebServlet("/Servlet1")
public class PrimerServlet extends HttpServlet {
  protected void doGet(HttpServletRequest request, HttpServletResponse response)
          throws ServletException, IOException {
      response.setContentType("text/html;charset=UTF-8");
      response.getWriter().println("<h1>Hola desde el VS Code</h1>");
  }
}

3. En el archivo index.jsp, agregamos un enlace:

<a href="Servlet1">Ir al servlet</a>

Repetimos los comandos para compilar y desplegar:

mvn clean package
mvn cargo:run

Y ahora, al hacer clic en el enlace, vamos a ver el contenido del servlet.

📦 Proyecto: demo1 (Introducción a Maven) — ⬇️ Descargar · ☁️ Abrir en Codespace

Maven · pom.xml · dependencias · groupId · artifactId · version · maven-archetype-webapp · mvn clean package · cargo:run · jakarta.servlet-api · scope provided · estructura de proyecto Maven · cargo-maven3-plugin

🧠 Autoevaluación — Maven

← Mini Tutorial de HTML · 🏠 Inicio · Ciclo de una petición web →