Node.js ile GraphQL API Geliştirme

Adı : Node.js ile GraphQL API Geliştirme

Node.js ile GraphQL API Geliştirme

API'ler (Application Programming Interface), birçok yazılım platformunda kullanılan bir terimdir. API'ler, iki yazılım arasındaki veri akışını sağlar ve üçüncü parti yazılımların kendi sistemlerindeki verileri kullanmasına izin verir. Bu şekilde API'ler, basitçe bir arayüz görevi görür.

Günümüzde API'lerin önemi giderek artıyor ve bu nedenle birçok şirket, API'leri müşterilerine, geliştiricilere ve diğer yazılım firmalarına sunuyor. GraphQL, son yıllarda giderek popüler hale gelen bir API teknolojisidir.

GraphQL, kısaca sorgu dilidir, ancak RESTful API'lerden farklı olarak, her istek için ayrı bir endpoint kullanmak yerine, tek bir endpoint üzerinde verileri yalnızca talep edilen verileri alarak sorgulamanızı sağlar. Bu nedenle GraphQL, daha az veri trafikli bir API sunar ve daha az ağ trafiği gerektirir.

Bu yazıda, Node.js ile nasıl GraphQL API geliştireceğinizi öğreneceksiniz. Ayrıca, GraphQL'in avantajlarına ve uygulamalarına da değineceğiz.

Node.js Nedir?

Node.js, öncelikle sunucu tarafında kullanılan açık kaynaklı bir çerçevedir. JavaScript dili kullanarak sunucuda çalıştırılabilen uygulamaları geliştirmek için tasarlanmıştır. Node.js, JavaScript dilini kullanarak tam bir web uygulaması oluşturmaya olanak tanır. Node.js, yüksek performanslı, ölçeklenebilir ve hızlı bir uygulama sunmayı hedefler.

GraphQL Nedir?

GraphQL, Facebook tarafından geliştirilen, açık kaynaklı bir sorgu dili ve çalışma zamanı ortamıdır. Bu teknoloji, RESTful API'lerle karşılaştırıldığında, daha az veri trafikli bir API sunar. Bu nedenle, GraphQL API'leri, ağda daha düşük trafik ve daha hızlı bir yanıt süresi sunar.

GraphQL API'lerinde, sorgular birçok kaynak için birden fazla istek yapmayı gerektirmez. Bu, tek bir sorgu oluşturarak birden fazla kaynağa erişim sağlamanıza olanak tanır. Bu nedenle, GraphQL API'leri, daha az ağ trafiği gerektirir ve daha hızlı yanıt süreleri sunar.

GraphQL API Geliştirme

GraphQL API geliştirmenin ilk adımı, bir projenin oluşturulmasıdır. Bu yazıda, aşağıdaki gibi bir proje yapısını kullanarak, bir GraphQL API geliştireceğiz.

```
server/
|--- node_modules/
|--- index.js
|--- schema.js
|--- package.json
```

Projeyi oluşturduktan sonra, Node.js kurulumu yapmanız gerekmektedir. Varsayılan olarak, Node.js paket yöneticisi npm paket yöneticisi ile birlikte gelir.

Aşağıdaki kod bloğu, Node.js hizmetimizi başlatmak için gerekli paketlerin kurulumunu ve HTTP sunucusu oluşturma işlemlerini içerir.

```
const express = require('express')
const { graphqlHTTP } = require('express-graphql')
const schema = require('./schema.js')

const app = express()

app.use('/graphql', graphqlHTTP({
schema: schema,
graphiql: true
}))

app.listen(4000, () => {
console.log('Server is running on port 4000...')
})
```

Bu kod bloğu, GraphQL API sunucusu oluşturur. Expres çerçevesi üzerine inşa edilir ve graphqlHTTP işlevini kullanarak GraphQL şemasını gerçekleştirir. Aynı zamanda hizmetimizde GraphiQL arabirimi kullanılabilir.

GraphQL Şeması

GraphQL şeması, API'deki verilerin nasıl saklandığına ve sunulacağına dair önemli bilgileri içeren bir yapıdır. GraphQL şeması, sorgulama ve ayarlama işlemlerini belirlemek için şema tanımlama dili (SDL) kullanır.

Aşağıdaki kod bloğu, GraphQL şemasında neye benzediğini gösterir.

```
const { gql } = require('apollo-server-express')

const typeDefs = gql`
type User {
id: ID!
name: String!
age: Int!
email: String!
}

type Query {
users: [User]!
user(id: ID!): User
}

type Mutation {
addUser(name: String!, age: Int!, email: String!): User!
updateUser(id: ID!, name: String!, age: Int!, email: String!): User!
deleteUser(id: ID!): User!
}
`
```

Bu şemada, User, Query ve Mutation türleri tanımlanır. User türü, bir kullanıcının özelliklerini tanımlar. Query türü, kaynaklarda sorgulamalar gerçekleştirirken kullanılacak işlevleri içerir. Mutation türü, kaynaklarda veri değişiklikleri yapmak için kullanılan işlevleri içerir.

Sorgu ve Mutasyonlar

GraphQL API'lerinin en güçlü yönü, sorgu ve mutasyonları kullanarak veri sorgulama ve değiştirme işlemlerini yürütebilmeleridir. Aşağıdaki kod blokları, bir GraphQL API üzerinde sorgu ve mutasyon örneklerini göstermektedir.

Sorgu:

```
query {
users {
id
name
age
email
}
}
```

Bu sorgu, tüm kullanıcıları getirir.

```
query {
user(id: \"1\") {
name
age
email
}
}
```

Bu sorgu, kullanıcının bilgilerini getirir.

Mutasyon:

```
mutation {
addUser(name: \"John\", age: 30, email: \"john@example.com\") {
id
name
age
email
}
}
```

Bu mutasyon, yeni bir kullanıcı ekler.

```
mutation {
updateUser(id: \"1\", name: \"John Smith\", age: 32, email: \"johnsmith@example.com\") {
id
name
age
email
}
}
```

Bu mutasyon, bir mevcut kullanıcının bilgilerini günceller.

```
mutation {
deleteUser(id: \"1\") {
id
name
age
email
}
}
```

Bu mutasyon, bir mevcut kullanıcıyı siler.

Sık Sorulan Sorular

1. GraphQL nedir?

GraphQL, sorgu dili ve çalışma zamanı ortamıdır. RESTful API'lerle karşılaştırıldığında, daha az veri trafikli bir API sunar.

2. Node.js ve GraphQL birlikte nasıl kullanılır?

Node.js, GraphQL API geliştirme için kullanılan bir ortamdır. Node.js'de GraphQL şeması tanımlayabilir ve sorgu ve mutasyonlar kullanarak verileri işleyebilirsiniz.

3. GraphQL'in avantajları nelerdir?

GraphQL API'leri, daha az veri trafikli bir API sunar ve daha az ağ trafiği gerektirir. Ayrıca, sorgu ve ayarlama işlemleri için tek bir endpoint kullanarak birden fazla kaynağa erişim sağlayabilir.

4. GraphQL ve RESTful API'ler arasındaki fark nedir?

RESTful API'ler, her sorgu için ayrı bir endpoint kullanırken, GraphQL, bir endpoint üzerinden birden fazla kaynağa erişim sağlar. Bu şekilde daha az ağ trafiği gerektirir ve daha az veri gönderilir."