GraphiQL Kullanarak GraphQL Sorguları Nasıl Yazılır?

Adı : GraphiQL Kullanarak GraphQL Sorguları Nasıl Yazılır?

GraphQL, tamamen API'leri yönetmek için kullanılan yeni bir query dili. Bu dilin kullanılması, geleneksel HTTP yöntemleri (GET, POST, vb.) ile karşılaştırıldığında bir dizi avantaj sunmaktadır. GraphQL, istemci tarafından kullanılacak olan veri modelini tamamen tanımlayabileceği için, istemciler kendilerine özgü veri yapıları oluşturmak için kullanabilirler.

Bu nedenle, GraphQL sorguları oluşturmak da oldukça kolaydır ve GraphiQL gibi araçlar, sorguların doğru bir şekilde yapıldığından emin olmak için kullanılır. Bu yazımızda, GraphiQL kullanarak GraphQL sorguları yazmayı öğreneceğiz.

### GraphiQL Nedir?

GraphiQL, GraphQL sorgularını ve mutasyonlarını oluşturmak ve düzenlemek için kullanılan bir araçtır. Bu araç, ücretsiz olarak sunulur ve hemen hemen her modern tarayıcı tarafından desteklenmektedir. Ayrıca, GraphiQL, API'lerinde GraphQL kullanan tüm firmalar tarafından kullanılmaktadır.

GraphiQL, temel olarak, GraphQL sorgularını derleyerek yazılım geliştiricilerinin API'lerini keşfetmelerine izin verir. Ayrıca, bu araç, tanımlanmış bir schema içinde, tüm veri nesnelerini ve bunların birleştirilmesi ile oluşturulmuş complex veri yapılarını gösterir. Bu araç sayesinde geliştiriciler, doğru, güvenli ve verimli bir şekilde API aracılığıyla veri alabilirler.

### GraphQL Sorgu Yapısı

GraphQL sorguları, GraphQL yürütücüsüne gönderilmeden önce yapılır. Bunlar, bir JSON objesi şeklinde tanımlanırlar. Sorgunun ana yönelticisi, bir tür işlev olarak tanımlanır ve tekrar tekrar çağrılabilir. Bu da, ayrı ayrı sorgular yerine birden fazla sorgunun tek bir istekte istenebilmesine olanak tanır.

GraphQL sorguları, üç ana bölümden oluşur:

- **Operation (Operasyon):** Sorgunun neye ulaşmaya çalıştığını açıklar. İki tür operasyon vardır: sorgular ve mutasyonlar.

- **Field (Alan):** Sorgu tarafından istenen verileri belirtir. Bir alan genellikle bir nesne veya listeleri içeren bir nesne tarafından sunulur.

- **Arguments (Argümanlar):** Field'in bir işlevi çağırdığı ve belirli bir değeri elde etmek için beklediği parametrelerdir.

### GraphiQL Kullanarak GraphQL Sorguları Nasıl Yazılır?

GraphiQL, GraphQL sorgularını derleyerek çalıştıran web üzerinden bir araçtır. Bu araç, web tabanlı bir kullanıcı arayüzü sağlar. İşte GraphiQL kullanarak GraphQL sorguları oluşturmak adım adım nasıl yapılır:

#### 1. GraphiQL Arayüzü ve Schema Hakkında Bilgi Edinin

GraphiQL'i ilk açtığınızda, sol tarafta schema navigator bölmesi ve sağ tarafta query editor bölmesi bulunur. Schema navigator, mevcut schema içinde tanımlı olan tüm nesneleri ve bunların birleştirilmesi ile oluşturulmuş veri yapılarını gösterir. Query editor, sorguların ve mutasyonların yazıldığı yerdir.


#### 2. Sorgu Türünü Belirleyin

İlk önce, sorgu türünü belirlemek gerekir. Bunun için, sol alt köşedeki \"query\" veya \"mutation\" seçeneğini tıklamanız gerekir. \"Query\" seçeneği, API'den bilgi getirmek için kullanılırken, \"mutation\" seçeneği API'ye bilgi yüklemek, değiştirmek veya silmek için kullanılır.


