DDD χωρίς framework
Αυτός ο οδηγός εκτελεί έναν command handler του @cqrs-ddd/core μέσω ενός pipeline του
@cqrs-ddd/pipeline, χωρίς κανένα framework και χωρίς DI container. Τα δύο πακέτα δεν εξαρτώνται
το ένα από το άλλο. Για buses και decorated handlers, δείτε
CQRS χωρίς NestJS.
Το aggregate
Ενότητα με τίτλο «Το aggregate»Το User αλλάζει την κατάστασή του μόνο μέσω των events που εφαρμόζει: η μέθοδος rename() καταγράφει
ένα UserRenamedEvent, και η onUserRenamedEvent το εφαρμόζει.
Το pipeline
Ενότητα με τίτλο «Το pipeline»Κάθε command καταγράφεται (audited), εδώ σε ένα in-memory trail:
Το command και ο handler του
Ενότητα με τίτλο «Το command και ο handler του»Το RenameUserCommand επεκτείνει το BaseCommand, το οποίο φέρει το brand REQUEST_KIND,
ώστε το pipeline να γνωρίζει ότι είναι command και να ονομάζει τη λειτουργία RenameUserCommand.
Ο decorator δεν χρειάζεται επιλογές: @pipeline.wrap(audit(...)).
Το CommandBaseHandler.execute() καλεί τη μέθοδο handle() και στη συνέχεια δημοσιεύει τα events του aggregate.
Ο handler κάνει override το execute() μόνο για να το διακοσμήσει (decorate), ώστε ολόκληρη η διαδικασία,
συμπεριλαμβανομένης της δημοσίευσης (publication), να εκτελείται μέσα στο pipeline: τα behaviors βλέπουν
τα events ως μέρος του command, και μια αποτυχημένη δημοσίευση αποτυγχάνει το command.
Εκτέλεση
Ενότητα με τίτλο «Εκτέλεση»Η εγγραφή audit φέρει το όνομα και το είδος (kind) που λαμβάνονται από το command και το όνομα του handler
RenameUserHandler.execute. Το event δημοσιεύεται ενώ εκτελείται το pipeline.
Ο κώδικας γίνεται compile με experimentalDecorators: true. Το persistence εδώ είναι ένα Map.
Μια πραγματική εφαρμογή υλοποιεί τα repository contracts του
@cqrs-ddd/core, με το
@cqrs-ddd/mikro-orm ή τον δικό της adapter.
Στο repository
Ενότητα με τίτλο «Στο repository»Ο κώδικας αυτού του οδηγού εκτελείται στο integration/profiles/,
ενώ το integration/members/ τοποθετεί
το ίδιο είδος aggregate στα buses του @cqrs-ddd/cqrs. Δύο ακόμα εφαρμογές χρησιμοποιούν το @cqrs-ddd/core
χωρίς pipeline ή buses:
-
integration/library/: ένα book aggregate με value rules, πεδία@Mutableκαι μεθόδους@ApplyMutation, καθώς και υποκλάσειςCommandBaseHandlerπου δημοσιεύουν τα events του σε ένα in-memory repository. Ένας δανεισμός που απορρίπτεται δεν αποθηκεύει ούτε δημοσιεύει τίποτα. Μια εγγραφή από μη ενημερωμένο αντίγραφο (stale copy) αποτυγχάνει μεConcurrencyConflictError. -
integration/inventory/: repositories που δηλώνουν το persistence τους με τους core decorators, πάνω σε MikroORM σε in-memory SQLite, με το repository cache στην ίδια βάση δεδομένων:
Το api/ χρησιμοποιεί και τις δύο οικογένειες
μαζί, πάνω στα buses του @cqrs-ddd/cqrs.