S05L01 - Proyecto mínimo de SpringMVC

html

Construyendo una Aplicación Spring MVC Utilizando Spring Framework: Una Guía Paso a Paso
Tabla de Contenidos

Introducción - Página 1
Configurando el Proyecto Maven - Página 2

Creando una Nueva Aplicación Web Maven
Configurando pom.xml


Configurando Spring Framework - Página 5

Actualizando la Versión de Java
Configurando web.xml
Creando la Configuración de Spring


Desarrollando los Componentes MVC - Página 9

Creando el Controlador
Diseñando la Vista


Ejecutando la Aplicación - Página 13
Conclusión - Página 15


Introducción
Bienvenido a esta guía completa para construir una aplicación basada en Spring MVC utilizando Spring Framework. Aunque Spring Boot se ha vuelto cada vez más popular en la industria por su facilidad de configuración y puesta en marcha, comprender el Spring Framework subyacente proporciona una base sólida para configuraciones avanzadas y personalizaciones.
Importancia y Propósito
Esta guía tiene como objetivo equipar a principiantes y desarrolladores con conocimientos básicos para crear una aplicación web MVC (Modelo-Vista-Controlador) robusta utilizando Spring Framework. Al final de esta guía, comprenderás cómo configurar un proyecto Maven, configurar dependencias de Spring, desarrollar componentes MVC y ejecutar tu aplicación con éxito.
Pros y Contras de Usar Spring Framework


Pros
Contras


Conjunto de características completas
Curva de aprendizaje más pronunciada en comparación con Spring Boot


Flexibilidad y control sobre la configuración
Más código repetitivo


Amplia comunidad y documentación
Gestión manual de dependencias


Adecuado para aplicaciones empresariales a gran escala
Proceso de configuración más lento


Cuándo y Dónde Usar Spring Framework
Opta por Spring Framework cuando requieras un control detallado sobre la configuración de tu aplicación, especialmente en entornos empresariales a gran escala donde la personalización es primordial.

Configurando el Proyecto Maven
Creando una Nueva Aplicación Web Maven
Para comenzar, inicia una nueva aplicación web basada en Maven. Maven agiliza la gestión del proyecto al manejar dependencias y configuraciones de construcción.

Iniciar un Nuevo Proyecto Maven:

Abre tu IDE y crea un nuevo proyecto Maven.
Selecciona el arquetipo apache.maven.
Elige crear una Aplicación Web ya que estamos desarrollando una aplicación web basada en MVC.


Convenciones de Nomenclatura del Proyecto:

ID de Grupo: org.studyeasy
ID de Artefacto: S05L01-SpringMinimalSetup

Esta convención de nomenclatura ayuda a organizar y gestionar tu proyecto de manera eficiente.

Finalizar la Configuración del Proyecto:

Haz clic en Finish para generar la estructura del proyecto.
Maven construirá el proyecto según las configuraciones especificadas.



Configurando pom.xml
El archivo pom.xml es crucial ya que maneja las dependencias del proyecto y las configuraciones de construcción.

Navega al pom.xml:

Localiza el archivo pom.xml en el directorio de tu proyecto.


Añadir Dependencias Necesarias:
Asegúrate de que las siguientes dependencias estén incluidas para Spring MVC:
    




		
		
			
			
Java
			
			
&lt;dependencies&gt;
    &lt;!-- Spring Core --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-core&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Spring Context --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-context&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Spring Web MVC --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-webmvc&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Jakarta Servlet --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;jakarta.servlet&lt;/groupId&gt;
        &lt;artifactId&gt;jakarta.servlet-api&lt;/artifactId&gt;
        &lt;version&gt;5.0.0&lt;/version&gt;
        &lt;scope&gt;provided&lt;/scope&gt;
    &lt;/dependency&gt;
    
    &lt;!-- JSP Support --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;javax.servlet&lt;/groupId&gt;
        &lt;artifactId&gt;jstl&lt;/artifactId&gt;
        &lt;version&gt;1.2&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- JUnit for Testing (Optional) --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;junit&lt;/groupId&gt;
        &lt;artifactId&gt;junit&lt;/artifactId&gt;
        &lt;version&gt;4.13.2&lt;/version&gt;
        &lt;scope&gt;test&lt;/scope&gt;
    &lt;/dependency&gt;
