Se você já possui uma aplicação Spring Boot configurada no VS Code e quer implementar páginas HTML estáticas de maneira profissional, este guia detalha desde a estrutura de arquivos até técnicas avançadas de otimização.
Estrutura de Pastas (Onde Colocar Seus Arquivos)
Em seu projeto, localize a pasta src/main/resources
- Todo conteúdo estático vai dentro da pasta static
- index.html é automaticamente mapeado para a raiz /
- Você pode criar subpastas organizam tipos de arquivos, como pastas css e js.
Controladores.
Em aplicações Spring Boot, um controlador (Controller) é um componente que atua como intermediário entre as requisições HTTP (do cliente) e a lógica da aplicação. Suas principais funções são:
- Roteamento de Requisições
Mapeia URLs para métodos específicos. - Processamento de Dados
Recebe parâmetros via URL, corpo da requisição, headers ou formulários. - Respostas Estruturadas
Decide como responder ao cliente: JSON, HTML, redirecionamentos, etc.
Para criarmos um controlador;
- Edite o arquivo index.html que está salvo dentro da pasta static, utilize o seguinte código;
<!DOCTYPE html>
<html>
<head>
<title>Integração Spring</title>
<script>
async function fetchData() {
const response = await fetch('/api/data?nome=Blogson');
const data = await response.text();
document.getElementById('resultado').innerText = data;
}
</script>
</head>
<body>
<h1>Teste de Integração</h1>
<button onclick="fetchData()">Buscar Dados</button>
<p id="resultado"></p>
</body>
</html> - Na classe principal, adicione o seguinte código.
@GetMapping("/api/data")
public String getData(@RequestParam String nome)
{
return ("Olá " + nome + "! Dados recebidos com sucesso!");
} - Execute a aplicação e veja o resultado.
Organizando os Controladores na pasta Controller
Entretando, não é uma boa prática programar seus controladores diretamente na classe principal. Para melhor organizar o seu projeto, é importante separar. Para isso, o próprio spring initilizr já cria uma pasta destinada as classes Java que irão operar como controladores.
- Localize a pasta java\com\NomeDoSeuApp\controller. Por padrão, o VS Code esconde esta pasta na primeira vista, mas basta navegar pela estrutura de pastas que você a encontrará.
- Crie o arquivo controllerData.java
- Recorte o código que estava na classe principal e cole-o no novo arquivo, se atentando para a estrutura correta do arquivo e as linhas destacadas em negrito abaixo;
package com.olaetec.etec.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class controllerData {
@GetMapping("/api/data")
public String getData(@RequestParam String nome)
{return ("Olá " + nome + "! Dados recebidos com sucesso!");}
} - Execute novamente a aplicação e notará que o resultado será exatamente o mesmo.
