В NestJS provider (провайдер) — это любой класс, который можно внедрить как зависимость, а service (сервис) — самый распространённый вид провайдера, класс, содержащий бизнес-логику. Отметив класс декоратором @Injectable(), вы делаете его провайдером, который система DI в NestJS может создавать и внедрять.
import { Injectable } from "@nestjs/common";
@Injectable() // marks the class as a provider (injectable)
export class UsersService {
private users = [];
findAll() { return this.users; } // business logic
findOne(id: string) { return this.users.find(u => u.id === id); }
create(data) { this.users.push(data); return data; }
}
Декоратор @Injectable() сообщает NestJS, что этот класс участвует в dependency injection — его можно внедрить в контроллеры или другие провайдеры.
@Controller("users")
export class UsersController {
// NestJS sees this parameter and INJECTS a UsersService instance automatically
constructor(private usersService: UsersService) {}
@Get()
findAll() {
return this.usersService.findAll(); // use the injected service
}
}
Вы объявляете зависимость как параметр конструктора; NestJS создаёт и предоставляет экземпляр — вы никогда не пишете new UsersService().
@Module({
controllers: [UsersController],
providers: [UsersService], // register the provider so DI can resolve it
exports: [UsersService], // make it available to OTHER modules that import this one
})
export class UsersModule {}
Провайдеры должны быть зарегистрированы в массиве providers модуля, чтобы DI знал о них, а exports делает их доступными для других модулей.
By default, NestJS creates ONE shared instance of each provider (singleton scope)
for the whole application → efficient, shared state.
(Other scopes exist: REQUEST-scoped, TRANSIENT — but singleton is the default.)
Controller → handles HTTP (routing, request/response)
Service → handles business logic (rules, data access, computations)
→ Separation makes logic REUSABLE (multiple controllers can use one service),
TESTABLE (test the service in isolation), and ORGANIZED.
Провайдеры и сервисы — это ядро архитектуры NestJS и его дизайна, основанного на dependency injection.
Сервисы содержат бизнес-логику приложения, отделённую от контроллеров (которые занимаются только HTTP-concerns) — такое разделение ответственности делает логику переиспользуемой между контроллерами, легко тестируемой в изоляции и хорошо организованной.
Понимание того, что @Injectable() отмечает класс как injectable provider, что провайдеры регистрируются в модулях и внедряются через конструкторы (DI создаёт экземпляры для вас), и что они по умолчанию являются синглтонами — это фундаментальное повседневное знание NestJS.
Паттерн provider/service в сочетании с контроллерами и модулями — это основа каждого приложения NestJS — владение им необходимо для создания хорошо структурированных, поддерживаемых бэкендов и входит в число первых концепций, которые нужно изучить в этом фреймворке.