Μοντέλο εκτέλεσης pipeline
┌─ global before ──┐ ┌── @UsePipeline ──┐ ┌─ global after ──┐│ LoggingBehavior │ → │ AuditBehavior │ → │ TraceBehavior │ → handler.execute()│ ZodValidation │ │ Idempotency │ │ MetricsBehavior │└──────────────────┘ └──────────────────┘ └─────────────────┘ ← η απόκριση διαδίδεται πίσω μέσω της αλυσίδας ←Κύκλος ζωής Bootstrap και Ανακάλυψης (Discovery)
Ενότητα με τίτλο «Κύκλος ζωής Bootstrap και Ανακάλυψης (Discovery)»Κατά την εκκίνηση της εφαρμογής (onApplicationBootstrap), το PipelineBootstrap (από το @cqrs-ddd/nestjs) συνδέει το pipeline:
- Ανακάλυψη Handlers (Handler Discovery): Ανακαλύπτει όλους τους
@nestjs/cqrshandlers που έχουν καταχωρηθεί στο IoC container της Nest εφαρμογής χρησιμοποιώντας τοDiscoveryServiceτου Nest, διαβάζοντας metadata από τα@CommandHandler,@QueryHandlerκαι@EventsHandler. - Επαλήθευση Στατικού Δέντρου Εξαρτήσεων: Επαληθεύει το
provider.isDependencyTreeStatic()σε κάθε handler που εκτελεί behaviors. Εάν οποιοσδήποτε handler ή οι injected εξαρτήσεις του είναι request-scoped (Scope.REQUEST), το bootstrap αποτυγχάνει αμέσως με περιγραφικό σφάλμα. Οι handlers και τα behaviors πρέπει να είναι singletons· το context ανά αίτημα διαβάζεται μέσωAsyncLocalStorageμέσω των ρυθμισμένωνsources. - Επίλυση Behavior Providers: Επιλύει κάθε απαιτούμενο behavior instance από το DI container του NestJS υπό το class token του behavior (π.χ.
IdempotencyBehavior). Αποτυγχάνει άμεσα εάν ένα απαιτούμενο behavior δεν έχει provider ή εάν πολλαπλά modules παρέχουν αντικρουόμενα instances. - Σύνταξη Πλάνου (Plan Compilation): Συντάσσει το πλάνο εκτέλεσης μία φορά ανά handler (
compilePipelinePlan), υπολογίζοντας τη διατεταγμένη ακολουθία: globalbefore→@UsePipelineδηλωμένα behaviors → globalafter. - Διαγνωστικά Συμβολαίου (Contract Diagnostics): Όταν το
diagnosticsείναι'strict'(προεπιλογή), εκτελεί τοvalidateBehaviorContractsγια την επιβολή αρχιτεκτονικών κανόνων (π.χ. τοCaslBehaviorπρέπει να προηγείται τωνCacheBehaviorκαιIdempotencyBehavior). - Περικλείσιμο Εκτέλεσης (Execution Wrapping): Περικλείει τη μέθοδο
executeτου handler instance (ήhandleγια event handlers) με τον προ-μεταγλωττισμένοPipelineRunner. Κατά τον τερματισμό της εφαρμογής (onModuleDestroy), τα wrappers αποκαθίστανται καθαρά.
Κύκλος ζωής Εκτέλεσης Runtime
Ενότητα με τίτλο «Κύκλος ζωής Εκτέλεσης Runtime»Όταν ένας καλών αποστέλλει μέσω του CommandBus, QueryBus ή EventBus του Nest:
- Δημιουργία Context: Ο runner δημιουργεί ένα
IPipelineContextκαταγράφοντας το request instance, τον constructor της κλάσης, τον τύπο του handler, τη χρονοσήμανση και μια συλλογή items. - Πηγές Context (Context Sources): Συμπληρώνει τα
correlationIdκαιtenantIdαξιολογώντας τις ρυθμισμένες συναρτήσειςsourcesεντός του τρέχοντος ασύγχρονου context εκτέλεσης (AsyncLocalStorage). - Εκτέλεση Αλυσίδας Onion: Εκτελεί κάθε behavior με τη σειρά:
- Τα εξωτερικά behaviors εκτελούν λογική προεπεξεργασίας πριν καλέσουν το
next(). - Εάν ένα εξωτερικό behavior βραχυκυκλώσει (π.χ. εύρεση στην cache από το
CacheBehaviorή επανάληψη από τοIdempotencyBehavior), επιστρέφει το αποθηκευμένο αποτέλεσμα χωρίς να καλέσει τα επόμενα behaviors ή τον handler. - Τα εσωτερικά behaviors εκτελούνται, ακολουθούμενα από την επιχειρησιακή λογική του handler.
- Η λογική μετα-επεξεργασίας εκτελείται με αντίστροφη σειρά καθώς οι αποκρίσεις ή τα σφάλματα αναδύονται προς τα πάνω.
- Τα εξωτερικά behaviors εκτελούν λογική προεπεξεργασίας πριν καλέσουν το
Σειρά Εκτέλεσης
Ενότητα με τίτλο «Σειρά Εκτέλεσης»| Φάση | Πηγή | Θέση |
|---|---|---|
Καθολικό before |
globalBehaviors.before |
Εξωτερικότερο (εκτελείται πρώτο) |
| Επίπεδο Handler | @UsePipeline(...) |
Μεσαίο |
Καθολικό after |
globalBehaviors.after |
Εσωτερικότερο (πιο κοντά στον handler) |
| Handler | execute() / handle() |
Πυρήνας επιχειρησιακής λογικής |
Αποτροπή διπλοτύπων και Υπερίσχυση Ίδιας Κλάσης
Ενότητα με τίτλο «Αποτροπή διπλοτύπων και Υπερίσχυση Ίδιας Κλάσης»Όταν τόσο οι καθολικές ρυθμίσεις όσο και οι ρυθμίσεις επιπέδου handler περιλαμβάνουν την ίδια κλάση behavior, οι πλήρεις επιλογές του handler κερδίζουν, ενώ το behavior διατηρεί τη θέση του στην καθολική αλυσίδα. Τα καθολικά διπλότυπα απαλείφονται αυτόματα.
// Καθολική ρύθμιση στο PipelineModule.forRootPipelineModule.forRoot({ globalBehaviors: [ { scope: 'all', before: [ [LoggingBehavior, { metricLogLevel: 'log', requestResponseLogLevel: 'debug' }], ], }, ],})
// Ο Handler παρακάμπτει τις επιλογές του LoggingBehavior@CommandHandler(CreateUserCommand)@UsePipeline( [LoggingBehavior, { requestResponseLogLevel: 'log' }], // ← υπερισχύει των καθολικών επιλογών)export class CreateUserHandler implements ICommandHandler<CreateUserCommand> { // ...}
// Ενεργή αλυσίδα για τον CreateUserHandler:// [LoggingBehavior στη θέση global-before, χρησιμοποιώντας τις επιλογές του handler] → handler.execute()Η διατήρηση της εξωτερικής καθολικής θέσης εγγυάται ότι υποχρεωτικές οριζόντιες πολιτικές (όπως authentication ή logging) δεν μπορούν να μετακινηθούν πίσω από behaviors caching ή idempotency που ενδέχεται να βραχυκυκλώσουν πριν καλέσουν το next().