GraphQL ve Apollo sunucu yapılandırma örnekleri, backend geliştiricileri için mükemmel bir kaynak sunar Bu örnekler, API'lerinizi optimize etmenizi, verimliliğinizi artırmanızı ve hatalarla başa çıkmanızı sağlar Bu sayfada, GraphQL ve Apollo sunucu yapılandırma örnekleri hakkında bilgi edinebilir ve projelerinizi daha verimli hale getirebilirsiniz

Bugün web geliştirme dünyasında birçok farklı sunucu teknolojisi var. Bunlardan en popülerlerinden ikisi GraphQL ve Apollo sunucularıdır. Bu yazımızda, GraphQL ve Apollo sunucularının nasıl yapılandırılabileceğini ve farklı örneklerini inceleyeceğiz.

GraphQL sunucu yapılandırması için birkaç farklı yöntem vardır. İlk olarak, Express.js kullanarak sunucu yapılandırabilirsiniz. Bunun için, express-graphql paketini kurmanız ve GraphQL şema yönlendirmesi oluşturmanız gerekir. Bu şekilde, GraphQL sunucunuzu hızlı bir şekilde yapılandırabilirsiniz.

Bunun dışında, Apollo Server ve Yoga gibi GraphQL sunucu çatıları da mevcuttur. Apollo Server, tamamen özelleştirilebilir bir sunucu çatısıdır ve kullanışlıdır. Yoga ise Apollo sunucuları için bir alternatif sunucu çatısıdır. Yoga, Apollo sunucularının özelliklerine ek olarak, REST API'leriyle de çalışabilir.

Apollo sunucu yapılandırması için de birkaç farklı yol vardır. İlk olarak, Apollo Server kullanarak sunucunuzu yapılandırabilirsiniz. Apollo Server, GraphQL sunucularını tasarlama işlemini kolaylaştırır ve birden fazla veritabanı kaynağına bağlanabilirsiniz.

Bunun dışında, Apollo Federation da kullanabilirsiniz. Apollo Federation, birden fazla hizmeti birleştirmenize olanak tanır ve GraphQL şemalarını daha kolay yönetmenizi sağlar. Apollo Studio gibi birçok kullanışlı araç da sağlar.

GraphQL ve Apollo sunucularının yapılandırması için birçok farklı veritabanı yöntemi vardır. En yaygın kullanılanları MongoDB ve MySQL dir. Bunlara bağlanmak için node-mysql ve mongoose paketlerini kullanabilirsiniz. Eğer birçok veritabanına bağlanmanız gerekiyorsa, çoklu veritabanı yapısı kullanabilirsiniz.

Bir örnek olarak, MongoDB ve MySQL veritabanlarının kullanımı için GraphQL ve Apollo sunucularını yapılandırabilirsiniz. Mongoose ile MongoDB'ye bağlanırken, node-mysql paketiyle MySQL veritabanına bağlanabilirsiniz. Veri kaynağı olarak MongoDb ve MySQL kullanarak, verilerinizi daha verimli bir şekilde yönetebilirsiniz.

GraphQL ve Apollo sunucuları, veritabanlarına kolayca bağlanır. Bunun için middleware kullanarak yapılandırabilirsiniz. Node.js'in 'Express' çatısı altında, DataSources kullanarak veri kaynakları ve Apollo Server'ın yeni sürümlerinde middleware kullanarak yapılandırabilirsiniz.

Apollo sunucularının authentication ve authorization yapılandırması için birkaç farklı örnek vardır. En yaygın olanları, JsonWebToken ve Passport kullanımıdır.

JsonWebToken, kullanıcı kimliklerini doğrulamak için kullanılır. Bu, genellikle kullanıcı girişi yaparken kullanılır ve kullanıcıların özel içeriklere erişmesine izin verir.

Passport ise açık kaynaklı bir Node.js kimlik doğrulama kütüphanesidir. Üçüncü taraf hesaplarına (Facebook, Twitter, Google vb.) ve diğer kimlik doğrulama yöntemlerine erişimi kolaylaştırır.

Yukarıdaki örneklerin tümü, GraphQL ve Apollo sunucularının nasıl yapılandırılacağına dair iyi fikirler vermektedir. Bu örnekleri kullanarak, basit bir uygulama tasarlayabilirsiniz. Bu sayede, öğrendiğiniz bilgileri uygulamalı olarak kullanabilirsiniz.

GraphQL Sunucu Yapılandırması

