https://github.com/clubedojava/desafio-tecnico-junior

Desafio técnico Java - Nível Junior
https://github.com/clubedojava/desafio-tecnico-junior

Last synced: 5 months ago
JSON representation

Desafio técnico Java - Nível Junior

• Host: GitHub
• URL: https://github.com/clubedojava/desafio-tecnico-junior
• Owner: ClubeDoJava
• Created: 2025-05-05T17:19:58.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-05T17:28:19.000Z (about 1 year ago)
• Last Synced: 2025-06-16T21:45:47.695Z (about 1 year ago)
• Size: 4.88 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Mini API de Blog

## Descrição do Problema

Projetar e implementar uma API RESTful simples para gerenciar posts de blog. 

A API deve permitir que os usuários realizem operações básicas como criar, ler, atualizar e deletar posts de blog.

## Funcionalidades Principais (Endpoints da API)

*   **POST /posts:** Criar um novo post de blog.

    *   Aceita dados JSON no corpo da requisição contendo o `título`, o `conteúdo` e o `autor` do post.

    *   Após a criação bem-sucedida, a API deve retornar o novo post de blog como um objeto JSON, incluindo um identificador exclusivo (ID) atribuído pelo sistema.

*   **GET /posts:** Recuperar uma lista de todos os posts de blog.

    *   Quando este endpoint é acessado por meio de uma requisição GET, a API deve retornar um array JSON onde cada elemento é um objeto JSON representando um post de blog.

*   **GET /posts/{id}:** Recuperar um post de blog específico por seu identificador exclusivo.

    *   O `{id}` no caminho representa um espaço reservado para o ID do post de blog desejado.

    *   A API deve retornar um objeto JSON representando o post de blog com o ID correspondente.

    *   Se nenhum post de blog com o ID fornecido existir, a API deve retornar uma resposta de erro apropriada, como um código de status HTTP 404 (Não Encontrado).

*   **PUT /posts/{id}:** Atualizar um post de blog existente identificado por seu ID.

    *   Este endpoint deve aceitar uma requisição PUT com um corpo JSON contendo o `título`, o `conteúdo` e/ou o `autor` atualizados.

    *   Após a atualização bem-sucedida, a API deve retornar o post de blog atualizado como um objeto JSON.

    *   Se um post de blog com o ID fornecido não existir, a API deve retornar um erro HTTP 404.

*   **DELETE /posts/{id}:** Deletar um post de blog específico identificado por seu ID.

    *   Este endpoint deve lidar com uma requisição DELETE.

    *   Após a exclusão bem-sucedida, a API deve retornar uma mensagem de sucesso (por exemplo, um código de status HTTP 204 No Content ou uma mensagem JSON simples).

    *   Se nenhum post de blog com o ID fornecido existir, a API deve retornar um erro HTTP 404.

## Requisitos e Restrições

*   **Stack:**

    *   **Linguagem:** Java 8 ou superior.

    *   **Framework (Opcional, mas Recomendado):** Spring Boot (com dependências mínimas) ou Spark Java.

    *   **Armazenamento de Dados:**

        *   Inicialmente, pode-se usar uma estrutura de dados na memória (como `HashMap` ou `ArrayList`).

        *   Opcionalmente, para uma implementação mais avançada, pode-se persistir os dados em um arquivo (JSON) ou em um banco de dados embutido (como H2).

    *   **Formato de Requisição/Resposta:** JSON.

*   **Estrutura e Organização do Código (Sugestão):**

    *   Classe `Post`: Modelo de dados para um post de blog (id, título, conteúdo, autor).

    *   Classe de Serviço (`PostService`): Lógica de negócios para operações CRUD em `Post`.

    *   Classe de Controller (`PostController`): Lida com os endpoints da API, recebe requisições, interage com o serviço e formata as respostas.

*   **Tratamento de Erros:**

    *   Implementar tratamento básico de erros, como retornar o código de status HTTP 404 quando um post com um ID específico não é encontrado.

    *   Utilizar códigos de status HTTP apropriados para indicar o resultado das requisições (200 OK, 201 Created, 204 No Content).

*   **Restrições:**

    *   Manter a implementação simples e focada nas funcionalidades principais.

    *   Não é necessário implementar autenticação ou autorização.

    *   Priorizar código limpo, legível e bem comentado.

## Métricas de Avaliação Potenciais

*   **Correção:** A API implementa corretamente todas as funcionalidades especificadas.

*   **Qualidade do Código:** O código é bem organizado, legível e de fácil manutenção.

*   **Tratamento de Erros:** A API lida com erros de forma adequada, retornando códigos de status HTTP apropriados.

*   **Uso dos Fundamentos de Java:** Demonstração de uma sólida compreensão dos conceitos principais de Java (POO, Collections Framework).

*   **Adesão aos Princípios RESTful:** Utilização correta dos métodos HTTP para as diferentes operações.

*   **Pontos Bônus (Opcional):**

    *   Implementação de persistência de dados.

    *   Validação básica de entrada.

    *   Implementação de testes unitários.