Configurar um Ambiente de Desenvolvimento Spring - Tutorial Passo a Passo

Introdução

Neste projeto, você aprenderá como configurar um ambiente de desenvolvimento Spring usando Maven e o Spring Framework versão 5.3.7. Este projeto irá guiá-lo através do processo de criação de um projeto Maven, configuração do contexto Spring e escrita de uma classe de teste para verificar a configuração bem-sucedida do ambiente Spring.

👀 Visualização

A estrutura de diretórios deve ser semelhante a esta:

Estrutura de Diretórios

O ambiente Spring foi configurado corretamente:

[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< org.labex:springenv >-------------------
[INFO] Building springenv 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ springenv ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ springenv ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ springenv ---
[INFO] Surefire report directory: /home/labex/project/springenv/target/surefire-reports

-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running org.labex.TestSpring
The Spring environment was built successfully!
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.662 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.270 s
[INFO] Finished at: 2023-04-10T10:00:00Z
[INFO] ------------------------------------------------------------------------

🎯 Tarefas

Neste projeto, você aprenderá:

Como configurar um projeto Maven para o ambiente Spring
Como criar o arquivo de configuração Spring applicationContext.xml
Como escrever uma classe de teste para validar a configuração do ambiente Spring

🏆 Conquistas

Após concluir este projeto, você será capaz de:

Criar um projeto Maven e gerenciar dependências usando o arquivo pom.xml
Configurar o contexto Spring usando o arquivo applicationContext.xml
Escrever uma classe de teste para garantir a configuração adequada do ambiente Spring

Configurar o Projeto Maven

Nesta etapa, você aprenderá como configurar um projeto Maven para o ambiente Spring.

Abra seu IDE ou editor de texto preferido e navegue até o diretório ~/project/.

Você verá um projeto Maven chamado springenv. A estrutura de diretórios deve ser semelhante a esta:

~/project/springenv/
├── pom.xml
└── src/
    ├── main/
    │   └── java/
    └── test/
        └── java/

Abra o arquivo pom.xml e adicione as seguintes dependências:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.labex</groupId>
    <artifactId>springenv</artifactId>
    <version>1.0-SNAPSHOT</version>

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

    <dependencies>
        <!-- Spring Framework -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.3.7</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

Este arquivo pom.xml configura as dependências necessárias para o Spring Framework versão 5.3.7 e o framework de teste JUnit.

Criar o Arquivo de Configuração Spring

Nesta etapa, você criará o arquivo de configuração Spring applicationContext.xml.

No diretório src/main/resources/, você verá um arquivo chamado applicationContext.xml.

Adicione o seguinte conteúdo ao arquivo applicationContext.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       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">
    <!-- Your bean configurations go here -->
</beans>

Este arquivo configura o elemento raiz <beans> e inclui o arquivo de regra de esquema necessário para a configuração Spring.

Criar a Classe de Teste

Nesta etapa, você criará uma classe de teste para verificar a configuração bem-sucedida do ambiente Spring.

No diretório src/test/java/, você verá uma classe Java chamada TestSpring.

Adicione o seguinte código à classe TestSpring:

import org.junit.Test;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import static org.junit.Assert.assertTrue;

public class TestSpring {

    @Test
    public void testSpringEnvironment() {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        System.out.println("The Spring environment was built successfully!");
        context.close();

        // Use the assertTrue method to ensure that the test passes.
        assertTrue(true);
    }
}

Esta classe de teste cria um ClassPathXmlApplicationContext usando o arquivo applicationContext.xml e imprime uma mensagem no console para confirmar que o ambiente Spring foi configurado com sucesso.

Executar o Teste

Nesta etapa final, você compilará e executará o teste para verificar a configuração do ambiente Spring.

Abra um terminal e navegue até o diretório ~/project/springenv/ usando o seguinte comando:
```
cd ~/project/springenv/
```

Execute o seguinte comando para compilar e executar o teste:

mvn test

Você deverá ver a seguinte saída:

[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< org.labex:springenv >-------------------
[INFO] Building springenv 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ springenv ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ springenv ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ springenv ---
[INFO] Surefire report directory: /home/labex/project/springenv/target/surefire-reports

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running org.labex.TestSpring
The Spring environment was built successfully!
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.662 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.270 s
[INFO] Finished at: 2023-04-10T10:00:00Z
[INFO] ------------------------------------------------------------------------

A saída mostra que o teste foi executado com sucesso e o ambiente Spring foi configurado corretamente.

Parabéns! Você concluiu o projeto de configuração do ambiente de desenvolvimento Spring usando a versão 5.3.7.