GraphQL, modern web uygulamalarında sık kullanılan bir API teknolojisidir. GraphQL sunucularını yapılandırmak için birkaç yöntem vardır. İlk olarak, Node.js'in kullandığı Express çerçevesi, GraphQL sunucuları için bir HTTP sunucusu olarak ayarlanabilir.

Bunun yanı sıra, Apollo sunucu kütüphanesi de GraphQL sunucularını yapılandırmak için sıklıkla tercih edilen bir yöntemdir. Apollo sunucu, üzerinde çalıştığı Node.js sunucusuna bir GraphQL sunucusu olarak monte edilebilir. Bu sayede, çok sayıda Apollo sunucusu uygulaması geliştirilebilir.

GraphQL SunucuYapılandırması kullanılan kütüphaneler	Özellikleri
Express.js	HTTP sunucusu olarak kullanımı kolaydır ve middleware desteği sunar.
Apollo Sunucu	Gerçek zamanlı güncellemeler, mock veri desteği, kapsamlı araçlar ve daha fazlası için kullanımı kolaydır.

GraphQL sunucularını yapılandırmak için başka bir yöntem de schema-first yaklaşımıdır. Bu yaklaşım, şema tanımlarının önceden belirlendiği bir tasarım anlamına gelir. Tasarım belgelerini, OpenAPI yolu kullanarak otomatik olarak inşa edebilen Apollo Studio ve birkaç GraphQL tasarım aracı mevcuttur.

• Express.js kullanarak GraphQL Sunucu yapılandırma örnekleri mevcuttur.
• Apollo Sunucu kullanarak GraphQL Sunucu yapılandırma örnekleri mevcuttur.
• Schema-First yaklaşımına göre GraphQL Sunucu yapılandırma örnekleri mevcuttur.

Bütün bu yöntemler sayesinde, yüksek performanslı ve etkili bir GraphQL sunucusu inşa etmek oldukça kolaydır. Farklı özellik ve gereksinimlere sahip birçok uygulama geliştirildiğinden, seçim yapmadan önce ihtiyaç duyduğunuz özellikleri dikkate alarak en uygun yapılandırma yöntemini seçmelisiniz.

Apollo Sunucu Yapılandırması

Apollo sunucuları, GraphQL API'lerini oluşturmanızı sağlayan açık kaynaklı bir platformdur. Apollo sunucularının yapılandırılması, birkaç farklı yöntem kullanılarak gerçekleştirilebilir. Bunlardan biri olan schema-first yaklaşımı, şema oluşturma işleminin API tasarımının ilk adımı olarak yapılmasına olanak tanır. Bu yöntemi kullanarak, şemaların tanımlanması, daha sonra şemalara uygun olarak API kodlarının yazılması işlemi gerçekleştirilir.

Başka bir yöntem ise code-first olarak adlandırılan yaklaşımdır. Bu yaklaşım, bir veritabanı şeması veya bir GraphQL şeması üzerinde çalışmak yerine, sunucu kodu yazmanıza olanak sağlar. Apollo sunucularının yapılandırılmasında başka bir yöntem ise, GraphQL Code Generator kullanmaktır. Bu yöntem, sunucu kodunun hızla ve otomatik olarak oluşturulmasını sağlar.

• Apollo sunucularının yapılandırılması için kullanılabilecek farklı yöntemler şunlardır:
• Schema-first yaklaşımı
• Code-first yaklaşımı
• GraphQL Code Generator kullanımı

Apollo sunucuları, yapılandırmalarını gerçekleştirmek için middleware kullanmayı desteklemektedir. Middleware kullanımı, özelleştirilebilir bir mimariye sahip olmanızı sağlayarak, tek bir noktadan birden fazla işlem yapmanıza olanak tanır. Bazı örnek middleware'ler, loglama, hata yönetimi ve authentication/authorization işlemlerini gerçekleştirmek üzere tasarlanmıştır.

Middlware	İşlevi
apollo-server-express	Express tabanlı Apollo sunucuları için middleware
apollo-server-hapi	Hapi tabanlı Apollo sunucuları için middleware
apollo-server-koa	Koa tabanlı Apollo sunucuları için middleware
apollo-server-fastify	Fastify tabanlı Apollo sunucuları için middleware

Çoklu Veritabanı Yapılandırması Örneği

GraphQL ve Apollo sunucularının yapılandırılması hakkında birçok örnek varken, çoklu veritabanı yapısını kullanarak örnekler çoğaltılabilirdi. Buna göre, GraphQL ve Apollo sunucularının yapılandırması için çoklu veritabanı örneği hakkında daha fazla bilgi edinelim.

