✨feat(catalogo): aprimora a API REST com Padrão Front Controller | Pa…

…rte 29

- Inicializa o Banco de Dados
- Implementa uma Classe Abstrata para Um "Controller Express"
- Implementa o "Front Controller" para o Caso de Uso "Recuperar Categoria por ID"
- Associa Rotas da API para Manipular Rotas da Categoria
- Cria arquivos e casos de teste manuais para requisições nas rotas com a extensão REST Client
- Implementa "Front Controller" para o Caso de Uso "Recuperar Todas as Categoria"

src/main/index.ts

@@ -1,5 +1,6 @@
 import dotenv from 'dotenv';
 import { createHTTPServer } from './presentation/http/server';
+import { prisma } from '@main/infra/database/orm/prisma/client';
 
 async function bootstrap() {
 
@@ -18,6 +19,12 @@ async function bootstrap() {
         console.log(`[${api_name}] ✅ Servidor HTTP pronto e ouvindo em http://${host_name}:${port}`);
     });
 
+    prisma.$connect().then(
+        async () => {
+            console.log(`[${api_name}] ✅ Banco de dados conectado`);
+        }
+    );
+
 }
 
 bootstrap()

src/main/presentation/http/rest/api.v1.ts

@@ -1,12 +1,11 @@
+import { categoriaRouter } from '@modules/catalogo/presentation/http/rest/categoria.routes';
 import express, { Router } from 'express';
 
 const apiv1Router: Router = express.Router();
 
 apiv1Router.use(
     '/categorias',
-    function (request, response, next) {
-        response.json({"entidade":"Categoria"});
-    } 
+    categoriaRouter
 );
 
 apiv1Router.use(

src/modules/catalogo/presentation/http/rest/categoria.http

@@ -0,0 +1,10 @@
+@host = localhost
+@port = 3000
+@apiversion = api/v1
+
+### Recuperar Um Categoria por ID
+GET http://{{host}}:{{port}}/{{apiversion}}/categorias/5e66e5b0-4ecc-4cc0-882d-ea3ea53cc238
+
+### Recuperar Todas as Categorias
+GET http://{{host}}:{{port}}/{{apiversion}}/categorias
+

src/modules/catalogo/presentation/http/rest/categoria.routes.ts

@@ -0,0 +1,16 @@
+import express from 'express';
+import { recuperarCategoriaPorIdController, recuperarTodasCategoriasController } from './controllers';
+
+const categoriaRouter = express.Router();
+
+categoriaRouter.get(
+    '/:id',
+    (request, response, next) =>  recuperarCategoriaPorIdController.recuperar(request, response, next)
+)
+
+categoriaRouter.get(
+    '/',
+    (request, response, next) =>  recuperarTodasCategoriasController.recuperar(request, response, next)
+)
+
+export { categoriaRouter };

src/modules/catalogo/presentation/http/rest/controllers/index.ts

@@ -0,0 +1,11 @@
+import { recuperarCategoriaPorIdUseCase, recuperarTodasCategoriasUseCase } from "@modules/catalogo/application/use-cases";
+import { RecuperarCategoriaPorIdExpressController } from "./recuperar-categoria-por-id.express.controller";
+import { RecuperarTodasCategoriaExpressController } from "./recuperar-todas-categorias.express.controller";
+
+const recuperarCategoriaPorIdController = new RecuperarCategoriaPorIdExpressController(recuperarCategoriaPorIdUseCase);
+const recuperarTodasCategoriasController = new RecuperarTodasCategoriaExpressController(recuperarTodasCategoriasUseCase);
+
+export {
+    recuperarCategoriaPorIdController,
+    recuperarTodasCategoriasController
+}

src/modules/catalogo/presentation/http/rest/controllers/recuperar-categoria-por-id.express.controller.ts

@@ -0,0 +1,28 @@
+import { RecuperarCategoriaPorIdUseCase } from "@modules/catalogo/application/use-cases/recuperar-categoria-por-id/recuperar-categoria-por-id.use-case";
+import { ICategoria } from "@modules/catalogo/domain/categoria/categoria.types";
+import { ExpressController } from "@shared/presentation/http/express.controller";
+import { NextFunction, Request, Response } from "express";
+
+class RecuperarCategoriaPorIdExpressController extends ExpressController {
+
+    private _recuperarCategoriaPorIdUseCase: RecuperarCategoriaPorIdUseCase;
+
+    constructor(recuperarCategoriaPorIdUseCase: RecuperarCategoriaPorIdUseCase) {
+        super();
+        this._recuperarCategoriaPorIdUseCase = recuperarCategoriaPorIdUseCase;
+    }
+
+    async recuperar(request: Request, response: Response, next: NextFunction) {
+        try {
+            const uuid:string = request.params.id;
+            const categoriaOutputDTO: ICategoria = await this._recuperarCategoriaPorIdUseCase.execute(uuid);
+            this.sendSuccessResponse(response,categoriaOutputDTO);
+        }
+        catch (error) {
+            next(error);
+        }
+    }
+
+}
+
+export { RecuperarCategoriaPorIdExpressController }

src/modules/catalogo/presentation/http/rest/controllers/recuperar-todas-categorias.express.controller.ts

@@ -0,0 +1,27 @@
+import { RecuperarTodasCategoriasUseCase } from "@modules/catalogo/application/use-cases/recuperar-todas-categorias/recuperar-todas-categorias.use-case";
+import { ICategoria } from "@modules/catalogo/domain/categoria/categoria.types";
+import { ExpressController } from "@shared/presentation/http/express.controller";
+import { NextFunction, Request, Response } from "express";
+
+class RecuperarTodasCategoriaExpressController extends ExpressController {
+
+    private _recuperarTodasCategoriaUseCase: RecuperarTodasCategoriasUseCase;
+
+    constructor(recuperarTodasCategoriaUseCase: RecuperarTodasCategoriasUseCase) {
+        super();
+        this._recuperarTodasCategoriaUseCase = recuperarTodasCategoriaUseCase;
+    }
+
+    async recuperar(request: Request, response: Response, next: NextFunction) {
+        try {
+            const listaCategoriasDTO: Array<ICategoria> = await this._recuperarTodasCategoriaUseCase.execute();
+            this.sendSuccessResponse(response,listaCategoriasDTO);
+        } catch (error) {
+            next(error);
+        }
+
+    }
+
+}
+
+export { RecuperarTodasCategoriaExpressController }

src/shared/presentation/http/express.controller.ts

@@ -0,0 +1,19 @@
+import { Response } from "express";
+
+abstract class ExpressController {
+
+    protected sendSuccessResponse(response: Response, data: any, status = 200) {
+        response.status(status).json(data);
+    }
+
+    protected sendErrorResponse(response: Response, error: Error, status = 500) {
+        response.status(status).json({ error: error.message });
+    }
+
+    protected sendNotFoundResponse(response: Response, message = 'Not found') {
+        response.status(404).json({ error: message });
+    }
+
+}
+
+export { ExpressController }