Pular para conteúdo

Aula 05 - Implementação de APIs (Controllers e Rotas) ⚙️

Objetivo

Objetivo: Entender a camada de entrada de uma aplicação backend, aprender a mapear rotas para funções específicas e capturar parâmetros de entrada enviados pelo cliente.

1. A Camada de Controller 🎮

O Controller é o "maestro" de uma rota. Sua única responsabilidade é: 1. Receber a requisição HTTP. 2. Validar se os dados básicos estão ali. 3. Chamar a lógica de negócio (que veremos na próxima aula). 4. Retornar a resposta correta (Status Code + JSON).

Analogie: O Controller é o garçom de um restaurante. Ele anota o pedido, leva para a cozinha e traz o prato pronto. Ele não cozinha!

2. Anatomia de uma Rota 📍

Uma rota no backend é composta por: * Endpoint (Path): O caminho (ex: /produtos). * Verbo: A ação (ex: POST). * Handler: A função que será executada quando a rota for chamada.

Exemplo (Conceitual):

// Quando receber um GET em /usuarios, execute a função listarUuarios
router.get('/usuarios', (req, res) => {
    const lista = [{ id: 1, nome: 'Ricardo' }];
    return res.status(200).json(lista);
});

3. Capturando Dados do Cliente 📥

Existem três formas principais de o cliente enviar dados:

Tipo Onde fica? Exemplo Uso Comum
Path Params Na URL (como parte do caminho) /usuarios/123 Identificar um recurso específico.
Query Params Na URL (após o ?) /produtos?categoria=games Filtros, ordenação e paginação.
Request Body No "corpo" da mensagem { "nome": "Novo Item" } Criação ou atualização (POST/PUT).

4. O Objeto de Resposta (Response) 📤

Não basta retornar os dados, precisamos seguir o contrato REST. O Controller deve garantir: * Status Code Errado: Jamais retorne 200 OK se ocorreu um erro. * Corpo Padronizado: Envie as mensagens de erro dentro de um JSON para facilitar o trabalho do frontend.

5. Injeção de Dependência (Introdutório) 💉

Para que o Controller não tenha que "criar" outras classes, ele as recebe prontas. Isso facilita testes e troca de tecnologias.

6. Mini-Projeto: Dashboard de Usuários 👥

  1. Crie uma rota GET /usuarios.
  2. Crie uma rota POST /usuarios.
  3. Crie uma rota DELETE /usuarios/:id.
  4. Use o Postman para testar se os dados estão sendo recebidos e enviados corretamente.

7. Mini-Projeto: Criando seu primeiro Controller ⌨️

Imagine que você está criando o Controller de um Carrinho de Compras.

  1. Defina a rota para adicionar um item (POST).
  2. Como você capturaria o id do produto vindo no Body?
  3. Crie a rota para remover um item específico (DELETE via Path Param).
  4. Qual o Status Code ideal se o usuário tentar remover um item que não está no carrinho?

7. Exercício de Fixação 🧠

  1. Por que o Controller não deve conter regras de negócio (ex: cálculo de desconto)?
  2. Qual a diferença prática entre usar um Query Param e um Path Param?
  3. O que acontece se um Controller tentar acessar req.body mas o cliente não enviou o header Content-Type: application/json?

Próxima Aula: Vamos tirar a lógica do Controller e levar para o lugar certo: Services e Regras de Negócio 🧠