4. Proveedores (@Injectable), Servicios de Negocio e Inyección de Dependencias (IoC)
Desacopla la lógica de negocio en servicios inyectables, comprende el contenedor de Inversión de Control (IoC) y el alcance de vida (Singleton vs Request).
¿Qué es un Proveedor (Provider) y el Contenedor IoC?
En NestJS, un Provider es cualquier clase decorada con @Injectable(): servicios de negocio, repositorios de base de datos, clientes HTTP o fábricas de conexión.
Gracias al patrón de Inversión de Control (IoC), tú nunca escribes new CursosService() manualmente. En su lugar, declaras la dependencia en el constructor del controlador (constructor(private readonly cursosService: CursosService)) y el motor de NestJS resuelve, instancia e inyecta el objeto automáticamente.
Ciclo de Vida de los Proveedores (Scopes)
| Scope (Alcance) | Comportamiento en Memoria | Caso de Uso |
|---|---|---|
Scope.DEFAULT (Singleton) |
Se crea una única instancia al arrancar la aplicación y se reutiliza en todas las peticiones HTTP. | El 99% de los servicios de negocio y repositorios (máximo rendimiento y 0 sobrecarga de memoria). |
Scope.REQUEST |
Se instancia un objeto nuevo exclusivamente para cada petición HTTP entrante y se destruye al responder. | Casos especiales donde el servicio debe almacenar estado exclusivo del Request o del Tenant actual. |
Scope.TRANSIENT |
Cada consumidor que lo inyecta recibe una instancia privada e independiente. | Loggers con contexto propio por clase (new Logger(NombreClase)). |
⚡ Servicio de Negocio Inyectable con Tipado Estricto en TypeScript
Implementación de CursosService gestionando la lógica de dominio y lanzando excepciones semánticas:
import { Injectable, NotFoundException } from '@nestjs/common';
export interface Curso {
id: number;
slug: string;
titulo: string;
instructor: string;
horas: number;
activo: boolean;
}
@Injectable()
export class CursosService {
private readonly cursos: Curso[] = [
{
id: 1,
slug: 'nestjs-profesional',
titulo: 'Arquitectura Backend con NestJS y TypeScript',
instructor: 'Juan Sebastián Amador',
horas: 40,
activo: true,
},
{
id: 2,
slug: 'fullstack-web-developer',
titulo: 'Proyecto Full-Stack Web Developer',
instructor: 'Juan Sebastián Amador',
horas: 48,
activo: true,
},
];
listar(): Curso[] {
return this.cursos.filter((c) => c.activo);
}
buscarPorSlug(slug: string): Curso {
const curso = this.cursos.find((c) => c.slug === slug && c.activo);
if (!curso) {
throw new NotFoundException(`El curso con slug "${slug}" no existe en Kilopolis Academia.`);
}
return curso;
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es el alcance de vida (Scope) por defecto de un servicio decorado con @Injectable() en NestJS?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.