Bir Rails uygulamasında grafikkl nasıl kurulur?

GraphQL, verileri sorgulamak için daha verimli ve esnek bir yol sunan geleneksel dinlendirici API'lere güçlü bir alternatif olarak ortaya çıkmıştır. Tecrübeli bir Rails satıcısı olarak, GraphQL'i çok sayıda ray uygulamasında uygulama ayrıcalığına sahibim, geliştirme süreci ve son kullanıcı deneyimi üzerindeki dönüştürücü etkiye ilk elden tanık oldum. Bu blog yazısında, bazı en iyi uygulamalar ve hususlar ile birlikte bir Rails uygulamasında GraphQL'in nasıl kurulacağına dair adım adım bir kılavuz paylaşacağım.

Önkoşul

Kurulum işlemine dalmadan önce, makinenize aşağıdakileri yüklediğinizden emin olun:

• Ruby (sürüm 2.5 veya daha yüksek)
• Raylar (sürüm 5.2 veya daha yüksek)
• Paket

1. Adım: Yeni Bir Rails uygulaması oluşturun

Sıfırdan başlıyorsanız, aşağıdaki komutu kullanarak yeni bir Rails uygulaması oluşturun:

Rails Yeni Graphql_Rails_App CD Graphql_rails_app

2. Adım: GraphQL mücevherini ekleyin

Rails uygulamanızda GraphQL kullanmak içinGraphQLGEMTaş. AçTaşEn sevdiğiniz metin düzenleyicinize ve aşağıdaki satırı ekleyin:

Gem 'Graphql'

Sonra koşpaket takımıGEM'i kurmak için.

Adım 3: GraphQL şeması oluşturun

GraphQL şeması, API'nızda bulunan türleri ve işlemleri tanımlar. Temel bir şema oluşturmak için aşağıdaki komutu çalıştırın:

Rails GraphQL üretir: Yükle

Bu komut birGraphQLsenin dizinuygulamadizin, birSchedge.rbdosya. .Schedge.rbDosya, GraphQL şemanızın giriş noktasıdır.

4. Adım: Türleri Tanımla

GraphQL'de türler sorgulanabilecek verileri temsil eder. Özel türleri uygulamanızın modellerine göre tanımlayabilirsiniz. Örneğin, birKullanıcıRails uygulamanızdaki model. Karşılık gelen bir tanımlayabilirsinizUSERTYPEGraphQL şemanızda.

AçApp/grafql/tys/user_type.rbDosya ve aşağıdaki kodu ekleyin:

Modül Türleri Sınıf USERTYPE <Type :: BaseObject Alan: Id, Id, Null: Yanlış Alan: Ad, String, Null: Yanlış Alan: E -posta, Dize, Null: False End

Bu kod birUSERTYPEÜç alanla:İD-isim, Vee -posta.

Adım 5: Sorguları tanımlayın

Sorgular sunucudan veri almak için kullanılır. GraphQL şemanızda özel sorguları tanımlayabilirsiniz. AçApp/grafql/tys/query_type.rbDosya ve aşağıdaki kodu ekleyin:

Modül Türleri Class QueryType <Types :: BaseOBject Alan: Kullanıcılar, [Türler :: USERTYPE], NULL: FALSE DEF Kullanıcı Kullanıcısı

Bu kod birkullanıcılarUygulamadaki tüm kullanıcıların bir listesini döndüren sorgu.

Adım 6: Şemayı güncelleyin

AçApp/Graphql/Schema.rbdosya ve içerdiğinden emin olunQuerytype. Dosya şöyle görünmelidir:

Class ApplicationsChema <Graphql :: Şema Sorgu Türleri :: QueryType End

Adım 7: GraphQL uç noktasını ayarlayın

GraphQL API'nızı erişilebilir hale getirmek için Rails uygulamanızda bir uç nokta ayarlamanız gerekir. Açconfig/roint.rbDosya ve aşağıdaki kodu ekleyin:

Rails.application.routes.draw Do '/Graphql', 'Graphql#Execute' End

O zaman, birGrafqlcontrollerGraphQL isteklerini işlemek için. Aşağıdaki komutu çalıştırın:

Raylar Denetleyici Oluşturun Graphql Yürüt

AçApp/Controller/Graphql_controller.rbDosya ve aşağıdaki kodu ekleyin:

Class GraphQlController <Applicater Def Execute query = params [: query] değişkenler = free_hash (params [: değişkenler]) sonuç = applicationschema.execute JSON: sonuç son özel defa free_hash (ambigouser_param) ambigour_param ne zaman ambigour_param? free_hash (json.parse (belirsiz_param)) else {} Hash, ActionController :: Parametreler Ambigour_Param Nil {} başka argümanerror, "beklenmedik parametre: #{amorthouse_param}" son sonu sonu

Adım 8: GraphQL API'nızı test edin

Gibi araçları kullanabilirsinizGraphiqlGraphQL API'nızı test etmek için. Graphiql, GraphQL API'lerini keşfetmek için bir tarayıcı IDE'dir. Rails uygulamanızda GraphIQL kullanmak için aşağıdaki kodu ekleyin.config/roint.rbdosya:

Rails.env. Graphiql :: Rails :: Engine,: "/Graphiql", grafikql_path: "/grafql" son

Şimdi GraphIQL'e erişebilirsiniz.http: // localhost: 3000/grafiqltarayıcınızda. Sorgular yazabilir ve sonuçları gerçek zamanlı olarak görebilirsiniz.

En iyi uygulamalar ve düşünceler

• Yetkilendirme: Yalnızca doğrulanmış kullanıcıların belirli sorgulara ve mutasyonlara erişebilmesini sağlamak için uygun yetkilendirme mekanizmalarını uygulayın.
• Önbellek: GraphQL API'nizin performansını artırmak için önbellekleme stratejilerini kullanın.
• Hata İşleme: İstemcilere anlamlı hata mesajları sağlamak için sağlam hata işleme uygulayın.

Rails Tekliflerimiz

Bir Rails satıcısı olarak,60E1A1 RAY-İngiliz Standart BSC28 Çelik Rayı, Ve25lb ASCE Çelik Rayı. Bu raylar en yüksek endüstri standartlarını karşılamak için tasarlanmıştır ve çeşitli uygulamalar için uygundur.

Tedarik için bizimle iletişime geçin

Raylarımızı satın almakla ilgileniyorsanız veya Rails uygulamanızda GraphQL kurma hakkında herhangi bir sorunuz varsa, sizden haber almak isteriz. Bir tedarik tartışması başlatmak ve ihtiyaçlarınız için en iyi çözümleri bulmak için bizimle iletişime geçin.

Referanslar

• Rails Belgeleri
• Graphql belgeleri