NestJS માં DTOs શું છે?

Question

Accepted Answer

A **DTO (Data Transfer Object)** એક વર્ગ છે જે તમારા API ને મોકલવામાં અથવા પ્રાપ્ત કરવામાં આવતા ડેટાનો **આકાર** નિર્ધારિત કરે છે — સામાન્યતઃ વિનંતી બોડીની રચના. DTOs પ્રકારની સુરક્ષા પ્રદાન કરે છે, અંતબિંદુઓ માટે સ્પષ્ટ કરાર તરીકે કામ કરે છે, અને (માન્યતા સજાવટ સાથે) સ્વચાલિત ઇનપુટ માન્યતા સક્ષમ કરે છે.

## DTO સંজ્ઞાયિત કરવું

```ts
import { IsEmail, IsString, MinLength, IsOptional, IsInt, Min } from "class-validator";

export class CreateUserDto {
  @IsEmail()                    // must be a valid email
  email: string;

@IsString()
  @MinLength(8)                 // password at least 8 chars
  password: string;

@IsOptional()                 // optional field
  @IsInt()
  @Min(0)
  age?: number;
}
```

DTO એક સાદો વર્ગ છે જે અપેક્ષિત ડેટા વર્ણવે છે, જેમાં **માન્યતા સજાવટ** (`class-validator` માંથી) દરેક ક્ષેત્રને સંતોષવાની જરૂરી નિયમો સ્પષ્ટ કરે છે.

## કંટ્રોલરમાં DTO ઉપયોગ કરવું

```ts
@Post()
create(@Body() dto: CreateUserDto) {     // the body is typed AND validated as CreateUserDto
  // dto is guaranteed to be valid here (with the validation pipe enabled)
  return this.usersService.create(dto);
}
```

`@Body() dto: CreateUserDto` વિનંતી બોડીને ટાઇપ કરે છે અને — માન્યતા પાઇપ સક્ષમ કર્યા પછી — તમારા હેન્ડલર ચલાવે તે પહેલાં તેને સ્વચાલિત રીતે માન્ય કરે છે.

## સ્વચાલિત માન્યતા સક્ષમ કરવું

```ts
// main.ts — turn on the global validation pipe
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // strip properties NOT in the DTO (security)
  forbidNonWhitelisted: true,   // reject requests with extra unknown properties
  transform: true,              // auto-transform payloads to DTO instances + convert types
}));
```

`ValidationPipe` સાથે, NestJS આવતા બોડીને DTO ની સજાવટ તરીકે સ્વચાલિત રીતે માન્ય કરે છે — માન્યતા નિષ્ફળ થાય તો વિસ્તાર સાથે 400 ભૂલ પરત કરે છે, તમારો કોડ ચલાવે તે પહેલાં.

## DTOs વિરુદ્ધ એન્ટિટીઝ

```text
DTO    → the shape of data crossing the API boundary (request/response contract)
Entity → the database model (e.g. a TypeORM entity / Prisma model)
→ Keep them SEPARATE: the API contract shouldn't be coupled to the DB schema.
  (A CreateUserDto has password+email; the User entity has id, timestamps, etc.)
```

DTOs ઇરાદાપૂર્વક ડેટાબેસ એન્ટિટીઝથી અલગ છે — તેઓ API સ્વીકાર કરે તેનું અથવા પરત કરે તેનું પ્રતિનિધિત્વ કરે છે, આંતરિક સંગ્રહથી અલગ.

## વિવિધતાઓ અને પુનઃઉપયોગ

```ts
import { PartialType } from "@nestjs/mapped-types";
// derive an UpdateUserDto where all fields are optional — no duplication
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## તે શા માટે મહત્વપૂર્ણ છે

DTOs એક મહત્વપૂર્ણ NestJS પેટર્ન છે જે તમારા અંતબિંદુઓમાં પ્રકારની સુરક્ષા, સ્પષ્ટ API કરાર અને સ્વચાલિત માન્યતા લાવે છે.

તેઓ બરાબર વ્યાખ્યાયિત કરે છે કે અંતબિંદુ કયો ડેટા સ્વીકાર કરે છે (વિનંતીનો આકાર), તમને સંકલન-સમયની ટાઇપિંગ આપે છે અને સ્વ-દસ્તાવેજીય કરારો તરીકે કામ કરે છે.

oncrucially, `class-validator` સજાવટ અને `ValidationPipe` સાથે સંયોજિત, તેઓ **સ્વચાલિત ઇનપુટ માન્યતા** સક્ષમ કરે છે — ખોટી રચના અથવા દૂષણ કરનાર વિનંતીઓ તમારા વ્યવસાય તર્કમાં પહોંચે તે પહેલાં સ્પષ્ટ ભૂલો સાથે અસ્વીકાર કરવામાં આવે છે, જે સુરક્ષા અને મજબૂતાઈ માટે આવશ્યક છે (`whitelist` વિકલ્પ અણધાર્યા ગુણધર્મો પણ દૂર કરે છે).

DTOs સમજવું, માન્યતા નિયમો કેવી રીતે ઉમેરવા, માન્યતા પાઇપ કેવી રીતે સક્ષમ કરવું અને **DTOs ને ડેટાબેસ એન્ટિટીઝથી અલગ રાખવાનું** મહત્વપૂર્ણ સિદ્ધાંત (API કરારને આંતરિક સંગ્રહથી અલગ કરવું) સુરક્ષિત, સુવ્યવસ્થિત, જાળવી શકાય તેવા NestJS APIs બાંધવા માટે મૌલિક છે.

DTOs લગભગ દરેક અંતબિંદુમાં દેખાય છે જે ઇનપુટ સ્વીકાર કરે છે, તેમને દૈનિક, આવશ્યક જ્ઞાન બનાવે છે.