Bu örnekte, GraphQL ve Apollo sunucularının yapılandırması için birden fazla veritabanı kullanılabilir. Örneğin, bir projenin bir veritabanında kullanıcı bilgilerini saklamak ve diğer veritabanında tüm diğer verileri tutmak mümkündür.

Bu yapılandırmayı gerçekleştirmek için, ilk olarak Apollo sunucusunda schema tanımlamak gereklidir. Schema tanımlandıktan sonra Apollo sunucusu, veritabanı bağlantısını mümkün kılacak datasource'ları tanımlar. Tüm datasource'lar birleştirildiğinde, Apollo sunucusunun birleşik bir schema'ya sahip olması sağlanır.

Apollo sunucusu birden fazla veritabanını kullanırken, her veritabanı farklı özelliklere sahip olabilir. Bu nedenle, her veritabanı için ayrı datasource tanımlamak gereklidir. Bu, farklı veritabanlarından veri almanın yanı sıra, güncelleme, silme ve değiştirme işlemlerinin yapılabilmesini de mümkün kılar.

Bu yapılandırma aynı zamanda, veritabanı hizmetleri kullanılarak da gerçekleştirilebilir. Örneğin, AWS Lambda kullanarak MongoDB ve MySQL veritabanlarını kullanabilirsiniz. Bu, kolay bir yapılandırma sayesinde iki veritabanına aynı anda erişimin sağlanmasını sağlar.

Görüldüğü gibi, GraphQL ve Apollo sunucularının yapılandırılması için çoklu veritabanı örneği oldukça kullanışlı ve esnek bir yapıya sahip. Bu örnek, verilerin güvenliği ve işlemesi gibi konularda büyük esneklik sağlar.

MongoDB ve MySQL Veritabanı Kullanımı

GraphQL ve Apollo sunucularının verilerini depolamak için MongoDB ve MySQL veritabanlarına bağlanması oldukça yaygın bir yöntemdir. İki veritabanının kullanımı birbirinden farklıdır ve bu nedenle örnek kodlarını inceleyelim.

MongoDB'ye bağlantı yapmak için aşağıdaki adımları izleyebiliriz:

• mongoDB sürücüsünü indirin ve kurun
• mongoose kütüphanesini yükleyin `npm install mongoose`
• mongoose.connect() kullanarak bağlantı yapın

const mongoose = require('mongoose');mongoose.connect('mongodb://localhost/my_database', {useNewUrlParser: true, useUnifiedTopology: true})  .then(() => console.log('MongoDB bağlantısı başarılı.'))  .catch(err => console.log(err));

MySQL'ye bağlantı yapmak için aşağıdaki adımları izleyebiliriz:

• mysql sürücüsünü indirin ve kurun
• mysql kütüphanesini yükleyin `npm install mysql`
• mysql.createConnection() kullanarak bağlantı yapın

const mysql = require('mysql');const connection = mysql.createConnection({  host     : 'localhost',  user     : 'root',  password : '',  database : 'my_database'});connection.connect((error) => {  if (error) {    console.error('MySQL bağlantısı hatası: ' + error.stack);    return;  }  console.log('MySQL bağlantısı başarılı. ' + connection.threadId);});

Her iki örnekte de, yöntem ve veritabanı bağlantı bilgileri farklı olabilir. Bu nedenle, örnek kodların uygun bir şekilde özelleştirilmesi gereklidir. Ayrıca, şifre gibi hassas bilgileri doğrudan kodda saklamak yerine, ayrı bir yapılandırma dosyasında depolamak daha güvenlidir.

Veritabanı Middleware Kullanımı

GraphQL ve Apollo sunucularının veritabanı middleware kullanılarak nasıl yapılandırılabileceğini inceleyelim. Veritabanı middleware'leri, sunucu tarafında verilerin tedarik edilmesine veya üretilmesine yardımcı olan bir yazılım bileşenidir. GraphQL ve Apollo gibi modern sunucular, veritabanı middleware'leri kullanarak yazılım geliştirme sürecini kolaylaştırır.

Veritabanı middleware'leri, dışarıdan gelen verileri kontrol etmek, geçerliliklerini doğrulamak ve kaydedebilmek için tasarlanmıştır. GraphQL ve Apollo sunucuları veri işlemek için middleware'leri kullanırken, gelen verilerin geçerliliği ve doğruluğu konusunda titizlikle kontrol edilir. Bu şekilde güvenli bir veri erişimi elde edilir.