&lt;/dependencies&gt;
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
				
						 
&lt;dependencies&gt;
    &lt;!-- Spring Core --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-core&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Spring Context --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-context&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Spring Web MVC --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework&lt;/groupId&gt;
        &lt;artifactId&gt;spring-webmvc&lt;/artifactId&gt;
        &lt;version&gt;5.3.20&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- Jakarta Servlet --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;jakarta.servlet&lt;/groupId&gt;
        &lt;artifactId&gt;jakarta.servlet-api&lt;/artifactId&gt;
        &lt;version&gt;5.0.0&lt;/version&gt;
        &lt;scope&gt;provided&lt;/scope&gt;
    &lt;/dependency&gt;
    
    &lt;!-- JSP Support --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;javax.servlet&lt;/groupId&gt;
        &lt;artifactId&gt;jstl&lt;/artifactId&gt;
        &lt;version&gt;1.2&lt;/version&gt;
    &lt;/dependency&gt;
    
    &lt;!-- JUnit for Testing (Optional) --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;junit&lt;/groupId&gt;
        &lt;artifactId&gt;junit&lt;/artifactId&gt;
        &lt;version&gt;4.13.2&lt;/version&gt;
        &lt;scope&gt;test&lt;/scope&gt;
    &lt;/dependency&gt;
&lt;/dependencies&gt;
    
					
				
			
		


  
Actualizar el Proyecto Maven:

Haz clic derecho en el proyecto y selecciona Maven > Update Project.
Marca Force Update of Snapshots/Releases y haz clic en OK.
Maven descargará e integrará las dependencias especificadas.




Configurando Spring Framework
Actualizando la Versión de Java
Asegúrate de que tu proyecto utilice una versión adecuada de Java para compatibilidad y rendimiento.

Configurar Versión de Java a 17:
Abre pom.xml y actualiza la versión de Java:
    




		
		
			
			
Java
			
			
&lt;properties&gt;
    &lt;maven.compiler.source&gt;17&lt;/maven.compiler.source&gt;
    &lt;maven.compiler.target&gt;17&lt;/maven.compiler.target&gt;
&lt;/properties&gt;
    
			
				
					
				
					1
2
3
4
5
6
				
						 
&lt;properties&gt;
    &lt;maven.compiler.source&gt;17&lt;/maven.compiler.source&gt;
    &lt;maven.compiler.target&gt;17&lt;/maven.compiler.target&gt;
&lt;/properties&gt;
    
					
				
			
		


  
Recargar el Proyecto Maven:
Después de actualizar, refresca el proyecto Maven para aplicar los cambios.


Configurando web.xml
El archivo web.xml configura los ajustes de despliegue para tu aplicación web.

Localizar web.xml:

Navega a src/main/webapp/WEB-INF/web.xml.


Configuración Básica:

    



		
		
			
			
Java
			
			
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;web-app xmlns="http://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://jakarta.ee/xml/ns/jakartaee
                             http://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0"&gt;
     
    &lt;display-name&gt;SpringMinimalSetup&lt;/display-name&gt;
     
    &lt;!-- Configuración de Dispatcher Servlet --&gt;
    &lt;servlet&gt;
        &lt;servlet-name&gt;SpringSample&lt;/servlet-name&gt;
        &lt;servlet-class&gt;org.springframework.web.servlet.DispatcherServlet&lt;/servlet-class&gt;
        &lt;init-param&gt;
            &lt;param-name&gt;contextConfigLocation&lt;/param-name&gt;
            &lt;param-value&gt;/WEB-INF/SpringSample-servlet.xml&lt;/param-value&gt;
        &lt;/init-param&gt;
        &lt;load-on-startup&gt;1&lt;/load-on-startup&gt;
    &lt;/servlet&gt;
     
    &lt;servlet-mapping&gt;
        &lt;servlet-name&gt;SpringSample&lt;/servlet-name&gt;
        &lt;url-pattern&gt;/&lt;/url-pattern&gt;
    &lt;/servlet-mapping&gt;
     
