2. Explicación sobre Controladores en NestJS

 2. Explicación sobre Controladores en NestJS

El propósito de un controlador es gestionar solicitudes específicas para la aplicación. El mecanismo de enrutamiento determina qué controlador gestionará cada solicitud. A menudo, un controlador tiene múltiples rutas, y cada una puede realizar una acción diferente.


Para crear un controlador básico, usamos clases y decoradores . Los decoradores vinculan las clases con los metadatos necesarios, lo que permite a Nest crear un mapa de enrutamiento que conecta las solicitudes con sus controladores correspondientes.


El texto principal explica el concepto de controladores en NestJS, que son fundamentales para manejar las solicitudes HTTP (como GET, POST, PUT, DELETE) y enviar respuestas al cliente.

¿Qué es un controlador?

  • Es una clase decorada con @Controller() que gestiona las rutas de una aplicación.

  • Su función principal es recibir una solicitud HTTP y devolver una respuesta.

  • NestJS usa decoradores (como @Get(), @Post(), etc.) para definir qué método del controlador manejará cada tipo de solicitud.

Ejemplo básico de un controlador

typescript
Copy
Download
import { Controller, Get } from '@nestjs/common';

@Controller('cats') // Ruta base: '/cats'
export class CatsController {
  @Get() // Maneja solicitudes GET a '/cats'
  findAll(): string {
    return 'Todos los gatos';
  }
}

  • @Controller('cats') define que todas las rutas dentro de este controlador empezarán con /cats.

  • @Get() indica que el método findAll() responderá a peticiones GET en la ruta /cats.

Generar un CRUD rápidamente

NestJS ofrece un comando CLI para generar automáticamente un controlador con operaciones CRUD (Create, Read, Update, Delete) y validación:

bash
Copy
Download
nest g resource [nombre]  # Ejemplo: nest g resource users

Esto crea:

  • Un controlador con métodos para GET, POST, PUT, DELETE.

  • Un servicio (lógica de negocio).

  • Un módulo.

  • DTOs (Data Transfer Objects) para validación.

3. Enrutamiento (Routing)

  • El enrutamiento en NestJS se basa en decoradores:

    • @Get(), @Post(), @Put(), @Delete(), etc.

  • Se pueden definir rutas con parámetros:

    typescript
    Copy
    Download
    @Get(':id')  // Ejemplo: GET /cats/1
findOne(@Param('id') id: string) {
  return `Gato con ID ${id}`;
}

  • Los prefijos de ruta (como @Controller('cats')) evitan repetir la misma ruta en cada método.

Resumen

  • Controladores en NestJS manejan solicitudes HTTP y devuelven respuestas.

  • Se definen con @Controller() y métodos con @Get(), @Post(), etc.

  • El enrutamiento es jerárquico y se simplifica con prefijos.

  • La CLI de NestJS (nest g resource) genera código CRUD automáticamente.

Si necesitas más detalles sobre algún punto o un ejemplo práctico, ¡avísame!

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