GraphQL ve Apollo sunucularının veritabanı middleware'lerinden en yaygın olanları arasında Prisma, Sequelize ve TypeORM yer alır. Prisma, modern bir veritabanı ORM aracıdır ve GraphQL API'leri oluşturmak ve veritabanı bağlantısı yapmak için kullanılır. Sequelize, belirli veritabanı sistemleriyle çalışmak için kullanılırken, TypeORM birden fazla veritabanı sistemlerinde kullanılabilir.

Veritabanı middleware'lerinin kullanımı, GraphQL ve Apollo sunucularının veri tabanı işlemlerini daha da basitleştirir. Middleware'ler, sunucuların veritabanına bağlanabileceği farklı yollar sunar ve verilerin hızlı ve verimli bir şekilde işlenmesine olanak tanır. Bu nedenle, GraphQL ve Apollo sunucularında veritabanı middleware kullanımı önerilir.

Tablo olarak örnek verilecek olursa, aşağıdaki gibi olabilir:

Veritabanı Middleware	Kullanım Alanı
Prisma	GraphQL ve Apollo sunucularının modern bir veritabanı ORM aracı kullanabilmesi
Sequelize	Belirlenen veritabanı sistemleriyle çalışmak
TypeORM	Birden fazla veritabanı sistemlerinde çalışabilmesi

Authentication ve Authorization Örneği

Apollo sunucularını yapılandırmak için en önemli adımlardan biri authentication ve authorization'ı doğru bir şekilde yapılandırmaktır. Bu işlemi yapmadan önce, kullanıcıların sunucuya erişimi engellenir ve özellikleri kullanamazlar. Bu örnekte, Apollo sunucusu, JsonWebToken ve Passport kullanılarak authentication ve authorization'a nasıl yapılandırılacağı incelenecektir.

Authentication'ın ilk adımı, kullanıcı adı ve şifrenin doğrulanmasıdır. Bu adımın başarılı olması durumunda, kullanıcılara bir token verilirken kullanılabilecek bir özel anahtar (secret key) oluşturulduktan sonra, JsonWebToken kullanılarak token'ın oluşturulması gereklidir. Bir sonraki adım, bu token'ın doğrulanmasıdır. Bu, sunucudan kullanıcının herhangi bir istek atması durumunda gerçekleştirilir.

Öte yandan, Passport kullanarak authorization çok kolay bir işlemdir. Kullanıcının özelliklerini kullanmayı denediği her seferinde önce authCheck fonksiyonu çağrılır. Bu fonksiyon, kullanıcının alanlara erişim izni olup olmadığını kontrol eder. Örneğin, eğer kullanıcının sadece yönetim ekranına giriş yapma izni varsa, bu fonksiyon o iznin var olup olmadığını kontrol eder.

Tabloda görüldüğü gibi, her kullanıcı için belirlenen özellikler, hangi kullanıcının hangi özelliklere erişebileceğine karar vermek için kullanılır. Benzer şekilde, özelliklere erişim kontrolleri, kullanıcıların sunucudan istediği verilere erişmesini sağlayarak gerçekleştirilir.

Kullanıcılar	Özellikler
Admin	Kullanıcıları yönetme
Normal Kullanıcı	Sadece kendi hesabını yönetme
Misafir Kullanıcı	Hiçbir özellik

Yukarıdaki örnekler, Apollo sunucusunun yapılandırılması için oldukça önemlidir. Onları takip ederek, çok daha güvenli ve sıkı bir yapılandırma elde edebilirsiniz. Belirtilen adımları izlerseniz, sunucunuzun üstünde bir güvenlik duvarı inşa edebilirsiniz.

JsonWebToken Kullanımı

Apollo sunucusu için JsonWebToken (JWT) kullanarak authentication ve authorization yapılandırması yapabilirsiniz. Bu yöntem, kullanıcı girişi için bir token oluşturulmasına olanak sağlar. Token, kullanıcının yetkilerini belirleyen bir yapıdadır. Apollo sunucusuna gelen tüm istekler önce authentication middleware tarafından kontrol edilir. Middleware, kullanıcının token'ını doğrular ve eğer token geçerliyse kullanıcının yetkilerini belirler.

