Pipes είναι κλάσεις που μετασχηματίζουν ή επικυρώνουν δεδομένα εισόδου πριν φθάσουν σε έναν route handler. Λειτουργούν στα ορίσματα των μεθόδων ελεγκτή — είτε μετασχηματίζοντάς τα (π.χ. string → number) είτε επικυρώνοντάς τα (απορρίπτοντας άκυρα δεδομένα). Η επικύρωση στο NestJS βασίζεται σε pipes.
()
() {
..(id);
}
Τα transformation pipes μετατρέπουν την είσοδο στον σωστό τύπο (παράμετροι διαδρομής/queries είναι πάντα strings), αποτυγχάνουν με 400 εάν η μετατροπή δεν είναι δυνατή.
// enable globally in main.ts
app.useGlobalPipes(new ValidationPipe({
whitelist: true, // remove properties not declared in the DTO
forbidNonWhitelisted: true, // throw if unknown properties are present
transform: true, // turn plain objects into DTO instances, convert types
}));
// with a DTO using class-validator decorators:
export class CreateUserDto {
@IsEmail() email: string;
@MinLength(8) password: string;
}
@Post()
create(@Body() dto: CreateUserDto) { // ValidationPipe validates the body automatically
// if invalid → 400 with details, BEFORE this runs
}
Το ValidationPipe διαβάζει τους διακοσμητές class-validator του DTO και επικυρώνει αυτόματα τα εισερχόμενα δεδομένα — επιστρέφει ένα λεπτομερές 400 error κατά τη αποτυχία, ώστε ο χειριστής σας να λαμβάνει μόνο έγκυρα δεδομένα.
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
@Injectable()
export class TrimPipe implements PipeTransform {
transform(value: any) {
return typeof value === "string" ? value.trim() : value; // custom transformation
}
}
// usage: @Body(TrimPipe) ...
Εφαρμόζετε τη μέθοδο transform() του PipeTransform για προσαρμοσμένη λογική επικύρωσης/μετασχηματισμού.
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Τα Pipes είναι μια βασική δυνατότητα του NestJS για ασφαλή χειρισμό της εισόδου και είναι το ίδρυμα του συστήματος επικύρωσης του πλαισίου.
Η κατανόησή τους είναι απαραίτητη επειδή σχεδόν κάθε API endpoint χρειάζεται να επικυρώνει και να μετασχηματίζει την είσοδο: τα transformation pipes (ParseIntPipe κ.λπ.) διασφαλίζουν ότι οι παράμετροι είναι του σωστού τύπου, και — πολύ σημαντικό — το ValidationPipe σε συνδυασμό με DTOs παρέχει αυτόματη, δηλωτική επικύρωση των σωμάτων αίτησης έναντι κανόνων class-validator, απορρίπτοντας άκυρη ή κακόβουλη είσοδο με σαφή σφάλματα πριν φθάσει στη λογική της επιχείρησής σας.
Αυτό είναι κρίσιμο τόσο για την ασφάλεια (επικύρωση/απολύμανση μη αξιόπιστης εισόδου, κατάργηση απροσδόκητων ιδιοτήτων) όσο και για την ευρωστία (οι χειριστές λαμβάνουν μόνο έγκυρα δεδομένα).
Η γνώση του τρόπου ενεργοποίησης του global validation pipe με λογικές επιλογές (whitelist, transform), της χρήσης ενσωματωμένων transformation pipes και της συγγραφής προσαρμοσμένων pipes είναι θεμελιώδης για τη δημιουργία ασφαλών, καλά δομημένων NestJS APIs — τα pipes και η επικύρωση είναι καθημερινές, απαραίτητες έννοιες στο πλαίσιο.