Configuración de Smart Tomcat

Esta guía te ayudará a configurar Smart Tomcat en tu entorno de desarrollo, tanto en IntelliJ IDEA como en Visual Studio Code.

Requisitos previos

Asegúrate de tener instalado lo siguiente:

• IntelliJ IDEA Ultimate o Visual Studio Code
• Java JDK 17
• Tomcat 10 o superior
• Maven
• Git

---

Configuración en IntelliJ IDEA

1. Abre IntelliJ IDEA y selecciona New Project.

2. Elige Jakarta EE como plantilla y selecciona Web Application.

3. En Application server, selecciona Tomcat Server y luego Tomcat 10. Si no está configurado, haz clic en New y selecciona la carpeta donde instalaste Tomcat.

   

4. Crea el proyecto y espera a que IntelliJ configure el entorno.

5. Ve a la esquina superior derecha, haz clic en el engranaje de configuración y selecciona Plugins.

6. Busca Smart Tomcat e instálalo.

   

7. Haz clic en el icono de ejecución y selecciona Edit Configurations.

   

8. En la ventana de configuración, selecciona Smart Tomcat y haz clic en el icono + para agregar una nueva configuración.

9. En Tomcat Server, selecciona la ruta de instalación de Tomcat y verifica que el puerto sea el correcto (por defecto, 8080).

   

10. Aplica los cambios y cierra la ventana de configuración.

11. Ahora puedes ejecutar tu aplicación web haciendo clic en el icono de ejecución.

---

Configuración en Visual Studio Code

1. Abre Visual Studio Code y asegúrate de tener instalado el plugin Java Extension Pack.

2. Abre la paleta de comandos (Ctrl+Shift+P) y ejecuta Java: Create Java Project.

3. Selecciona Maven y luego maven-archetype-webapp en su versión más reciente.

   

4. Elige el grupo y artefacto del proyecto (por ejemplo, com.example y my-web-app).

5. Selecciona la ubicación del proyecto y espera a que se cree.

6. Agrega la siguiente dependencia al archivo pom.xml:

   pom.xml

   <dependency>
         <groupId>jakarta.servlet</groupId>
         <artifactId>jakarta.servlet-api</artifactId>
         <version>5.0.0</version>
         <scope>provided</scope>
   </dependency>

7. Crea las siguientes carpetas para organizar tu proyecto:

   • src/main/java/com/example para el código Java.
   • src/main/webapp para los archivos web (HTML, JSP, etc.).

8. La estructura del proyecto debe verse así:

   my-web-app/
   ├── pom.xml
   ├── src/
   │   ├── main/
   │   │   ├── java/com/example/
   │   │   └── webapp/
   │       ├── WEB-INF/
   │       │   └── web.xml
   │       └── index.jsp

9. Crea el archivo HelloServlet.java en src/main/java/com/example:

   HelloServlet.java

   import java.io.*;
   import jakarta.servlet.http.*;
   import jakarta.servlet.annotation.*;
   
   @WebServlet(name = "helloServlet", value = "/hello-servlet")
   public class HelloServlet extends HttpServlet {
       private String message;
   
       public void init() {
            message = "Hello World!";
       }
   
       public void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
            response.setContentType("text/html");
            PrintWriter out = response.getWriter();
            out.println("<html><body>");
            out.println("<h1>" + message + "</h1>");
            out.println("</body></html>");
       }
   
       public void destroy() {
       }
   }

A este punto es bueno hablar sobre lo que significa un Servlet. Un Servlet es una clase Java que maneja solicitudes y respuestas HTTP, permitiendo crear aplicaciones web dinámicas. En este ejemplo, el Servlet HelloServlet responde a las solicitudes GET con un mensaje "Hello World!".

A continuación te muestro un diagrama que expone la ubicación de un servlet dentro de un proyecto web. Recórrelo paso a paso: primero conoces las piezas y luego sigues el viaje de una solicitud hasta el servlet y de vuelta.

El servlet dentro de Tomcat: Coyote, Catalina y los servlets

Como puedes observar, los servlet se encuentran usualmente dentro del Web Server, en este caso Tomcat, y son invocados por el contenedor de servlets cuando se recibe una solicitud HTTP que coincide con su configuración.

En el ciclo de vida de un servlet, puedes observar lo siguiente. Mientras avanzas por el diagrama, fíjate qué línea del código de HelloServlet se ejecuta en cada paso:

Ciclo de vida de un servlet: init, doGet y destroy

• El servlet es cargado en el Web Container cuando se recibe una solicitud.
• Luego se crea una instancia de dicho servlet.
• El método init() es llamado para inicializar el servlet.
• Cuando se recibe una solicitud, el método doGet() o doPost() es invocado dependiendo del tipo de solicitud.
• Finalmente, cuando el servlet ya no es necesario, el método destroy() es llamado para liberar recursos.

10. Compila el proyecto con Maven. En la terminal ejecuta:

    mvn clean compile

11. Instala la extensión Community Server Connectors desde el marketplace de VS Code.

    

12. Haz clic en el tab Servers (parte inferior izquierda), haz clic derecho en Community Server Connectors y selecciona Create new server.

    

13. Selecciona Tomcat y la versión instalada, luego haz clic en Finish.

14. Empaqueta tu aplicación web ejecutando:

    mvn clean package

15. Haz clic derecho sobre el Tomcat creado y selecciona Add deployment.

    

16. Selecciona el archivo WAR generado en target/my-web-app.war.

17. Inicia el servidor Tomcat haciendo clic derecho en el servidor y seleccionando Start.

18. Abre tu navegador y accede a http://localhost:8080/my-web-app/ para ver tu aplicación en funcionamiento.