Farklı Parse Sürümlerinde GraphQL Sorguları ve Mutasyonları

Parse zaman içinde geliştikçe, bazı yönleri daha iyi performans, daha iyi uyumluluk ve daha kolay geliştirme için değişmektedir.
Bu yönlerden biri de zaman içinde Parse 3.5.0’dan mevcut en son sürüm olan 3.9’a evrilen GraphQL desteğidir.

Back4app’te, özellikle GraphQL sorguları ve mutasyonlarındaki değişiklikleri uygulayan üç ana sürümümüz var: 3.7.2, 3.8 ve 3.9 ve bugün size bu sürümler arasındaki farkları, neyin değişip neyin değişmediğini göstereceğim.

Giriş

Müşterilere uzun vadeli çözümler sunarken evrim zorunludur ve Parse da bir istisna değildir.

GraphQL standartları daha popüler olmaya ve kullanılmaya başladıkça, topluluk daha iyi entegrasyon, basitleştirilmiş kullanım ve sezgisellik talep etti. Parse bakımcıları ve aktif katkıda bulunanlar olarak Back4app bu sesleri duydu ve açık kaynaklı Parse platformunda bu tür sonuçlar elde etmek için çok çaba sarf etti.

Geliştiricilerimiz zaman içinde Cloud Code entegrasyonu gibi yeni işlevler getirdi, ancak topluluk çerçeveler ve platformlar üzerinde daha tutarlı bir GraphQL sözdizimi istemeye devam etti ve Parse 3.9 ile bunu başardık ve topluluğun faydalanması için teslim ettik.

Bu sözdizimi gelişirken, birkaç önemli değişiklik yapıldı, bu nedenle kullandığınız Parse sürümüne bağlı olarak, bunun için doğru sözdizimini seçmelisiniz: 3.7.2, 3.8 ve 3.9 aynı sonuçları elde etmek için biraz farklı sözdizimlerine sahiptir.
Bu nedenle, bu makaleyi yazıyorum, böylece hepsi tek bir yerde belgeleniyor ve bunu yaparken, kullanıcıların Parse’lerini yeni sözdizimi ile birlikte 3.9’a güncellemelerini şiddetle tavsiye ediyorum, şimdiye kadarki en çapraz platform / çapraz çerçeve sözdizimi uyumlu sürümümüz.

Aşağıda size bazı örnekler göstereceğim.

API Sağlığı

API sağlık sorgusu sürümler arasında değişmedi ve sorgulayarak tutarlı bir şekilde çağırabilirsiniz:

bu da sürümler arasında aynı yanıtla sonuçlanacaktır:

Nesne Oluşturma

Bir nesne oluşturmaya yönelik Mutasyon, farklı GraphQL çerçeveleri arasında daha tutarlı olmak için zaman içinde değişti ve Pare sürümünü değiştirmeden önce göz önünde bulundurmanız gereken kırılma değişiklikleri içeriyor.

Genel Mutasyon Kullanma

Parse 3.7.2’de basitçe bir nesne oluşturulmasını isteyebilirdiniz ve sizin için otomatik olarak bir sınıf oluşturulurdu:

Parse 3.8’de, nesneler sorgusu kaldırıldığı için küçük bir değişiklik var, ancak yine de bir nesnenin oluşturulmasını isteyebilirsiniz ve sınıf otomatik olarak oluşturulacaktır:

Ancak Parse 3.9’da, önce sınıfınızı oluşturmanız ve alanlarını açıkça eklemeniz gerekir:

ve ancak o zaman bir nesneyi özel yöntemini kullanarak kaydedebilirsiniz (aşağıda).

Belirli bir yöntem kullanma (Sınıf Mutasyonu)

Belirli yöntemler de (Sınıf yöntemleri, bu durumda bir Sınıf mutasyonu) değişti:

Parse 3.7.2’de öyleydi:

Parse 3.8’de nesneler özelliği kaldırılmıştır:

Ve son olarak Parse 3.9’da ObjectId, standartlara uyabilmesi için id olarak yeniden adlandırıldı:

Nesne Alma

Nesnelerin alınması da daha iyi tutarlılık ve uyumluluk için zaman içinde gelişmiştir.

Genel Sorgu Kullanma

Herhangi bir sınıf için çalışacak genel GET yöntemini kullanarak belirli bir nesneyi almak için Sınıf adını ve Nesne Kimliğini belirtebilirsiniz.

Parse 3.7.2:

Daha sonra, Parse 3.8 daha basit bir çağrıya izin veren nesneleri kaldırdı:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, genel GET yöntemi kaldırıldı ve nesneleri almak için belirli sınıf yöntemini kullanmanız gerekiyor (daha fazlası aşağıda).

Belirli bir yöntem kullanma (Sınıf Sorgusu)

Belirli yöntemler de Parse sürümüne göre değişti.

Parse 3.7.2’de vardı:

Daha sonra, Parse 3.8’de daha kolay arama için objects özelliğini de kaldırdık:

Ve Parse 3.9’da objectId, çerçeveler arasında daha iyi tutarlılık için id ile değiştirildi:

Bir Nesne Bulma

Nesneleri bulmak da daha iyi tutarlılık ve uyumluluk için zaman içinde gelişmiştir.

Genel Sorgu Kullanma

Herhangi bir sınıf için çalışacak genel FIND yöntemini kullanarak nesnelerin bir listesini almak için Sınıf adını belirtebilirsiniz.

Parse 3.7.2:

Daha sonra, Parse 3.8 daha basit bir çağrıya izin veren nesneleri kaldırdı:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, genel yöntem FIND kaldırıldı ve nesneleri almak için belirli sınıf yöntemini kullanmanız gerekir (daha fazlası aşağıda).

Belirli bir yöntem kullanma (Sınıf Sorgusu)

Belirli yöntemler de Parse sürümüne göre değişti.

Parse 3.7.2’de vardı:

Daha sonra, Parse 3.8’de daha kolay arama için objects özelliğini de kaldırdık:

Ve Parse 3.9’da objectId, çerçeveler arasında daha iyi tutarlılık için id ile değiştirildi:

Bir Nesneyi Güncelleme

Daha iyi tutarlılık ve uyumluluk için nesnelerin güncellenmesinin de değişmesi gerekiyordu.

Genel Sorgu Kullanma

Herhangi bir sınıf için çalışacak genel UPDATE yöntemini kullanarak bir nesneyi güncellemek için Sınıf adını ve ObjectID’yi belirtebilirsiniz.

Parse 3.7.2:

Daha sonra, Parse 3.8 daha basit bir çağrıya izin veren nesneleri kaldırdı:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, UPDATE genel yöntemi kaldırıldı ve nesneleri almak için belirli sınıf yöntemini kullanmanız gerekir (daha fazlası aşağıda).

Belirli bir yöntem kullanma (Sınıf Sorgusu)

Belirli yöntemler de Parse sürümüne göre değişti.

Parse 3.7.2’de vardı:

Daha sonra, Parse 3.8’de daha kolay arama için objects özelliğini de kaldırdık:

Ve Parse 3.9’da çağrı 3.8’e benzer şekilde tutuldu, ancak objectId çağrıdaki id olarak yeniden adlandırıldı:

Uygulama Yöntemleri

Uygulama yöntemlerinin değişiklikleri takip etmesi ve yeni standartlara uyması gerekiyordu. Uygulamaya özel Sorgular ve Mutasyonlar da değişti.

Kullanıcı Kaydı

Yeni kullanıcıların kaydedilmesi zaman içinde protokolü takip etti ve buna göre ayarlandı:

Parse 3.7.2:

Daha sonra Parse 3.8 bu çağrıyı devam ettirdi:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, objectId özelliği uyum sağlamak için id olarak değiştirildi:

Kullanıcı Girişi Yapma

Bir kullanıcının oturum açması da aynı şekilde değişti:

Parse 3.7.2:

Daha sonra Parse 3.8 bu çağrıyı devam ettirdi:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, objectId özelliği uyum sağlamak için id olarak değiştirildi:

Oturum Açmış Kullanıcı Alma

Oturum açmış bir kullanıcı hakkında bilgi almak da değişmek zorundaydı. Hala “X-Parse-Session-Token” başlığını o kullanıcı için geçerli bir Oturum Belirteci ile birlikte geçirmeniz gerekiyor, ancak sorgunun kendisi değişti:

Parse 3.7.2:

Daha sonra, Parse 3.8 ME sorgusunu yeni VIEWER biçimine değiştirdi:

Parse 3.8:

Parse 3.9’un gelişiyle birlikte, objectId özelliği uyum sağlamak için id olarak değiştirildi. İhtiyacınız yoksa, sözdizimi 3.8 ile aynıdır:

Sonuç

Parse’ın zaman içinde diğer platformlar ve formatlarla birlikte evrilmesiyle birlikte, Parse’ın geliştirmeyi basitleştirmek ve tutarlılığı ve birlikte çalışabilirliği korumak için değişmeye devam etmesi doğaldı.

Yeni standartlar ortaya çıktıkça, Parse’ın entegre olduğu ana bileşenlerden farklı olmaması için değişiklikler uygulaması gerekiyordu.

Hevesli bir Parse kullanıcısı olarak ben de zaman içinde birkaç değişiklik daha beklerdim. İyi değişiklikler. Mantıklı ve herkesin hedeflerine ulaşmasını sağlayan değişiklikler.

Back4app olarak bu gelişime yardımcı olmaktan gurur duyuyoruz ve GraphQL kullanan herkese Parse’ı GraphQL sorgularınız ve mutasyonlarınızla birlikte 3.9’a güncellemelerini tavsiye ediyoruz. Çok daha tutarlı bir sorgulama dilinden faydalanacaksınız.

Sürüm 4.0 fırında. Ne getirecek?