La configuración inicial de Spring MVC puede presentar desafíos, especialmente para quienes se inician en el framework. Una configuración incorrecta de los archivos principales, como el descriptor de despliegue web.xml y el archivo de contexto de Spring MVC, puede llevar a problemas de resolución de solicitudes, manejo de recursos estáticos o visualización de plantillas. A continuación, se detallan aspectos cruciales de la configuración y cómo abordar algunas de estas situaciones comunes.

Configuración del Contexto de Spring MVC

El archivo de configuración de Spring MVC (comúnmente llamado ApplicationContext-mvc.xml o similar) es fundamental para definir los componentes de la capa web de la aplicación. Aquí se establecen los paquetes a escanear, cómo se manejan los recursos estáticos y la forma en que se resuelven las vistas.

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.0.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">

    <!-- Habilita la detección automática de componentes Spring con anotaciones
         (@Controller, @Service, etc.) dentro del paquete especificado. -->
    <context:component-scan base-package="org.ejemplo.aplicacion.controladores"/>

    <!-- Configura el manejo de recursos estáticos (CSS, JS, imágenes).
         Las solicitudes que coincidan con /recursos/** serán servidas desde
         el directorio /static/ dentro de la raíz de la aplicación web. -->
    <mvc:resources mapping="/recursos/**" location="/static/"/>

    <!-- Habilita las características basadas en anotaciones de Spring MVC,
         como @RequestMapping, @RequestBody, @ResponseBody. Es esencial para
         que los controladores y sus métodos funcionen correctamente,
         especialmente al usar <mvc:resources>. -->
    <mvc:annotation-driven/>

    <!-- Define un solucionador de vistas para archivos JSP.
         Busca vistas en el directorio /WEB-INF/vistas/ y añade la extensión .jsp. -->
    <bean id="vistaJspResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/vistas/"/>
        <property name="suffix" value=".jsp"/>
        <property name="order" value="1"/> <!-- Define el orden de este resolvedor -->
    </bean>

</beans>

Consideraciones Importantes:

• <context:component-scan>: Asegúrese de que el atributo base-package apunte al paquete raíz donde se encuentran sus controladores.
• <mvc:resources>: Permite que el DispatcherServlet ignore ciertas solicitudes y las sirva directamente como recursos estáticos. Si no se configura, Spring MVC intentará procesar estas URLs como controladores.
• <mvc:annotation-driven/>: Este elemento es crucial. Habilita una serie de configuraciones predeterminadas para Spring MVC, incluyendo RequestMappingHandlerMapping, RequestMappingHandlerAdapter y ExceptionHandlerExceptionResolver, que son necesarios para que las anotaciones como @Controller y @RequestMapping funcionen. Si omite esto y configura <mvc:resources>, podría experimentar problemas donde las solicitudes a sus controladores no son procesadas.
• InternalResourceViewResolver: Para las aplicaciones que utilizan JSP, este resolver de vistas es estándar. Colocar los archivos JSP dentro de /WEB-INF/ es una práctica recomendada de seguridad, ya que evita el acceso directo a ellos por parte del cliente y fuerza que sean resueltos únicamente a través del DispatcherServlet.

Configuración del Descriptor de Despliegue (web.xml)

El archivo web.xml configura el DispatcherServlet, que es el controlador frontal de Spring MVC, y define cómo se enrutan las solicitudes HTTP a su aplicación.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         version="2.5">

  <display-name>AplicacionWebSpring</display-name>

  <!-- Parámetro de contexto para identificar la aplicación -->
  <context-param>
      <param-name>nombreAplicacion</param-name>
      <param-value>org.ejemplo.proyecto.base</param-value>
  </context-param>

  <!-- Filtro para asegurar la codificación de caracteres UTF-8 en todas las solicitudes y respuestas -->
  <filter>
      <filter-name>FiltroCodificacionCaracteres</filter-name>
      <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
      <init-param>
          <param-name>encoding</param-name>
          <param-value>UTF-8</param-value>
      </init-param>
      <init-param>
          <param-name>forceEncoding</param-name>
          <param-value>true</param-value>
      </init-param>
  </filter>
  <filter-mapping>
      <filter-name>FiltroCodificacionCaracteres</filter-name>
      <url-pattern>/*</url-pattern>
  </filter-mapping>

  <!-- Declaración del DispatcherServlet de Spring MVC -->
  <servlet>
      <servlet-name>servletPrincipal</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <!-- Ubicación del archivo de configuración de Spring MVC para este servlet -->
      <init-param>
          <param-name>contextConfigLocation</param-name>
          <param-value>classpath:config/spring-servlet-web.xml</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
  </servlet>

  <!-- Mapeo de URL para el DispatcherServlet.
       Aquí, todas las solicitudes que terminen en ".app" serán manejadas por Spring MVC. -->
  <servlet-mapping>
      <servlet-name>servletPrincipal</servlet-name>
      <url-pattern>*.app</url-pattern>
  </servlet-mapping>

</web-app>

Aspectos Clave del web.xml:

• CharacterEncodingFilter: Es crucial para evitar problemas de codificación de caracteres (por ejemplo, con tildes o caracteres especiales) en las solicitudes y respuestas. Asegúrese de que esté mapeado a /* para aplicar a todas las rutas.
• DispatcherServlet: Este servlet es el corazón de Spring MVC.
  • servlet-name: Un nombre único para su servlet.
  • servlet-class: La clase del DispatcherServlet.
  • contextConfigLocation: Especifica la ubicación de su archivo de configuración de Spring MVC. Aquí, se asume que spring-servlet-web.xml está en el directorio config dentro del classpath.
  • load-on-startup: El valor 1 asegura que el servlet se inicialice cuando se inicia la aplicación web, lo que es una buena práctica para DispatcherServlet.
• servlet-mapping: Define qué patrones de URL serán interceptados por su DispatcherServlet. El patrón *.app es un enfoque común para distinguir las solicitudes de la aplicación Spring MVC de otros recursos.

Estructura de Proyecto y Ubicación de Vistas

Al desarrollar con Spring MVC, especialmente en proyectos Maven de tipo WAR, la estructura del proyecto es importante. Se recomienda la siguiente organización:

src/main/webapp/
├── WEB-INF/
│   ├── web.xml              <-- Descriptor de despliegue
│   ├── config/              <-- Carpeta para la configuración de Spring
│   │   └── spring-servlet-web.xml
│   └── vistas/              <-- Directorio para los archivos JSP (vistas)
│       ├── paginaInicial.jsp
│       └── otraVista.jsp
├── static/                  <-- Recursos estáticos (CSS, JS, imágenes)
│   ├── css/
│   ├── js/
│   └── img/
├── index.jsp                <-- Opcional, si necesita un index.jsp en la raíz

La práctica de colocar los archivos JSP dentro del directorio /WEB-INF/vistas/ es fundamental. Esto impide que los usuarios accedan directamente a los archivos JSP a través de la URL de su navegador, mejorando la seguridad y garantizando que todas las solicitudes pasen por sus controladores de Spring MVC y el InternalResourceViewResolver para su procesamiento adecuado.