Configuração Estrutural do Projeto

O processo de configuração de um projeto Spring Boot baseado em Maven segue um padrão simplificado. A estrutura depende da herança de um módulo pai responsável por gerenciar versões e de um iniciador web para habilitar o suporte HTTP.

Definição do pom.xml

O descritor de projeto deve estender o artefato spring-boot-starter-parent para receber a gestão automática de dependências. Em seguida, a inclusão do iniciador web integra o Apache Tomcat e o Spring MVC ao ambiente.

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- Herança do gerenciador de dependências do Spring Boot -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.5</version>
        <relativePath/>
    </parent>

    <groupId>br.com.devbase</groupId>
    <artifactId>app-web-inicial</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- Módulo para desenvolvimento de APIs REST e servidor embutido -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

Classe de Inicialização do Framework

A execução da aplicação requer uma classe marcada com @SpringBootApplication. Esta anotação agrega funcionalidades de autoconfiguração, detecção de componentes e definição de pacotes base. O método estático run() da classe SpringApplication inicializa o contexto e o servidor web embutido.

package br.com.devbase.core;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class InicializadorSistema {

    public static void main(String[] argumentos) {
        // Dispara a inicialização do contexto Spring e do container web
        SpringApplication.run(InicializadorSistema.class, argumentos);
    }
}

Implementação de Endpoint REST

Para expor uma resposta HTTP, crie uma classe controladora no mesmo pacote ou em subpacotes do inicializador. O uso combinaod de @RestController substitui a necessidade de anotar métodos com @ResponseBody, serializando automaticamente o retorno para o cliente.

package br.com.devbase.core.controladores;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ControladorSaude {

    @GetMapping("/api/verificar")
    public String obterStatusServico() {
        return "Framework Spring Boot inicializado com sucesso.";
    }
}

Validação da Execução

Ao executar o método main do inicializador, o framework carrega o contexto da aplicação e inicia o servidor Tomcat. A saída padrão do console exibe o ciclo de inicialização, culminando na mensagem que confirma a disponibilidade do serviço:

2024-05-12 10:15:33.412  INFO 8921 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2024-05-12 10:15:33.418  INFO 8921 --- [           main] br.com.devbase.core.InicializadorSistema : Started InicializadorSistema in 1.842 seconds

O log confirma que o container escuta na porta padrão 8080 e que o contexto raiz está vazio. O endpoint torna-se acessível via http://localhost:8080/api/verificar.

Recarga Dinâmica (Hot Deploy)

Para evitar reinicializações manuais a cada alteração em classes ou recursos estáticos, utilize a dependência spring-boot-devtools. Ela monitora o classpath e reinicia o contexto automaticamente quando arquivos modificados são detectados.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

No ambiente IntelliJ IDEA, a recarga automática pode falhar se a compilação incremental estiver desativada. É necessário habilitar a opção Build project automatically e, subsequentemente, acessar o menu Help → Find Action (ou Shift+Ctrl+Alt+/), digitar Registry e ativar a chave compiler.automake.allow.when.app.running.

Geração Automatizada via Spring Initializr

As IDEs modernas integram o Spring Initializr, permitindo a criação de projetos com dependências pré-configuradas. O assistente gera automaticamente o descritor Maven, a classe principal e o plugin de empacotamento.

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.5</version>
        <relativePath/>
    </parent>

    <groupId>br.com.devbase</groupId>
    <artifactId>projeto-assistido</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>projeto-assistido</name>
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- Dependência de teste gerada automaticamente -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <!-- Exclusão de bibliotecas conflitantes, se necessário -->
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

A estrutura gerada inclui a classe principal pronta para execução. Caso ocorra erro de compilação referente a pacotes do JUnit (ex: programa org.junit.jupiter.api não existe), verifique se o escopo test foi mantido corretamente e execute o comando mvn clean install para garantir o download dos artefatos de teste. Após a resolução, crie um controlador adicional e acesse a rota correspondente via navegador para validar a operação do ciclo assistido.