module. y decoradores

 Conceptos Básicos de NestJS

Voy a explicarte los conceptos que mencionaste sobre NestJS:

1. main.ts

El archivo main.ts es el punto de entrada de una aplicación NestJS. Es donde se inicializa y se lanza la aplicación. Su estructura típica es:

typescript
Copy
Download
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000); // Puerto donde escucha la aplicación
}
bootstrap();

Funciones principales:

  • Crea una instancia de la aplicación NestJS usando NestFactory.create()

  • Especifica el módulo raíz (AppModule)

  • Configura opciones globales como middlewares, pipes, filters, etc.

  • Inicia el servidor en un puerto específico

2. app.module.ts

El archivo app.module.ts es el módulo raíz de la aplicación NestJS. Los módulos son clases decoradas con @Module() que organizan la estructura de la aplicación.

Estructura típica:

typescript
Copy
Download
import { Module } from '@nestjs/common';
import { CatsController } from './cats/cats.controller';
import { CatsService } from './cats/cats.service';

@Module({
  imports: [],       // Otros módulos que este módulo necesita
  controllers: [CatsController], // Controladores del módulo
  providers: [CatsService],      // Servicios/proveedores del módulo
  exports: []        // Qué proveedores se exportan para otros módulos
})
export class AppModule {}

Propiedades del decorador @Module:

  • imports: Lista de módulos requeridos por este módulo

  • controllers: Controladores que pertenecen a este módulo

  • providers: Servicios, repositorios, factories, etc. que pueden ser inyectados

  • exports: Proveedores que están disponibles para otros módulos que importen este módulo

3. Decoradores en NestJS

Los decoradores son funciones especiales que añaden metadatos a clases, métodos o propiedades, permitiendo a NestJS saber cómo deben comportarse.

Principales decoradores en NestJS:

  1. Decoradores de clase:

    • @Controller(): Define una clase como controlador

    • @Module(): Define una clase como módulo

    • @Injectable(): Marca una clase como proveedor (service, repository, etc.)

  2. Decoradores de métodos (rutas):

    • @Get(), @Post(), @Put(), @Delete(), etc.: Definen los métodos HTTP

    • @Param(): Para acceder a parámetros de ruta

    • @Query(): Para acceder a query parameters

    • @Body(): Para acceder al cuerpo de la petición

  3. Decoradores de parámetros:

    • @Req(): Para acceder al objeto Request

    • @Res(): Para acceder al objeto Response

Ejemplo de uso combinado:

typescript
Copy
Download
@Controller('cats') // Decorador de clase
export class CatsController {
  constructor(private readonly catsService: CatsService) {}

  @Get(':id') // Decorador de método
  findOne(@Param('id') id: string): Cat { // Decorador de parámetro
    return this.catsService.findOne(id);
  }
}

Los decoradores son fundamentales en NestJS porque permiten definir el comportamiento de la aplicación de manera declarativa, reduciendo la necesidad de código boilerplate

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