Crud Simples

API REST em Spring Boot para cadastro, consulta, atualizacao e remocao de itens, com persistencia em arquivo texto local no formato JSON.

Tecnologias

• Java 17
• Spring Boot 3.5.13
• Gradle
• Jackson para serializacao JSON

Pre-requisitos

• Java 17 ou superior
• Gradle compativel com Spring Boot 3.5.x

Como executar

No diretorio do projeto:

gradle bootRun

Se houver Gradle Wrapper no futuro:

./gradlew bootRun

A aplicacao sobe em:

http://localhost:8080

Persistencia local

Os dados sao gravados em arquivo local configurado em application.properties:

app.storage.file=data/itens.json

O arquivo e criado automaticamente se nao existir.

Endpoints

POST /itens

Cria um novo item.

Exemplo de requisicao:

{
  "nome": "Item A",
  "descricao": "Primeiro item"
}

GET /itens

Lista todos os itens cadastrados.

GET /itens/{id}

Busca um item pelo identificador.

PUT /itens/{id}

Atualiza os dados de um item existente.

Exemplo de requisicao:

{
  "nome": "Item Atualizado",
  "descricao": "Descricao atualizada"
}

DELETE /itens/{id}

Remove um item existente.

Modelo de resposta

Exemplo de item retornado pela API:

{
  "id": 1,
  "nome": "Item A",
  "descricao": "Primeiro item",
  "dataCriacao": "2026-04-02T23:39:13.962"
}

Validacoes

• nome e obrigatorio;
• descricao e obrigatoria;
• nome aceita no maximo 100 caracteres;
• descricao aceita no maximo 255 caracteres.

Respostas esperadas

• 201 Created ao criar item;
• 200 OK ao consultar ou atualizar;
• 204 No Content ao remover;
• 400 Bad Request para payload invalido;
• 404 Not Found para item inexistente.

Como testar

gradle test

Estrutura principal

src/main/java/com/example/helloworld/
  controller/
  dto/
  exception/
  model/
  repository/
  service/
src/main/resources/
especificacoes/
data/