Crear un archetype web con maven y java

Crear un proyecto web Java usando Maven, basado en un archetype web, que despliegue una página sencilla con tus datos de contacto.

¿Qué es un Archetype en Maven?

En Maven, un archetype es una plantilla de proyecto.

Cuando ejecutas: mvn archetype:generate

Maven:

Descarga el arquetipo
Genera la estructura estándar
Crea el pom.xml
Crea directorios base (src/main/java, src/main/webapp, etc.)

Para aplicaciones web Java usamos: maven-archetype-webapp

Prerrequisitos

Antes de empezar necesitas:

Java JDK 8 o superior
Maven instalado
Variable JAVA_HOME configurada
Comando funcionando:

java -version mvn -version

Crear el proyecto Web con Maven

Para el siguiente proyecto nos guiaremos de https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html

Crearemos una directorio llamado 📁 java-proyects en este directorio ejecutaremos el siguiente comando:

mvn archetype:generate -DgroupId=com.oscar.web -DartifactId=mi-contacto -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

📌 ¿Qué significa cada parámetro?

groupId: Identificador lógico del proyecto (paquete base Java)
artifactId: Nombre del proyecto
archetypeArtifactId: Tipo de plantilla
interactiveMode: Evita preguntas interactivas

mi-contacto
 ├── pom.xml
 └── src
     └── main
         └── webapp
             ├── index.jsp
             └── WEB-INF
                 └── web.xml

Nota: Recomiendo crear un repositorio git y realizar el primer commit para llevar el control de los cambios del proyecto.

Modificar la página con tus datos

Modificar index.jsp

Ingresamos al archivo src/main/webapp/index.jsp remplazamos por

<%@ page contentType="text/html;charset=UTF-8" %>
<!DOCTYPE html>
<html>
<head>
    <title>Mi Información de Contacto</title>
</head>
<body>
    <h1>Información de Contacto</h1>
    <p><strong>Nombre:</strong> Oscar Fernandez</p>
    <p><strong>Email:</strong> codigoelectronica@gmail.com</p>
    <p><strong>Teléfono:</strong> +57 305 3874879</p>
    <p><strong>Ciudad:</strong> Colombia</p>
</body>
</html>

Configurar el POM

Vamos a agregar la versión de java con la que trabajara el proyecto.

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

Modificaremos el build de la siguiente forma

<build>
  <finalName>mi-contacto</finalName>
  <plugins>
      <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.4.0</version>
      </plugin>
  </plugins>
</build>

Compilar el proyecto

Dentro del directorio del proyecto ejecutamos:

mvn clean package

Esto generará: target/mi-contacto.war

Ese .war es el artefacto desplegable.

Desplegar el proyecto

Descargar Tomcat 11

Ve al sitio oficial: 👉 https://tomcat.apache.org

Descarga: Tomcat 11 Core (zip) para Windows

Instalación en Windows

Descomprime en: C:\apache-tomcat-11

Verifica estructura:

C:\apache-tomcat-11
 ├── bin
 ├── conf
 ├── lib
 ├── logs
 ├── webapps

Probar que Tomcat arranca

En consola:

cd C:\apache-tomcat-11\bin

startup.bat

Si todo está correcto verás:

Tomcat started.

Ahora abre: http://localhost:8080 Si ves la página de bienvenida, el servidor está funcionando.

Desplegar tu aplicación WAR

Ve a tu proyecto Maven y ejecuta:

mvn clean package

Se generará: target/mi-contacto.war

Ahora copia ese archivo a: 📁 C:\apache-tomcat-11\webapps

Tomcat detecta automáticamente el WAR y lo descomprime. Se creará: webapps/mi-contacto/

Acceder a tu aplicación

Abre:

http://localhost:8080/mi-contacto

Deberías ver tu página con los datos de contacto.

Ciclo profesional de despliegue

Flujo estándar:

mvn clean package
↓
Genera WAR
↓
Copiar a webapps
↓
Tomcat auto-deploy
↓
Acceder vía navegador

Comentario