Dalam NestJS, provider ialah mana-mana kelas yang boleh disuntik (injected) sebagai satu dependency, manakala service ialah jenis yang paling lazim — iaitu kelas yang memegang logik perniagaan. Menanda satu kelas dengan @Injectable() menjadikannya satu provider yang boleh dicipta dan disuntik oleh sistem 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; }
}
Dekorator @Injectable() memberitahu NestJS bahawa kelas ini menyertai dependency injection — ia boleh disuntik ke dalam controllers atau providers lain.
@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
}
}
Anda mengisytiharkan dependency sebagai satu parameter constructor; NestJS mencipta dan membekalkan instance tersebut — anda tidak pernah menulis 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 mesti didaftarkan dalam array providers sesuatu module supaya DI mengetahuinya, dan exports berkongsi providers tersebut dengan modules lain.
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.
Providers dan services ialah teras kepada seni bina NestJS dan reka bentuknya yang dipacu dependency injection.
Services memegang logik perniagaan aplikasi, diasingkan daripada controllers (yang hanya mengendalikan urusan HTTP) — pengasingan urusan (separation of concerns) ini menjadikan logik boleh diguna semula merentas controllers, mudah diuji secara berasingan, dan tersusun rapi.
Memahami bahawa @Injectable() menanda satu kelas sebagai provider yang boleh disuntik, bahawa providers didaftarkan dalam modules dan disuntik melalui constructors (DI mencipta instance untuk anda), serta bahawa ia singleton secara lalai ialah pengetahuan asas NestJS sehari-hari.
Corak provider/service, digabungkan dengan controllers dan modules, ialah tulang belakang setiap aplikasi NestJS — menguasainya adalah penting untuk membina back-end yang tersusun baik dan boleh diselenggara, dan ia antara konsep pertama yang perlu dipelajari dalam framework ini.