#### 3. Alanları Seçin

Sorgulama için gerekli alanları seçmek gerekir. Bunun için schema navigator'a gidin ve istediğiniz nesne veya listedeki alanı seçin.


#### 4. Argümanları Seçme

Alanların argümanları, işlevlerin çağrılmasında kullanılır. Bu argümanlar, int, string, float, enum ve diğerleri gibi veri tiplerinin yanı sıra diğer değişkenler de olabilir.


#### 5. Sorgunuzu Çalıştırın

Sorgunuzu tamamladıktan sonra, sorgunuzu altta bulunan \"run\" düğmesine tıklayarak çalıştırabilirsiniz.


#### 6. Sorgunuzun Sonucunu İnceleyin

Çalıştırdığınız sorgunun sonucu, sağ tarafta bulunan sonuç bölmesinde belirir. Burada, her bir alan ve alanın altında listeleri gösteren verileri görebilirsiniz.


### Örnek Sorgular

GraphiQL kullanarak, birçok örnek sorgu oluşturmak mümkündür. İşte bazı yaygın örnekler:

#### Sadece Bir Alan İsteme

Sadece bir alanı istemek için, şu örnek sorguyu kullanabilirsiniz:

```javascript
query {
person {
name
}
}
```

#### Argümanlar Kullanarak Alan İsteme

Alanları argümanlar kullanarak alma örneği:

```javascript
query {
book(id: \"1\") {
title
author
}
}
```

#### İki Alanı Birlikte İsteme

İki alanı birden istemek istiyoruz:

```javascript
query {
person {
firstName
lastName
age
}
}
```

#### Nesnenin Listelerini Almak

Aşağıda, nesnenin listelerini almak için bir örnek sorgu vardır:

```javascript
query {
characters(pageSize: 3) {
id
name
}
}
```

#### Derinlemesine Nesne İsteği

Derinlemesine bir nesneyi istemek istiyoruz:

```javascript
query {
book(id: \"1\") {
title
author {
firstName
lastName
age
}
}
}
```

### Sık Sorulan Sorular

#### GraphQL'ın Avantajı Nedir?

GraphQL'in en önemli avantajı, API'ler üzerinde veri alımını ve yönetimini kolaylaştırmasıdır. GraphQL, sadece istemcilerin ihtiyaç duyduğu verileri sağlar ve genellikle performansı artırmak için birden fazla veri noktasının kullanılmasını ortadan kaldırır. Ayrıca, istemcilerin özelleştirilmiş bir veri yapısı tanımlamasına olanak tanır.

#### GraphQL, REST API'lerinden Daha İyi mi?

GraphQL, REST API'lerinin birçok dezavantajını ortadan kaldırır. REST API'lerine kıyasla, GraphQL daha esnek, daha ölçeklenebilir ve daha verimlidir. GraphQL, ihtiyaç duyulan tüm verileri birkaç adımda yapabilir ve istekler arasındaki veri boyutunu azaltır.

#### GraphQL, Şifreli Bağlantıları Destekliyor mu?

Evet, GraphQL sunucuları, TCP/IP veya websocket gibi tüm şifreli bağlantı protokollerini destekler.

#### GraphQL, SQL Veri Tabanları İle Nasıl Çalışır?

Bir GraphQL bağlandığında, veri kaynaklarına direkt olarak bağlanır. Bu nedenle, GraphQL'in SQL veritabanları ile çalışması, bağlantıyı sağlamak için gerekli olan bir dizi ara yüz ve yardımcı kodla ilgilenmek zorunda kalabilir.

Bu yazıda, GraphQL sorgularını GraphiQL aracılığıyla nasıl oluşturacağımızı incelemiştik. Ayrıca, özellikle alan seçimi ve argümanlar konusundaki tipik örnekleri de inceledik. GraphQL, API yönetiminde önümüzdeki birkaç yıl için önemli bir role sahip olacak ve GraphiQL, mühendislerin veri alımını kolaylaştırmak için kullanılabilecek temel bir araç."