NestJS mempunyai sokongan GraphQL kelas pertama melalui @nestjs/graphql (dibina di atas Apollo Server). Ia menawarkan pendekatan code-first (mentakrifkan schema anda dengan kelas dan dekorator TypeScript, schema dijana secara automatik) — cara NestJS yang idiomatik — yang muat dengan model dekorator/DI framework.
({
: [
.<>({
: ,
: ,
: ,
}),
],
})
{}
@ObjectType() // a GraphQL type
export class User {
@Field(() => ID) id: string;
@Field() name: string;
@Field() email: string;
@Field(() => [Post]) posts: Post[]; // related type
}
Dalam code-first, kelas yang didekorasi (@ObjectType, @Field) mentakrifkan schema — jenis TypeScript menjana schema GraphQL secara automatik, mengekalkannya selari.
@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);
}
}
Resolvers (seperti controllers, tetapi untuk GraphQL) mentakrifkan handler @Query dan @Mutation, mewakilkan kepada services melalui DI — corak yang sama seperti controllers REST.
@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 menyelesaikan medan berkaitan/bersarang secara malas — tetapi untuk senarai, ini berisiko menyebabkan masalah query N+1, yang diselesaikan dengan batching DataLoader.
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.
Sokongan GraphQL kelas pertama NestJS adalah berharga kerana ia membawa manfaat GraphQL — client mendapatkan tepat data yang mereka perlukan (menghapuskan over- dan under-fetching), satu endpoint tunggal yang bertaip kuat, dan pengendalian yang sangat baik bagi data kompleks/bersarang — ke dalam model NestJS yang biasa dan berstruktur.
Memahaminya adalah penting untuk membina API moden, teristimewanya pendekatan code-first yang idiomatik (mentakrifkan schema dengan kelas TypeScript dan dekorator @ObjectType/@Field/@Resolver, dengan schema dijana secara automatik dan dikekalkan selari) yang muat secara semula jadi dengan seni bina dekorator/DI NestJS — resolvers berfungsi sama seperti controllers, mewakilkan kepada services yang disuntik.
Mengetahui cara mentakrifkan jenis, queries, mutations, dan medan yang diselesaikan, serta menyedari masalah query N+1 (dan DataLoader sebagai penyelesaiannya) untuk data bersarang, ialah pengetahuan peringkat senior yang utama.
Sama pentingnya ialah memahami pertukaran GraphQL lwn REST untuk memilih pendekatan yang betul bagi sesuatu projek (GraphQL untuk keperluan data yang fleksibel, kompleks, berbilang-client; REST untuk API yang lebih ringkas dengan caching HTTP yang kuat).
GraphQL ialah satu paradigma API utama, dan integrasi bersih NestJS menjadikannya satu keupayaan yang ketara dan kerap relevan untuk membina back-end yang fleksibel dan cekap.