Arquitetura e Implementação de Aplicações com Spring MVC

O Spring MVC consolidou-se como um dos frameworks fundamentais para o desenvolvimento Java Web, operando sob o padrão de projeto Front Controller. No centro dessa arquitetura está o DispatcherServlet, que atua como o orquestrador principal, interceptando requisições HTTP e delegando-as aos manipuladores (Handlers) apropriados para processamento de lógica de negócio e retorno de visualizações (Views).

Estrutura de Dependências

Para um ambiente integrnado Spring MVC e persistência com Hibernate, as bibliotecas essenciais incluem:

  • Spring Framework: spring.jar, spring-webmvc.jar, commons-logging.jar.
  • Hibernate e Persistência: hibernate3.jar, hibernate-jpa-api, dom4j.jar, javassist.jar, slf4j-api.jar e o driver JDBC específico do banco de dados.

Configuração do Descritor de Implantação (web.xml)

O primeiro passo é declarar o DispatcherServlet no arquivo web.xml. Ele será responsável por gerenciar o ciclo de vida das requisições maepadas.

<!-- Configuração do Servlet Principal -->
<servlet>
    <servlet-name>mvc-dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>mvc-dispatcher</servlet-name>
    <url-pattern>*.htm</url-pattern>
</servlet-mapping>

<!-- Carregamento do Contexto Global do Spring -->
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
</context-param>

Definição do Contexto da Camada Web

O arquivo de configuração do servlet (ex: mvc-dispatcher-servlet.xml) define como o Spring deve localizar os controladores e resolver as páginas JSP.

<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.xsd
       http://www.springframework.org/schema/context 
       http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- Escaneamento de componentes anotados -->
    <context:component-scan base-package="br.com.projeto.controller" />

    <!-- Habilita o suporte a anotações do Spring MVC -->
    <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />

    <!-- Resolução de Views: mapeia retornos lógicos para arquivos físicos -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

Implementação de Controladores

Controladores no Spring MVC são classes anoatdas com @Controller. Elas utilizam @RequestMapping para definir as rotas de acesso.

package br.com.projeto.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;
import br.com.projeto.model.Usuario;

@Controller
public class AutenticacaoController {

    @RequestMapping("/acesso/login.htm")
    public String realizarLogin(@RequestParam("usuario") String login, String senha) {
        // Lógica de validação simples
        if ("root".equals(login) && "secret".equals(senha)) {
            return "dashboard"; // Retorna /WEB-INF/views/dashboard.jsp
        }
        return "erro-login";
    }

    @RequestMapping("/acesso/validar.htm")
    public ModelAndView validarPerfil(Usuario usuario) {
        // O Spring vincula automaticamente os campos do formulário ao objeto Usuario
        if (usuario.getIdade() < 18) {
            return new ModelAndView("restrito");
        }
        return new ModelAndView("redirect:/home.jsp");
    }
}

Mapeamento Avançado e Variáveis de Path

É possível organizar rotas de forma hierárquica e capturar valores diretamente da URL utilizando a anotação @PathVariable.

@Controller
@RequestMapping("/gestao/*")
public class PainelController {

    @RequestMapping("detalhes.htm")
    public String exibirPadrao() {
        return "view-detalhes";
    }

    @RequestMapping(value = "/perfil/{idUsuario}", method = RequestMethod.GET)
    public String buscarPerfil(@PathVariable("idUsuario") int id, Model model) {
        // 'id' é extraído diretamente da URL, ex: /gestao/perfil/50
        model.addAttribute("codigo", id);
        return "perfil-usuario";
    }
}

Além disso, o Spring MVC injeta automaticamente objetos nativos da API de Servlets, como HttpServletRequest e HttpSession, quando declarados como parâmetros nos métodos do controlador, facilitando o acesso ao estado da sessão e metadados da requisição.

Tags: Spring MVC java DispatcherServlet Web Framework Model-View-Controller

Publicado em 10-2 23:04