NestJS:ssä tarjoaja on mikä tahansa luokka, joka voidaan injektoida riippuvuutena, ja palvelu on yleisin tyyppi — luokka, joka sisältää liiketoimintalogiikkaa. Luokan merkitseminen @Injectable() -merkinnällä tekee siitä tarjoajan, jonka NestJS:n DI-järjestelmä voi luoda ja injektoida.
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() -merkintä kertoo NestJS:lle, että tämä luokka osallistuu riippuvuuksien injektioon — se voidaan injektoida ohjaimiin tai muihin tarjoajiin.
@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
}
}
Ilmoitat riippuvuuden konstruktorin parametrina; NestJS luo ja toimittaa instanssin — et koskaan kirjoita 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 {}
Tarjoajat on rekisteröitävä moduulin providers -taulukossa, jotta DI tietää niistä, ja exports jakaa ne muiden moduulien kanssa.
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.
Tarjoajat ja palvelut ovat NestJS:n arkkitehtuurin ja riippuvuuksien injektioihin perustuvan suunnittelun ydin.
Palvelut sisältävät sovelluksen liiketoimintalogiikkaa, erotettuna ohjaajista (jotka käsittelevät vain HTTP-asioita) — tämä vastuujen erottaminen tekee logiikasta uudelleenkäytettävää ohjaajien välillä, helposti testattavissa eristyksessä ja hyvin järjestettyä.
Ymmärtäminen, että @Injectable() merkitsee luokan injektoimattavaksi tarjoajaksi, että tarjoajat rekisteröidään moduuleissa ja injektoidaan konstruktoreiden kautta (DI luo instanssit puolestasi) ja että ne ovat oletuksena singletoneita, on perusasiaa päivittäisessä NestJS-osaamisessa.
Tarjoaja/palvelu-malli yhdessä ohjaimien ja moduulien kanssa on jokaisen NestJS-sovelluksen selkäranka — sen hallitseminen on olennaista hyvin strukturoitujen, ylläpidettävien backend-sovellusten rakentamiseen, ja se on yksi ensimmäisistä konsepteista, jotka pitää oppia kehyksessä.