Construindo uma aplicação Spring MVC usando Spring Framework: Um guia passo a passo

Índice

1. Introdução - Página 1
2. Configurando o Projeto Maven - Página 2
   • Criando uma Nova Aplicação Web Maven
   • Configurando pom.xml
3. Configurando Spring Framework - Página 5
   • Atualizando a Versão do Java
   • Configurando web.xml
   • Criando Configuração Spring
4. Desenvolvendo os Componentes MVC - Página 9
   • Criando o Controller
   • Desenhando a View
5. Executando a Aplicação - Página 13
6. Conclusão - Página 15

Introdução

Bem-vindo a este guia abrangente sobre como construir uma aplicação baseada em Spring MVC usando o Spring Framework. Embora o Spring Boot tenha se tornado cada vez mais popular na indústria por sua facilidade de configuração e inicialização, entender o Spring Framework subjacente proporciona uma base sólida para configurações e personalizações avançadas.

Importância e Propósito

Este guia tem como objetivo equipar iniciantes e desenvolvedores com conhecimentos básicos para criar uma robusta aplicação web MVC (Model-View-Controller) usando o Spring Framework. Ao final deste guia, você entenderá como configurar um projeto Maven, configurar dependências Spring, desenvolver componentes MVC e executar sua aplicação com sucesso.

Prós e Contras de Usar Spring Framework

Quando e Onde Usar Spring Framework

Opte pelo Spring Framework quando você precisar de um controle detalhado sobre a configuração da sua aplicação, especialmente em ambientes empresariais de grande escala onde a personalização é fundamental.

Configurando o Projeto Maven

Criando uma Nova Aplicação Web Maven

Para começar, inicie uma nova aplicação web baseada em Maven. O Maven simplifica o gerenciamento de projetos ao lidar com dependências e configurações de build.

1. Iniciar um Novo Projeto Maven:
   • Abra seu IDE e crie um novo projeto Maven.
   • Selecione o arquétipo apache.maven.
   • Escolha criar uma Aplicação Web já que estamos desenvolvendo uma aplicação web baseada em MVC.
2. Convenições de Nomenclatura do Projeto:
   • Group ID: org.studyeasy
   • Artifact ID: S05L01-SpringMinimalSetup

   Esta convenção de nomenclatura ajuda na organização e no gerenciamento eficiente do seu projeto.

3. Finalizar Configuração do Projeto:
   • Clique em Finish para gerar a estrutura do projeto.
   • O Maven irá buildar o projeto com base nas configurações especificadas.

Configurando pom.xml

O arquivo pom.xml é crucial pois gerencia as dependências do projeto e as configurações de build.

1. Navegar até pom.xml:
   • Localize o arquivo pom.xml no diretório do seu projeto.
2. Adicionar Dependências Necessárias:

   Certifique-se de que as seguintes dependências estão incluídas para Spring MVC:

   Java

   <dependencies> <!-- Spring Core --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.3.20</version> </dependency> <!-- Spring Context --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.3.20</version> </dependency> <!-- Spring Web MVC --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.20</version> </dependency> <!-- Jakarta Servlet --> <dependency> <groupId>jakarta.servlet</groupId> <artifactId>jakarta.servlet-api</artifactId> <version>5.0.0</version> <scope>provided</scope> </dependency> <!-- Suporte a JSP --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <!-- JUnit para Testes (Opcional) --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> </dependencies>

   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

   <dependencies>     <!-- Spring Core -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-core</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Spring Context -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-context</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Spring Web MVC -->     <dependency>         <groupId>org.springframework</groupId>         <artifactId>spring-webmvc</artifactId>         <version>5.3.20</version>     </dependency>          <!-- Jakarta Servlet -->     <dependency>         <groupId>jakarta.servlet</groupId>         <artifactId>jakarta.servlet-api</artifactId>         <version>5.0.0</version>         <scope>provided</scope>     </dependency>          <!-- Suporte a JSP -->     <dependency>         <groupId>javax.servlet</groupId>         <artifactId>jstl</artifactId>         <version>1.2</version>     </dependency>          <!-- JUnit para Testes (Opcional) -->     <dependency>         <groupId>junit</groupId>         <artifactId>junit</artifactId>         <version>4.13.2</version>         <scope>test</scope>     </dependency> </dependencies>

3. Atualizar Projeto Maven:
   • Clique com o botão direito no projeto e selecione Maven > Update Project.
   • Marque Force Update of Snapshots/Releases e clique em OK.
   • O Maven irá baixar e integrar as dependências especificadas.

Configurando Spring Framework

Atualizando a Versão do Java

Certifique-se de que seu projeto utiliza uma versão apropriada do Java para compatibilidade e desempenho.

1. Definir Versão do Java para 17:

   Abra pom.xml e atualize a versão do Java:

   Java

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

   1 2 3 4 5 6

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

2. Recarregar Projeto Maven:

   Após a atualização, recarregue o projeto Maven para aplicar as alterações.

Configurando web.xml

O arquivo web.xml configura as definições de deployment para sua aplicação web.

1. Localizar web.xml:
   • Navegue até src/main/webapp/WEB-INF/web.xml.
2. Configuração Básica:
   
   Java

   <?xml version="1.0" encoding="UTF-8"?> <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"> <display-name>SpringMinimalSetup</display-name> <!-- Configuração do Dispatcher Servlet --> <servlet> <servlet-name>SpringSample</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/SpringSample-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>SpringSample</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>

   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

   <?xml version="1.0" encoding="UTF-8"?> <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">          <display-name>SpringMinimalSetup</display-name>          <!-- Configuração do Dispatcher Servlet -->     <servlet>         <servlet-name>SpringSample</servlet-name>         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>         <init-param>             <param-name>contextConfigLocation</param-name>             <param-value>/WEB-INF/SpringSample-servlet.xml</param-value>         </init-param>         <load-on-startup>1</load-on-startup>     </servlet>          <servlet-mapping>         <servlet-name>SpringSample</servlet-name>         <url-pattern>/</url-pattern>     </servlet-mapping>      </web-app>

