Tema 4 · Servicios & DI

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:

src/cursos/cursos.service.ts
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.