X'inhu middleware f'NestJS u kif jiddiffer mill-guards/interceptors?

Question

Accepted Answer

**Middleware** hija funzjoni li timxi **qabel il-route handler**, b'aċċess għall-oggetti ta' request u response — l-istess kunċett bħal Express middleware. NestJS għandu wkoll guards, interceptors, pipes, u filters, kull wieħed jimxi f'punt spesifiku fil-lifecycle ta' request b'għan distint. Li tkun taf liema tużża hija essenzjali.

## Middleware — imxi l-ewwel, għandu req/res

```ts
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`${req.method} ${req.url}`);   // logging, modifying req
    next();                                      // MUST call next() to continue
  }
}

// register in a module
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(LoggerMiddleware).forRoutes("*");   // apply to routes
  }
}
```

Middleware jimxi l-aktar kmieni, qabel guards/interceptors/pipes, u jaħdem ma' raw `req`/`res` — tajjeb għall-logging, modifikazzjoni ta' request, CORS, u concerns li huma kompatibbli ma' Express.

## L-ordni sħiħ tal-lifecycle tal-request

```text
Request →
  1. Middleware     (req/res; runs first, Express-style)
  2. Guards         (return true/false → AUTHORIZE or block the request)
  3. Interceptors   (BEFORE the handler)
  4. Pipes          (validate/transform the handler's arguments)
  5. → Route Handler ←
  6. Interceptors   (AFTER the handler — transform the response)
  7. Exception Filters (if an error was thrown anywhere)
→ Response
```

## X'inhu għal kull wieħed (jagħżel it-tool sħiħ)

```text
Middleware  → general pre-processing with req/res (logging, CORS, raw request work)
Guards      → AUTHORIZATION — decide if a request may proceed (auth, roles)
              (return true = allow, false/throw = block)
Interceptors→ wrap the handler — transform request/response, add logging/caching/timing
              (can run logic BEFORE and AFTER the handler)
Pipes       → VALIDATE/TRANSFORM the handler's input arguments (DTO validation)
Filters     → catch and format EXCEPTIONS into responses
```

Id-distinzjonijiet ewlenin: middleware hija pre-processing ta' stil Express ġeneriku; **guards** jittrattaw speċifikament authorization (post pnok u dedikatu għall-auth, mhux qiegħda tiddaħħal fid-middleware); **interceptors** joħolqu round il-handler biex ittrasfurmaw responses jew iżidu cross-cutting behavior; **pipes** jivvalidaw input; **filters** jittrattaw errors.

## Meta tuża middleware vs guards vs interceptors

```text
Auth check?           → Guard (dedicated, has execution context, returns boolean)
Logging requests?     → Middleware OR an interceptor (interceptor sees the response too)
Transform responses?  → Interceptor (runs after the handler)
Validate a DTO?       → Pipe
Modify raw req early?  → Middleware
```

## Għaliex huwa importanti

Fhim tal-middleware u kif jiddiffer mill-guards, interceptors, pipes, u filters hija essenzjali għall-istruttura tal-applikazzjonijiet NestJS b'mod korrett — kull wieħed għandu rwol spesifiku u imxi f'punt spesifiku fil-lifecycle tal-request, u l-użu tal-tool sħiħ iwassal għal kodiċi pnok u idiomatic.

Middleware tittratta pre-processing ta' stil Express ġeneriku ma' raw req/res.

Id-distinzjonijiet kruċjali huma li **guards** huma l-post dedikatu u xieraq għall-authorization (auth/roles) — ħafna aktar pnok minn middleware għal dak il-għan — u **interceptors** joħolqu round il-handler biex ittrasfurmaw responses u żidu cross-cutting concerns (logging, caching, timing) li middleware ma jistax jagħmel faċilment (peress li jimxi qabel il-handler u ma jara' l-response b'mod naturali).

Il-għarfien tal-ordni sħiħ tal-lifecycle (middleware → guards → interceptors → pipes → handler → interceptors → filters) u liema tool tajjeb għal kull concern (auth → guard, response transformation → interceptor, validation → pipe, errors → filter) huwa sinjal ta' competenza f'NestJS u jipprevjeni l-iżball komuni ta' mussl ta' middleware għal kollox.

Hija topics li test spiss u importanti mill-aspett tal-arkitettura fil-framework.