Προσαρμοσμένα behaviors
Ένα behavior υλοποιεί το IPipelineBehavior: μία μοναδική μέθοδο, handle(context, next). Εκτελεί
κώδικα πριν από το next(), μετά από αυτό, ή επιστρέφει αποτέλεσμα χωρίς να το καλέσει.
Ένα behavior είναι μια απλή κλάση. Δώστε στο pipeline ένα instance όταν ο constructor του χρειάζεται ορίσματα. Ένα behavior που δηλώνεται χωρίς instance δημιουργείται χωρίς ορίσματα constructor.
Ελέγξτε τα υποχρεωτικά ορίσματα του constructor μέσα σε αυτόν και ρίξτε ένα TypeError, ώστε ένα
missing dependency να αποτύχει κατά τη δημιουργία του pipeline και όχι κατά την πρώτη κλήση.
Επιλογές ανά λειτουργία (Options per operation)
Ενότητα με τίτλο «Επιλογές ανά λειτουργία (Options per operation)»Ένα call site περνάει επιλογές ως tuple [Behavior, options]. Το behavior διαβάζει τις συγχωνευμένες
επιλογές με το context.getBehaviorOptions(Behavior). Κάντε export έναν helper που κατασκευάζει το tuple,
όπως κάνει κάθε πακέτο:
Επιλογές που δίνονται τόσο καθολικά όσο και σε ένα call site συγχωνεύονται επιφανειακά (shallow merge), με τα κλειδιά του call site να υπερισχύουν. Δείτε Σειρά εκτέλεσης.
Κοινή χρήση τιμών με άλλα behaviors
Ενότητα με τίτλο «Κοινή χρήση τιμών με άλλα behaviors»Το context.items μεταφέρει τιμές από το ένα behavior στο επόμενο. Κάντε export ένα typed token για
κάθε τιμή που μπορεί να διαβάσει ένα άλλο behavior:
Αντικατάσταση του input
Ενότητα με τίτλο «Αντικατάσταση του input»Ένα behavior που παράγει ένα νέο input, όπως ένα parsed αντίγραφο, το παραδίδει στη συνάρτηση με το
replaceRequest(context, value) αντί να τροποποιήσει το αντικείμενο του καλούντος. Τα επόμενα behaviors
βλέπουν τότε την αντικατάσταση ως context.request.
Ένα contract
Ενότητα με τίτλο «Ένα contract»Μια κλάση behavior μπορεί να δηλώσει ένα contract κάτω από το well-known symbol
PIPELINE_BEHAVIOR_CONTRACT: κανόνες σειράς έναντι άλλων behaviors, και μια συνάρτηση validate
που ελέγχει τις ενεργές επιλογές κάθε λειτουργίας. Το pipeline εκτελεί το contract μία φορά ανά
λειτουργία, πριν από την πρώτη εκτέλεσή της. Δείτε
Πώς γίνεται wrap μια λειτουργία.
Ένας κανόνας σειράς ονομάζει άλλα behaviors με βάση την κλάση ή το string ταυτότητάς τους και εφαρμόζεται
μόνο όταν αυτά είναι παρόντα. Για να απαιτήσετε ένα peer behavior, ελέγξτε το context.effectiveBehaviorTypes
στο validate.
Σταθερή ταυτότητα (Stable identity)
Ενότητα με τίτλο «Σταθερή ταυτότητα (Stable identity)»Ένα behavior ταυτοποιείται από την κλάση του. Όταν ενδέχεται να φορτωθούν δύο αντίγραφα ενός πακέτου,
δώστε στην κλάση ένα σταθερό string στο PIPELINE_BEHAVIOR_ID, ώστε και τα δύο αντίγραφα να αναγνωρίζονται
ως ένα ενιαίο behavior:
Logging
Ενότητα με τίτλο «Logging»Γράψτε μέσω ενός PipelineLogger που λαμβάνεται ως προαιρετικό όρισμα constructor, με προεπιλογή
το console. Ένα NestJS LoggerService και τα περισσότερα structured loggers ικανοποιούν το interface.