Token'ın oluşturulması için, kullanıcı adı ve şifresi gibi bilgiler doğru girildiğinde sunucu üzerinde bir token oluşturulabilir. Bu token kullanıcının kimliğini belirleyen bir anahtar görevi görür ve güvenliği en üst seviyede tutar. Apollo sunucusu oluşturulurken, authentication ve authorization için gerekli paketler kurulmalıdır. Örneğin, apollo-server-express ve jsonwebtoken gibi paketler kurulabilir. Ayrıca, JWT'yi oluşturmak için gerekli anahtarlar ve süreler de belirlenmelidir.

Adım	Açıklama
Adım 1	Apollo sunucu kurulumu yapın
Adım 2	JsonWebToken ve apollo-server-express paketlerini yükleyin
Adım 3	Token'ın oluşturulması için gerekli anahtarları ve süreleri belirleyin
Adım 4	Authentication middleware oluşturun
Adım 5	Authorization middleware oluşturun
Adım 6	Token oluşturma endpoint'ini oluşturun
Adım 7	Bağlantıya yetkilendirilmiş endpoint'leri oluşturun

Bu adımların sonunda, Apollo sunucunuzun JWT kullanarak authentication ve authorization yapılandırması yapılmış olacaktır. Böylelikle, kullanıcılarınızın giriş yapması için bir token oluşturulacak ve bu token ile sunucuya yetkilendirdiğiniz istekler yapılabilecektir. Bu, güvenli bir uygulama yapısının temelini oluşturmaktadır.

Passport Kullanımı

Apollo sunucuları, Passport kullanılarak authentication ve authorization yapılandırılabilir. Passport, Node.js için popüler bir authentication kütüphanesidir ve tüm çeşitli oturum yönetimini ve kullanıcı doğrulamasını kolaylaştırmak için kullanılabilir.

Passport'ın kullanımı, sunduğu çok sayıda authentication stratejisi nedeniyle oldukça esnektir. Örneğin, local authentication, facebook, twitter, google+ gibi birçok stratejiyi destekler.

Passport'ın yapılandırılması aşağıdaki adımları takip eder:

• passport paketinin yüklenmesi
• passport.serializeUser() ve passport.deserializeUser() fonksiyonlarının tanımlanması
• passport.use() fonksiyonunun kullanımı ve authentication stratejisinin belirlenmesi
• passport.authenticate() fonksiyonunun kullanımı

Örneğin, local authentication stratejisi aşağıdaki gibi yapılandırılabilir:

Adım	Kod
1	passport.use(new LocalStrategy( {'\n'} (username, password, done) => {'\n'} {'\n'} } ));
2	passport.serializeUser((user, done) => {'\n'} {'\n'});
3	passport.deserializeUser((id, done) => {'\n'} {'\n'});
4	app.post('/login', passport.authenticate('local', {'\n'}{'\n'}), (req, res) => {'\n'} {'\n'});

Authenication stratejisi belirlendikten sonra, login formu ve logout endpointi yapılandırılabilir. Aynı zamanda, authorization için yetkilendirme kontrolleri de yapılandırılabilir. Passport'ın kullanılması ile, kullanıcı doğrulama ve yetkilendirme işlemleri basitleştirilebilir.

Örnek Uygulama

GraphQL ve Apollo sunucularının yapılandırmasında kullanılabilecek örneklerin detaylı bir şekilde incelendikten sonra, bu örnekleri kullanabileceğimiz basit bir uygulama örneği sunulabilir.

Bu örnek uygulama, farklı birkaç örnek kullanarak oluşturulabilecek bir uygulama. Özellikle, çoklu veritabanı yapılandırması örneği, MongoDB ve MySQL veritabanı kullanımı ve veritabanı middleware kullanımı örnekleri bir arada kullanılabilir.

Bunun yanı sıra, authentication ve authorization örneği için JsonWebToken ve Passport örnekleri de uygulama içerisinde kullanılabilir. Bu sayede, tüm örneklerin bir arada kullanıldığı bir uygulama örneği ortaya çıkabilir.

Uygulama örneğinde aynı zamanda, örneklerin bir arada kullanılmasının nasıl daha verimli ve etkili olabileceği de gösterilebilir. Örneğin, middleware kullanımı ile veritabanı yapılandırması örneği birlikte kullanılarak, yapılandırma süreci daha kısa ve hatasız hale getirilebilir.

Bu örnek uygulama, GraphQL ve Apollo sunucularının yapılandırılması sürecinde kullanılacak farklı örneklerin bir arada kullanımını göstererek, bu süreci daha kolay ve verimli hale getirebilir.