NestJS Class Validator & Class Transformer: Detaylı Rehber

NestJS Class Validator & Class Transformer: Detaylı Rehber

Merhaba! Bu makalede, NestJS uygulamalarınızda veri doğrulama ve dönüştürme işlemlerini kolaylaştıran iki güçlü kütüphane olan Class Validator ve Class Transformer’ı detaylı olarak inceleyeceğiz. Her iki kütüphane de geliştirme sürecini hızlandırarak daha temiz ve sürdürülebilir kod yazmanıza yardımcı olur. İlk olarak, her kütüphanenin temel işlevlerine ve kullanım örneklerine bakacağız. Sonrasında ise, iki kütüphanenin birlikte nasıl kullanılacağını ve uygulamanıza nasıl entegre edileceğini adım adım açıklayacağız. Bu sayede, veri yönetiminizi optimize edebilir ve uygulamanızın güvenilirliğini artırabilirsiniz.

Class Validator: Veri Doğrulamanın Güçlü Ortağı

Class Validator, TypeScript sınıflarınıza veri doğrulama kuralları eklemenizi sağlar. Bu, gelen verilerin belirli bir şema veya formata uygun olup olmadığını kontrol etmenizi mümkün kılar. Örneğin, bir email alanının gerçekten email formatında olup olmadığını, yaş alanının bir sayı olup olmadığını ve pozitif olup olmadığını kontrol edebilirsiniz. Bu sayede, uygulamanızın güvenliğini artırabilir ve beklenmedik hataları önleyebilirsiniz. Class Validator, hem basit hem de karmaşık doğrulama kuralları için esnek bir yapı sunar.

import { IsEmail, IsNotEmpty, IsNumber, Min } from 'class-validator';

export class UserDto {
  @IsNotEmpty()
  name: string;

  @IsEmail()
  email: string;

  @IsNumber()
  @Min(18)
  age: number;
}

Class Transformer: Veri Dönüştürme İşlemlerini Kolaylaştırıyor

Class Transformer, veri dönüştürme işlemlerini basitleştirmek için tasarlanmıştır. Örneğin, bir veritabanından gelen veriyi, uygulamanızın ihtiyaç duyduğu bir nesneye dönüştürmeniz gerekebilir. Veya, bir API isteğinden gelen JSON verilerini, bir TypeScript sınıfına dönüştürmeniz gerekebilir. Class Transformer, bu tür dönüştürme işlemlerini özel dekoratörler sayesinde kolay ve temiz bir şekilde yapmanızı sağlar. Bu sayede, kodunuz daha okunaklı ve daha sürdürülebilir hale gelir.

import { Transform, Type } from 'class-transformer';

export class UserDto {
  @Transform(({ value }) => value.toUpperCase())
  name: string;
  
  @Type(() => Date)
  creationDate: Date;
}

Class Validator ve Class Transformer’ı Birlikte Kullanmak

Class Validator ve Class Transformer’ı birlikte kullanarak, gelen verileri doğrulayabilir ve ardından uygulamanızda kullanmak için uygun bir nesneye dönüştürebilirsiniz. Bu, veri yönetiminizi daha güvenli ve daha verimli hale getirir. İki kütüphanenin birlikte kullanımı, uygulamanızın genel kalitesini ve güvenilirliğini artırır.

Örneğin, bir API isteği alırken önce Class Validator ile gelen verileri doğrulayabilir, sonrasında ise Class Transformer ile uygun bir nesneye dönüştürebilirsiniz. Bu süreç, hata riskini azaltırken, kodun okunabilirliğini ve bakımı kolaylaştırır. Daha fazla bilgi için, fatihsoysal.com adresindeki diğer makalelerime göz atabilirsiniz.

Sonuç

Class Validator ve Class Transformer, NestJS uygulamalarınızda veri yönetimini önemli ölçüde kolaylaştırır. Bu kütüphaneleri kullanarak, kodunuzu daha temiz, daha güvenilir ve daha sürdürülebilir hale getirebilirsiniz. Bu makalede ele aldığımız konuların, geliştirme sürecinizde size yardımcı olacağını umuyorum. Daha fazla bilgi ve örnek için, resmi dokümanlara göz atmanız faydalı olacaktır.

#Etiketler

#nestjs #class-validator #class-transformer #veri-doğrulama #veri-dönüştürme #typescript #nodejs #nestjs-rehberi #fatihsoysal