3. Explicação:
   • DispatcherServlet: Componente central que lida com as requisições recebidas.
   • contextConfigLocation: Especifica o arquivo de configuração Spring.
   • Servlet Mapping: Direciona todas as requisições (/) para o DispatcherServlet.

Criando Configuração Spring

Defina configurações específicas do Spring para gerenciar beans e configurações MVC.

1. Criar SpringSample-servlet.xml:
   • Navegue até src/main/webapp/WEB-INF/ e crie SpringSample-servlet.xml.
2. Adicionar Detalhes da Configuração:
   
   Java

   <?xml version="1.0" encoding="UTF-8"?> <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"> <!-- Scaneamento de Componentes --> <context:component-scan base-package="org.studyeasy"/> <!-- View Resolver --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean> </beans>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   <?xml version="1.0" encoding="UTF-8"?> <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">          <!-- Scaneamento de Componentes -->     <context:component-scan base-package="org.studyeasy"/>          <!-- View Resolver -->     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">         <property name="prefix" value="/WEB-INF/views/"/>         <property name="suffix" value=".jsp"/>     </bean>      </beans>

3. Explicação:
   • Scaneamento de Componentes: Permite que o Spring detecte e gerencie beans dentro do pacote especificado.
   • View Resolver: Configura o caminho e a extensão de arquivo para os templates de view (JSP).

Desenvolvendo os Componentes MVC

Criando o Controller

O controller gerencia as requisições recebidas, processa-as e retorna as views apropriadas.

1. Criar MainController.java:
   • Navegue até src/main/java/org/studyeasy/ e crie MainController.java.
2. Código do Controller com Comentários:
   
   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() { // Retorna o nome da view a ser renderizada 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() {         // Retorna o nome da view a ser renderizada         return "home";     } }

3. Explicação:
   • @Controller: Indica que esta classe atua como um controller Spring MVC.
   • @RequestMapping: Mapeia requisições HTTP para métodos manipuladores.
   • método home: Lida com requisições GET para a URL raiz (/) e retorna a view home.

Desenhando a View

A view define a interface do usuário apresentada ao usuário.

1. Criar home.jsp:
   • Navegue até src/main/webapp/WEB-INF/views/ e crie home.jsp.
2. Código da View:
   
   Java

   <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Página Inicial</title> </head> <body> <h3>Bem-vindo ao Mundo do Spring MVC</h3> </body> </html>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14

   <%@ page language="java" contentType="text/html; charset=UTF-8"     pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head>     <meta charset="UTF-8">     <title>Página Inicial</title> </head> <body>     <h3>Bem-vindo ao Mundo do Spring MVC</h3> </body> </html>

3. Explicação:
   • Estrutura HTML: HTML básico para exibir uma mensagem de boas-vindas.
   • Arquivo JSP: Serve como a view renderizada pelo controller.

Executando a Aplicação

Após configurar todas as configurações e desenvolver os componentes MVC, é hora de executar e testar a aplicação.

1. Build do Projeto:
   • Clique com o botão direito no projeto e selecione Run As > Maven build...
   • Digite package no campo Goals e clique em Run.
2. Deploy no Servidor:
   • Certifique-se de que você tem o Apache Tomcat configurado como seu servidor.
   • Clique com o botão direito no projeto e selecione Run As > Run on Server.
   • Escolha o Apache Tomcat (preferencialmente a versão 9) e prossiga.
3. Acessar a Aplicação:
   • Abra um navegador web e navegue até http://localhost:8080/S05L01-SpringMinimalSetup/.
   • Você deverá ver a Página Inicial com a mensagem "Welcome to the World of Spring MVC".
4. Solução de Problemas:
   • Problemas Comuns:
     • Erros de Dependência: Certifique-se de que todas as dependências Maven estão corretamente especificadas e baixadas.
     • Erros de Servlet: Verifique as configurações dos arquivos web.xml e SpringSample-servlet.xml.
     • Compatibilidade de Versão: Garanta a compatibilidade da versão do Java entre seu projeto e o servidor.

Conclusão

Neste guia, caminhamos através da construção de uma aplicação web baseada em Spring MVC usando o Spring Framework. Desde a configuração de um projeto Maven, configuração das dependências necessárias, desenvolvimento de componentes MVC, até a execução da aplicação, cada passo foi detalhadamente descrito para garantir uma experiência de desenvolvimento tranquila.

Principais Aprendizados

• Integração com Maven: Gerencia eficientemente as dependências do projeto e as configurações de build.
• Configuração do Spring: Configuração adequada dos arquivos web.xml e de configuração do Spring garante o manuseio fluido das requisições.
• Componentes MVC: Separação clara de responsabilidades através de Models, Views e Controllers melhora a manutenção.
• Deploy: Entender as configurações do servidor e os procedimentos de deployment é crucial para a acessibilidade da aplicação.

Aprendizado Adicional

Para solidificar seu entendimento, considere explorar os seguintes tópicos:

• Recursos Avançados do Spring MVC: Manipulação de formulários, validação e tratamento de exceções.
• Integração com Spring Boot: Simplificando aplicações Spring com auto-configuração.
• Desenvolvimento de APIs RESTful: Construindo APIs usando Spring MVC para aplicações web modernas.
• Testes com JUnit: Incorporando frameworks de testes para garantir a confiabilidade do código.

SEO Keywords: 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 artigo foi gerado por IA.