คุณสร้าง GraphQL API ด้วย NestJS อย่างไร?

Question

Accepted Answer

NestJS รองรับ **GraphQL** ระดับชั้นนำผ่าน `@nestjs/graphql` (สร้างบน Apollo Server) มันมีแนวทางแบบ **code-first** (นิยาม schema ด้วยคลาสและเดคอเรเตอร์ของ TypeScript แล้ว schema จะถูก generate ให้อัตโนมัติ) ซึ่งเป็นวิธีแบบฉบับ NestJS ที่เข้ากับโมเดล decorator/DI ของ framework

## การตั้งค่า GraphQL (code-first)

```ts
@Module({
  imports: [
    GraphQLModule.forRoot<ApolloDriverConfig>({
      driver: ApolloDriver,
      autoSchemaFile: "schema.gql",   // code-first: auto-generate the schema from classes
      playground: true,                // interactive query explorer in dev
    }),
  ],
})
export class AppModule {}
```

## object type (schema นิยามด้วยเดคอเรเตอร์)

```ts
@ObjectType()                        // a GraphQL type
export class User {
  @Field(() => ID) id: string;
  @Field() name: string;
  @Field() email: string;
  @Field(() => [Post]) posts: Post[];   // related type
}
```

ในแบบ code-first คลาสที่ติดเดคอเรเตอร์ (`@ObjectType`, `@Field`) จะนิยาม schema โดย type ของ TypeScript จะ generate GraphQL schema ให้อัตโนมัติ ทำให้ทั้งสองอย่างซิงค์กัน

## resolver (query และ mutation)

```ts
@Resolver(() => User)
export class UsersResolver {
  constructor(private usersService: UsersService) {}   // DI works as usual

@Query(() => [User])               // a query: returns a list of users
  users() {
    return this.usersService.findAll();
  }

@Query(() => User)
  user(@Args("id") id: string) {     // query with an argument
    return this.usersService.findOne(id);
  }

@Mutation(() => User)              // a mutation: creates a user
  createUser(@Args("input") input: CreateUserInput) {
    return this.usersService.create(input);
  }
}
```

resolver (เหมือน controller แต่สำหรับ GraphQL) นิยาม handler ของ `@Query` และ `@Mutation` โดยส่งต่อไปยัง service ผ่าน DI ซึ่งเป็นแพทเทิร์นเดียวกับ REST controller

## การ resolve field ที่เกี่ยวข้อง (หลีกเลี่ยงปัญหา N+1)

```ts
@ResolveField(() => [Post])         // resolve User.posts on demand
posts(@Parent() user: User) {
  return this.postsService.findByUser(user.id);
}
// ⚠️ for lists, this can cause N+1 queries → use DataLoader to BATCH them
```

`@ResolveField` ทำการ resolve field ที่เกี่ยวข้อง/ซ้อนกันแบบ lazy แต่สำหรับ list มันเสี่ยงต่อ **ปัญหา N+1 query** ซึ่งแก้ได้ด้วยการ batch ของ DataLoader

## ข้อแลกเปลี่ยนระหว่าง GraphQL กับ REST

```text
GraphQL: clients request EXACTLY the fields they need (no over/under-fetching),
         one endpoint, strongly typed, great for complex/nested data & varied clients
REST:    simpler, better HTTP caching, well-understood — fine for straightforward APIs
→ Choose based on needs, not hype. NestJS supports both equally well.
```

## ทำไมจึงสำคัญ

การรองรับ GraphQL ระดับชั้นนำของ NestJS มีค่า เพราะมันนำข้อดีของ GraphQL ได้แก่ การที่ client ดึงข้อมูลได้ตรงตามที่ต้องการเป๊ะ (ขจัดการ over-fetch และ under-fetch), endpoint เดียวที่ strongly-typed และการจัดการข้อมูลที่ซับซ้อน/ซ้อนกันได้ดีเยี่ยม เข้ามาในโมเดลที่คุ้นเคยและมีโครงสร้างของ NestJS

การเข้าใจมันสำคัญสำหรับการสร้าง API สมัยใหม่ โดยเฉพาะแนวทาง **code-first** แบบฉบับ (นิยาม schema ด้วยคลาส TypeScript และเดคอเรเตอร์ `@ObjectType`/`@Field`/`@Resolver` โดย schema ถูก generate อัตโนมัติและซิงค์กันอยู่เสมอ) ซึ่งเข้ากับสถาปัตยกรรม decorator/DI ของ NestJS อย่างเป็นธรรมชาติ resolver ทำงานเหมือน controller ทุกประการ โดยส่งต่อไปยัง service ที่ inject เข้ามา

การรู้วิธีนิยาม type, query, mutation และ field ที่ถูก resolve และการตระหนักถึง **ปัญหา N+1 query** (และ DataLoader ในฐานะทางแก้) สำหรับข้อมูลที่ซ้อนกัน เป็นความรู้ระดับ senior ที่สำคัญ

สำคัญพอกันคือการเข้าใจ **ข้อแลกเปลี่ยนระหว่าง GraphQL กับ REST** เพื่อเลือกแนวทางที่เหมาะสมกับโปรเจกต์ (GraphQL สำหรับความต้องการข้อมูลที่ยืดหยุ่น ซับซ้อน หลาย client; REST สำหรับ API ที่เรียบง่ายกว่าและมี HTTP caching ที่แข็งแรง)

GraphQL เป็นกระบวนทัศน์ API หลัก และการผสานรวมที่สะอาดของ NestJS ทำให้มันเป็นความสามารถที่สำคัญและเกี่ยวข้องบ่อยสำหรับการสร้าง back-end ที่ยืดหยุ่นและมีประสิทธิภาพ