Halo batamdev! Kali ini saya akan membahas bagaimana cara membuat API GraphQL sederhana menggunakan NestJS. Saya akan menjelaskan langkah-langkahnya dengan santai, jadi jika kamu baru mulai belajar GraphQL di NestJS, tenang saja, ini cukup mudah!<h3>1. Persiapan Proyek</h3>Pastikan kamu sudah menginstal Node.js di komputer. Jika belum, silakan unduh dari nodejs.org.Selanjutnya, kita akan menggunakan NestJS CLI untuk membuat proyek baru. Jika kamu belum menginstalnya, jalankan perintah berikut:<pre><code>npm i -g @nestjs/cli</code></pre>Sekarang, buat proyek NestJS baru:<pre><code>nest new nestjs-graphql-demo</code></pre>Saat diminta memilih package manager, kamu bisa memilih npm, yarn atau pnpm, sesuai dengan yang telah di install di laptop atau komputer teman2. Setelah itu, masuk ke dalam folder proyek:<pre><code>cd nestjs-graphql-demo</code></pre><h3>2. Menginstal GraphQL dan Dependencies</h3>NestJS menyediakan package bawaan untuk GraphQL. Jadi, kita perlu menginstal beberapa dependensi terlebih dahulu:<pre><code>npm install @nestjs/graphql @nestjs/apollo graphql @apollo/server</code></pre>Setelah itu, buka file <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">app.module.ts</code> yang ada di dalam folder <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">src</code> dan tambahkan konfigurasi GraphQLModule berikut:<pre><code>import { Module } from '@nestjs/common';
import { GraphQLModule } from '@nestjs/graphql';
import { ApolloDriver, ApolloDriverConfig } from '@nestjs/apollo';
import { join } from 'path';
import { UserModule } from './user/user.module';

@Module({
 imports: [
 GraphQLModule.forRoot&lt;ApolloDriverConfig&gt;({
 driver: ApolloDriver,
 autoSchemaFile: join(process.cwd(), 'src/schema.gql'), // Auto generate schema
 }),
 UserModule, // Module untuk User
 ],
})
export class AppModule {}</code></pre>Dengan <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">autoSchemaFile</code>, kita tidak perlu menulis schema secara manual karena NestJS akan menghasilkannya secara otomatis dari kode yang kita buat.<h3>3. Membuat User Module, Resolver, dan Service</h3>Sekarang kita akan membuat UserModule untuk mengelola data pengguna. Jalankan perintah berikut:<pre><code>nest generate module user
nest generate resolver user
nest generate service user</code></pre>Perintah ini akan membuat folder <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user</code> yang berisi tiga file utama:<ul class="novel-list-disc novel-list-outside novel-leading-3 novel--mt-2 tight" data-tight="true"><li class="novel-leading-normal novel--mb-2"><code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user.module.ts</code></li><li class="novel-leading-normal novel--mb-2"><code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user.resolver.ts</code></li><li class="novel-leading-normal novel--mb-2"><code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user.service.ts</code></li></ul><h3>4. Membuat User DTO (Data Transfer Object)</h3>DTO digunakan untuk validasi data yang dikirim ke GraphQL. Kita buat file baru <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user/dto/create-user.dto.ts</code>:<pre><code>import { Field, InputType } from '@nestjs/graphql';

@InputType()
export class CreateUserDto {
 @Field()
 name: string;

 @Field()
 email: string;
}</code></pre>Selanjutnya, kita buat <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user/user.model.ts</code> didalam folder <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user</code> untuk merepresentasikan User:<pre><code>import { Field, ObjectType } from '@nestjs/graphql';

@ObjectType()
export class User {
 @Field()
 id: number;

 @Field()
 name: string;

 @Field()
 email: string;
}</code></pre><h3>5. Mengimplementasikan Service</h3>Sekarang, buka <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user.service.ts</code> dan tambahkan kode berikut:<pre><code>import { Injectable } from '@nestjs/common';
import { CreateUserDto } from './dto/create-user.dto';
import { User } from './user.model';

@Injectable()
export class UserService {
 private users: User[] = [];

 createUser(createUserDto: CreateUserDto): User {
 const newUser = { id: this.users.length + 1, ...createUserDto };
 this.users.push(newUser);
 return newUser;
 }

 getUsers(): User[] {
 return this.users;
 }
}</code></pre><h3>6. Membuat Resolver GraphQL</h3>Selanjutnya, buka <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">user.resolver.ts</code> dan tambahkan kode berikut:<pre><code>import { Resolver, Query, Mutation, Args } from '@nestjs/graphql';
import { UserService } from './user.service';
import { User } from './user.model';
import { CreateUserDto } from './dto/create-user.dto';

@Resolver(() =&gt; User)
export class UserResolver {
 constructor(private readonly userService: UserService) {}

 @Query(() =&gt; [User])
 getUsers(): User[] {
 return this.userService.getUsers();
 }

 @Mutation(() =&gt; User)
 createUser(@Args('data') data: CreateUserDto): User {
 return this.userService.createUser(data);
 }
}</code></pre><h3>7. Menjalankan Proyek dan Mencoba GraphQL</h3>Sekarang semuanya sudah siap! Jalankan server dengan perintah berikut:<pre><code>npm run start</code></pre>Buka GraphQL Playground di <code class="novel-rounded-md novel-bg-stone-200 novel-px-1.5 novel-py-1 novel-font-mono novel-font-medium novel-text-stone-900" spellcheck="false">http://localhost:3000/graphql</code>, lalu coba query berikut untuk menambahkan user:<pre><code>mutation {
 createUser(data: { name: "Joko", email: "jokorezky@batamdev.org" }) {
 id
 name
 email
 }
}</code></pre>Kemudian, coba ambil semua user yang sudah ditambahkan:<pre><code>query {
 getUsers {
 id
 name
 email
 }
}</code></pre>Jika berhasil, kamu akan melihat daftar user yang telah ditambahkan! Selamat Mencoba!

Membuat API GraphQL Sederhana dengan NestJS