&lt;/web-app&gt;
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
				
						 
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;web-app xmlns="http://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://jakarta.ee/xml/ns/jakartaee
                             http://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0"&gt;
     
    &lt;display-name&gt;SpringMinimalSetup&lt;/display-name&gt;
     
    &lt;!-- Configuración de Dispatcher Servlet --&gt;
    &lt;servlet&gt;
        &lt;servlet-name&gt;SpringSample&lt;/servlet-name&gt;
        &lt;servlet-class&gt;org.springframework.web.servlet.DispatcherServlet&lt;/servlet-class&gt;
        &lt;init-param&gt;
            &lt;param-name&gt;contextConfigLocation&lt;/param-name&gt;
            &lt;param-value&gt;/WEB-INF/SpringSample-servlet.xml&lt;/param-value&gt;
        &lt;/init-param&gt;
        &lt;load-on-startup&gt;1&lt;/load-on-startup&gt;
    &lt;/servlet&gt;
     
    &lt;servlet-mapping&gt;
        &lt;servlet-name&gt;SpringSample&lt;/servlet-name&gt;
        &lt;url-pattern&gt;/&lt;/url-pattern&gt;
    &lt;/servlet-mapping&gt;
     
&lt;/web-app&gt;
    
					
				
			
		


  
Explicación:

DispatcherServlet: Componente central que maneja las solicitudes entrantes.
contextConfigLocation: Especifica el archivo de configuración de Spring.
Servlet Mapping: Dirige todas las solicitudes (/) a DispatcherServlet.



Creando la Configuración de Spring
Define configuraciones específicas de Spring para gestionar beans y ajustes de MVC.

Crear SpringSample-servlet.xml:

Navega a src/main/webapp/WEB-INF/ y crea SpringSample-servlet.xml.


Añadir Detalles de Configuración:

    



		
		
			
			
Java
			
			
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context 
                           http://www.springframework.org/schema/context/spring-context.xsd"&gt;
     
    &lt;!-- Escaneo de Componentes --&gt;
    &lt;context:component-scan base-package="org.studyeasy"/&gt;
     
    &lt;!-- View Resolver --&gt;
    &lt;bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"&gt;
        &lt;property name="prefix" value="/WEB-INF/views/"/&gt;
        &lt;property name="suffix" value=".jsp"/&gt;
    &lt;/bean&gt;
     
&lt;/beans&gt;
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
				
						 
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
                           http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context 
                           http://www.springframework.org/schema/context/spring-context.xsd"&gt;
     
    &lt;!-- Escaneo de Componentes --&gt;
    &lt;context:component-scan base-package="org.studyeasy"/&gt;
     
    &lt;!-- View Resolver --&gt;
    &lt;bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"&gt;
        &lt;property name="prefix" value="/WEB-INF/views/"/&gt;
        &lt;property name="suffix" value=".jsp"/&gt;
    &lt;/bean&gt;
     
&lt;/beans&gt;
    
					
				
			
		


  
Explicación:

Escaneo de Componentes: Permite que Spring detecte y gestione beans dentro del paquete especificado.
View Resolver: Configura la ruta y la extensión de archivo para las plantillas de vista (JSP).




Desarrollando los Componentes MVC
Creando el Controlador
El controlador maneja las solicitudes entrantes, las procesa y devuelve vistas apropiadas.

Crear MainController.java:

Navega a src/main/java/org/studyeasy/ y crea MainController.java.


Código del Controlador con Comentarios:

    



		
		
			
			
Java
			
			
package org.studyeasy;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class MainController {

    @RequestMapping(value = "/", method = RequestMethod.GET)
    public String home() {
        // Returns the name of the view to render
        return "home";
    }
}
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
				
						 
package org.studyeasy;
 
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
 
@Controller
public class MainController {
 
    @RequestMapping(value = "/", method = RequestMethod.GET)
    public String home() {
        // Returns the name of the view to render
        return "home";
    }
}
    
					
				
			
		


  
Explicación:

@Controller: Indica que esta clase sirve como un controlador Spring MVC.
@RequestMapping: Mapea solicitudes HTTP a métodos manejadores.
Método home: Maneja solicitudes GET a la URL raíz (/) y retorna la vista home.



