Πρώτα βήματα
Μια πρώτη εκτέλεση
Ενότητα με τίτλο «Μια πρώτη εκτέλεση»Σε έναν άδειο κατάλογο, εγκαταστήστε το pipeline, το behavior επικύρωσης και το Zod:
Αποθηκεύστε το παρακάτω ως create-order.mjs:
Εκτελέστε το:
Η standard output δείχνει την καταγεγραμμένη κλήση, το αποτέλεσμα της έγκυρης παραγγελίας και την απόρριψη της μη έγκυρης. Το correlation id και η διάρκεια διαφέρουν σε κάθε εκτέλεση:
Το logging() αναφέρει επίσης την απορριφθείσα κλήση στη standard error, ως
createOrder failed με το ZodValidationError και το stack του. Πρόκειται για την
καταγραφή της αποτυχίας που προκαλεί το ίδιο το παράδειγμα· η διεργασία τερματίζει με
κωδικό 0. Η συνάρτηση επιστρέφει ένα αντικείμενο και δεν αποθηκεύει τίποτα: δεν υπάρχει
βάση δεδομένων, framework ή βήμα build.
Η υπόλοιπη σελίδα παρουσιάζει τα ίδια κομμάτια ένα προς ένα.
Εγκατάσταση
Ενότητα με τίτλο «Εγκατάσταση»Τα πακέτα απαιτούν Node.js 22.12 ή νεότερο· το @cqrs-ddd/mikro-orm απαιτεί 22.17 ή
νεότερο, όπως και το MikroORM 7. Ο έλεγχος κυκλοφορίας (release check)
φορτώνει επίσης κάθε entry point σε Bun· οι σουίτες δοκιμών εκτελούνται μόνο σε Node.js
και κανένα άλλο runtime δεν δοκιμάζεται. Τα πακέτα δημοσιεύονται ως ES modules· μια
εφαρμογή CommonJS τα φορτώνει με require().
Δημιουργία pipeline
Ενότητα με τίτλο «Δημιουργία pipeline»Ένα pipeline κρατά τα instances των behaviors και τα behaviors που ισχύουν για κάθε λειτουργία. Δημιουργήστε το μία φορά, σε δικό του module:
Τα behaviors είναι τα instances, ένα ανά κλάση behavior· ένα behavior που τοποθετείται
χωρίς instance κατασκευάζεται χωρίς ορίσματα. Το globalBehaviors τοποθετεί behaviors
γύρω από κάθε λειτουργία που τυλίγεται.
Τύλιγμα συνάρτησης
Ενότητα με τίτλο «Τύλιγμα συνάρτησης»Το pipeline.wrap(options, ...entries) επιστρέφει έναν wrapper. Όταν εφαρμοστεί σε μια
συνάρτηση, επιστρέφει μια νέα async συνάρτηση που εκτελεί τα behaviors γύρω της:
Μια απλή συνάρτηση χρειάζεται ένα name, με το οποίο τα κλειδιά και τα logs ξεχωρίζουν
τις λειτουργίες, και ένα kind: ένα query διαβάζει, ένα command αλλάζει κατάσταση,
ένα event αντιδρά. Τα behaviors χρησιμοποιούν το kind για να αποφασίσουν τι ισχύει· το
idempotency, για παράδειγμα, ισχύει για commands.
Decorator σε μέθοδο
Ενότητα με τίτλο «Decorator σε μέθοδο»Ο ίδιος wrapper γίνεται decorator μεθόδου, με τους standard decorators της TypeScript ή
με experimentalDecorators:
Μια μέθοδος ονομάζεται Class.method (εδώ Prices.find), εκτός αν τα options της δίνουν
όνομα.
Προσθήκη behavior
Ενότητα με τίτλο «Προσθήκη behavior»Κάθε λειτουργία είναι ένα πακέτο. Εγκαταστήστε το, δώστε στο pipeline ένα instance και προσθέστε την καταχώρισή του εκεί που ισχύει:
Επόμενα βήματα
Ενότητα με τίτλο «Επόμενα βήματα»- Πώς τυλίγεται μια λειτουργία: ονόματα, kinds και αιτήματα.
- Οδηγός απλού Node.js: ένα πλήρες παράδειγμα με tests.
- Πακέτα: κάθε behavior και οι ρυθμίσεις του.
- CQRS χωρίς NestJS: μια εφαρμογή με commands, queries και
events πάνω στο
@cqrs-ddd/cqrs, συνδεδεμένη μεcreateCqrs(). - NestJS & @cqrs-ddd: ενσωμάτωση με NestJS μέσω του
@cqrs-ddd/nestjs. - Οι εφαρμογές του αποθετηρίου: μικρές εφαρμογές που χρησιμοποιούν η καθεμία μία οικογένεια
πακέτων (μόνο το pipeline, μόνο το domain, μόνο τα repositories), και το
api/, που τα χρησιμοποιεί όλα.