Kas yra tiekėjai (providers) ir paslaugos (services)?

Question

Accepted Answer

NestJS sistemoje **tiekėjas** (provider) yra bet kuri klasė, kurią galima **injektuoti** kaip priklausomybę, o **paslauga** (service) yra labiausiai paplitęs tipas — klasė, kuri turi **verslo logiką**. Žymint klasę `@Injectable()`, ji tampa tiekėju, kurį NestJS DI sistema gali sukurti ir injektuoti.

## Paslaugos apibrėžimas (labiausiai paplitęs tiekėjo tipas)

```ts
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()` dekoratorius nurodo NestJS, kad ši klasė dalyvauja priklausomybės injektavime — ji gali būti injektuota į valdiklius (controllers) ar kitus tiekėjus.

## Paslaugos injektavimas per konstruktorių

```ts
@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
  }
}
```

Jūs deklaruojate priklausomybę kaip konstruktoriaus parametrą; NestJS sukuria ir teikia instancenį — jūs niekada nerašote `new UsersService()`.

## Tiekėjų registracija modulyje

```ts
@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 {}
```

Tiekėjai turi būti užregistruoti modulio `providers` masyve, kad DI apie juos žinotų, o `exports` juos dalina su kitais moduliais.

## Tiekėjai yra singletonai pagal numatytuosius nustatymus

```text
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.)
```

## Kodėl atskiri valdikliai nuo paslaugų?

```text
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.
```

## Kodėl tai svarbu

Tiekėjai ir paslaugos yra pagrindiniai NestJS architektūros ir jos priklausomybės injektavimo pagrįstos konstrukcijos komponentai.

Paslaugos turi aplikacijos **verslo logiką**, atskirtą nuo valdiklių (kurie tvarko tik HTTP klausimus) — ši atsakomybės atskyrimas daro logiką pakartotinai panaudojamą keliuose valdikliuose, lengvai testuojamą atskirai ir gerai organizuotą.

Supratimas, kad `@Injectable()` žymi klasę kaip injektuojamą tiekėją, kad tiekėjai registruojami moduliuose ir injektuojami per konstruktorius (DI sukuria instances jums), ir kad jie yra singletonai pagal numatytuosius nustatymus, yra pagrindinės kasdieninės NestJS žinios.

Tiekėjo/paslaugos šablonas, sujungtas su valdikliais ir moduliais, yra kiekvienos NestJS aplikacijos pagrindas — jo įsisavimas yra būtinas norint kurti gerai struktūrizuotas, lengvai prižiūrimas back-endus ir yra vienas iš pirmųjų koncepcijų, kurį reikia išmokti darbo su šiuo karkasu pradžioje.