GraphQL.js ile Başlarken

Önkoşullar

Photo by Dlanor S on Unsplash

Başlamadan önce, yüklü bir Node v6+'ya sahip olmalısınız, örneklerin çoğu önceki Node sürümlerinde çalışmalıdır. Bu kılavuz için, transpilasyon gerektiren herhangi bir dil (TypeScript, CoffeeScript vb.) kullanmayacağız, ancak Promises, Sınıflar ve Fat Arrow Functions gibi ES6 özelliklerini kullanacağız, onlara aşina değilseniz öncelikle bir bakmak isteyebilirsiniz.

Yeni bir proje oluşturmak ve mevcut dizininize GraphQL.js yüklemek için:

npm init
npm install graphql --save

Kod Yazma

GraphQL sorgularını ele almak için, Sorgu (Query) tipi tanımlayan bir şemaya ihtiyacımız var ve her API bitiş noktası için bir “çözümleyici” (resolver) adı verilen bir fonksiyonla bir API köküne ihtiyacımız var. Yalnızca “Hello World!” ifadesini döndüren bir API için şu kodu server.js adlı bir dosyaya koyabiliriz:

var { graphql, buildSchema } = require('graphql');

// Bir şema oluşturun, GraphQL şema dilini kullanarak
var schema = buildSchema(`
  type Query {
    hello: String
  }
`);

// Kök (root) her API bitiş noktası için bir çözümleyici (resolver) sağlar
var root = {
  hello: () => {
    return 'Hello world!';
  },
};

// GraphQL sorgusnu çalıştırın '{ hello }' ve yanıt
graphql(schema, '{ hello }', root).then((response) => {
  console.log(response);
});

Eğer bununla birlikte çalıştırırsan :

node server.js

GraphQL yanıtının yazdırıldığını görmelisiniz:

{ data: { hello: 'Hello world!' } }

Tebrikler, daha demin bir GraphQL sorgusu çalıştırdınız!

Pratik uygulamalar için, bir komut satırı aracı ile GraphQL’i yürütmek yerine muhtemelen bir API sunucusundan GraphQL sorgularını çalıştırmak isteyeceksinizdir. HTTP üzerinden API sunucusu olarak GraphQL’i kullanmak için, Express ile GraphQL Sunucusu Çalıştırma adlı yazıma bakabilirsiniz.