Diseñando la Vista
La vista define la interfaz de usuario presentada al usuario.

Crear home.jsp:

Navega a src/main/webapp/WEB-INF/views/ y crea home.jsp.


Código de la Vista:

    



		
		
			
			
Java
			
			
&lt;%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%&gt;
&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;title&gt;Home Page&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;h3&gt;Bienvenido al Mundo de Spring MVC&lt;/h3&gt;
&lt;/body&gt;
&lt;/html&gt;
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
				
						 
&lt;%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%&gt;
&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;title&gt;Home Page&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;h3&gt;Bienvenido al Mundo de Spring MVC&lt;/h3&gt;
&lt;/body&gt;
&lt;/html&gt;
    
					
				
			
		


  
Explicación:

Estructura HTML: HTML básico para mostrar un mensaje de bienvenida.
Archivo JSP: Sirve como la vista renderizada por el controlador.




Ejecutando la Aplicación
Después de configurar todas las configuraciones y desarrollar los componentes MVC, es hora de ejecutar y probar la aplicación.

Construir el Proyecto:

Haz clic derecho en el proyecto y selecciona Run As > Maven build...
Ingresa package en el campo Goals y haz clic en Run.


Implementar en el Servidor:

Asegúrate de tener configurado Apache Tomcat como tu servidor.
Haz clic derecho en el proyecto y selecciona Run As > Run on Server.
Elige Apache Tomcat (preferiblemente la versión 9) y procede.


Acceder a la Aplicación:

Abre un navegador web y navega a http://localhost:8080/S05L01-SpringMinimalSetup/.
Deberías ver la Página de Inicio con el mensaje "Welcome to the World of Spring MVC".


Solución de Problemas:

Problemas Comunes:

Errores de Dependencia: Asegúrate de que todas las dependencias Maven estén correctamente especificadas y descargadas.
Errores de Servlet: Verifica las configuraciones de web.xml y SpringSample-servlet.xml.
Compatibilidad de Versiones: Asegúrate de la compatibilidad de la versión de Java entre tu proyecto y el servidor.






Conclusión
En esta guía, hemos recorrido la construcción de una aplicación web basada en Spring MVC utilizando Spring Framework. Desde la configuración de un proyecto Maven, la configuración de dependencias necesarias, el desarrollo de componentes MVC, hasta la ejecución de la aplicación, cada paso ha sido meticulosamente detallado para asegurar una experiencia de desarrollo fluida.
Conclusiones Clave

Integración con Maven: Gestiona eficientemente las dependencias del proyecto y las configuraciones de construcción.
Configuración de Spring: La configuración adecuada de web.xml y los archivos de configuración de Spring aseguran un manejo de solicitudes sin problemas.
Componentes MVC: La clara separación de responsabilidades a través de Modelos, Vistas y Controladores mejora la mantenibilidad.
Despliegue: Comprender las configuraciones del servidor y los procedimientos de despliegue es crucial para la accesibilidad de la aplicación.

Aprendizaje Adicional
Para solidificar tu comprensión, considera explorar los siguientes temas:

Características Avanzadas de Spring MVC: Manejo de formularios, validación y manejo de excepciones.
Integración con Spring Boot: Optimizar aplicaciones Spring con auto-configuración.
Desarrollo de API RESTful: Construir APIs usando Spring MVC para aplicaciones web modernas.
Pruebas con JUnit: Incorporar frameworks de pruebas para asegurar la fiabilidad del código.

Palabras Clave SEO: Spring MVC tutorial, Spring Framework guide, Maven Spring project, Spring MVC controller setup, Spring web application, Spring configuration steps, Java Spring MVC, Spring MVC beginner, build Spring MVC application, Spring MVC deployment.

Este artículo ha sido generado por IA.
Pros	Contras
Conjunto de características completas	Curva de aprendizaje más pronunciada en comparación con Spring Boot
Flexibilidad y control sobre la configuración	Más código repetitivo
Amplia comunidad y documentación	Gestión manual de dependencias
Adecuado para aplicaciones empresariales a gran escala	Proceso de configuración más lento