40. Post, Patch y Delete

 

Implementando un CRUD Básico en NestJS: Guía Paso a Paso

En esta entrada, veremos cómo implementar los endpoints básicos de un CRUD (Create, Read, Update, Delete) en NestJS, utilizando un controlador de Cars como ejemplo.

1. Estructura Inicial del Controlador

Empecemos con un controlador básico que ya tiene el método GET para leer datos:

typescript
Copy
Download
import { Controller, Get, Post, Patch, Delete, Body, Param, ParseIntPipe } from '@nestjs/common';

@Controller('cars')
export class CarsController {

  @Get()
  getAllCars() {
    return ['Toyota', 'Honda', 'Volvo'];
  }

  @Get(':id')
  getCarById(@Param('id', ParseIntPipe) id: number) {
    return `Carro con ID ${id}`;
  }
}

2. Crear un Nuevo Recurso (POST)

Para crear un nuevo carro, usamos el decorador @Post(). Aquí recibimos los datos del cuerpo de la solicitud con @Body():

typescript
Copy
Download
@Post()
createCar(@Body() body: any) {
  return {
    ok: true,
    method: 'POST',
    body
  };
}

Ejemplo en Postman:

  • URL: POST /cars

  • Body:

    json
    Copy
    Download
    { "brand": "Volvo", "model": "XC60" }

  • Respuesta:

    json
    Copy
    Download
    { "ok": true, "method": "POST", "body": { "brand": "Volvo", "model": "XC60" } }

3. Actualizar un Recurso (PATCH)

Para actualizar, usamos @Patch() y combinamos @Param() (para el ID) con @Body() (para los nuevos datos):

typescript
Copy
Download
@Patch(':id')
updateCar(
  @Param('id', ParseIntPipe) id: number,
  @Body() body: any
) {
  return {
    method: 'PATCH',
    id,
    body
  };
}

Ejemplo en Postman:

  • URL: PATCH /cars/1

  • Body:

    json
    Copy
    Download
    { "model": "XC90" }

  • Respuesta:

    json
    Copy
    Download
    { "method": "PATCH", "id": 1, "body": { "model": "XC90" } }

4. Eliminar un Recurso (DELETE)

Para eliminar, usamos @Delete() y el ID del recurso:

typescript
Copy
Download
@Delete(':id')
deleteCar(@Param('id', ParseIntPipe) id: number) {
  return {
    method: 'DELETE',
    id
  };
}

Ejemplo en Postman:

  • URL: DELETE /cars/1

  • Respuesta:

    json
    Copy
    Download
    { "method": "DELETE", "id": 1 }

5. Validaciones y Próximos Pasos

Actualmente, nuestro CRUD no valida los datos recibidos (como campos obligatorios o tipos de datos). En futuras entradas, cubriremos:

  • DTOs (Data Transfer Objects): Para definir la estructura esperada del cuerpo de la solicitud.

  • Pipes de Validación: Como class-validator para asegurar que los datos sean correctos.

  • Servicios: Donde implementaremos la lógica de negocio (crear, actualizar, etc.).

Conclusión

Con estos decoradores (@Post, @Patch, @Delete), ya tienes la base para un CRUD funcional en NestJS. En la próxima entrada, profundizaremos en cómo validar datos y estructurar mejor el código.

¿Te gustaría ver algún tema en particular? ¡Déjalo en los comentarios!

Código completo: Enlace al repositorio (opcional).

Keywords: NestJS, CRUD, API REST, Backend, TypeScript.

Este post es claro, práctico y sigue un flujo lógico. Si quieres, puedo ajustar el tono o agregar más detalles técnicos. ¡Espero que te sea útil! 🚀

Comentarios

Publicar un comentario

Entradas más populares de este blog

48. ValidationPipe - Class Validator y Class Transformer

  Validación de Datos en NestJS con ValidationPipe, Class-Validator y Class-Transformer Cuando desarrollamos APIs, una de las tareas más comunes -y a veces tediosas- es validar que los datos que recibimos en las peticiones cumplan con ciertos estándares. ¿No sería genial tener una forma sencilla y automatizada de hacer esto? En NestJS, podemos lograrlo con el  ValidationPipe  junto con las librerías  class-validator  y  class-transformer . Antes: Validación Manual Originalmente, nuestro controlador de autos ( cars.controller.ts ) aceptaba cualquier dato sin validación: typescript Copy Download import { Controller , Get , Param , Post , Body , Patch , Delete , ParseIntPipe } from '@nestjs/common' ; import { CarsService } from './cars.service' ; import { CreateCarDto } from './dto/create-car.dto' ; @ Controller ( 'cars' ) export class CarsController { constructor ( private readonly carsService : CarsService ) { } @ Get...
Leer más

32-Modulos

  directorios que se están usando en el ejemplo : Copy Download src/ │ ├── cars/ │ ├── cars.controller.ts # Controlador (maneja las rutas HTTP) │ ├── cars.module.ts # Módulo (registra controlador y servicio) │ └── cars.service.ts # Servicio (lógica de negocio) │ ├── app.module.ts # Módulo principal de la aplicación └── main.ts # Punto de entrada (configuración de NestJS) Explicación breve : cars/ : Contiene los archivos específicos del recurso  Cars  (controlador, módulo y servicio). app.module.ts : Importa y organiza los módulos de la aplicación (en este caso,  CarsModule ). main.ts : Inicia la aplicación y configura el servidor. Esta estructura sigue las  buenas prácticas de NestJS , separando responsabilidades en capas claras. Módulos en NestJS: La Base de tu Aplicación Introducción Cuando comenzamos a explorar NestJS, es normal encontrarnos con una estructura inicial llena de archivos que no siempre entendemos....
Leer más

49. Pipes Globales - A nivel de Aplicación

  Pipes Globales en NestJS: Validación a Nivel de Aplicación En NestJS, los Pipes son una herramienta poderosa para transformar y validar datos. En este post, exploraremos cómo implementar Pipes a nivel global en nuestra aplicación, lo que nos permite centralizar la validación y mantener un código más limpio y consistente. Estructura del Proyecto Antes de comenzar, veamos la estructura de nuestro proyecto: Copy Download src/ │ ├── cars/ │ ├── dto/ │ │ ├── create-car.dto.ts │ │ └── update-car.dto.ts │ ├── interfaces/ │ │ └── car.interface.ts │ ├── cars.controller.ts │ ├── cars.module.ts │ ├── cars.service.ts │ └── constants/ │ └── car.constants.ts │ ├── common/ │ ├── pipes/ │ │ └── validation.pipe.ts │ └── filters/ │ └── http-exception.filter.ts │ ├── app.module.ts ├── app.controller.ts ├── app.service.ts └── main.ts Antes: Validación por Controlador Inicialmente, teníamos que aplicar el  ValidationPipe  en cada método del contro...
Leer más