Kueri dan Mutasi GraphQL pada Versi Parse yang berbeda

Seiring dengan perkembangan Parse dari waktu ke waktu, beberapa aspeknya berubah demi kinerja yang lebih baik, kompatibilitas yang lebih baik, dan pengembangan yang lebih mudah.
Salah satu aspek ini adalah dukungan GraphQL yang berevolusi dari Parse 3.5.0 dari waktu ke waktu ke versi terbaru yang tersedia, 3.9.

Di sini, di Back4app, kami memiliki tiga versi utama yang mengimplementasikan perubahan dalam kueri dan mutasi GraphQL, khususnya: 3.7.2, 3.8 dan 3.9 dan hari ini saya akan memandu Anda melalui perbedaan di antara versi-versi tersebut, menunjukkan apa yang berubah dan apa yang tidak.

Pendahuluan

Evolusi adalah hal yang wajib dilakukan ketika menerapkan solusi jangka panjang kepada pelanggan dan Parse tidak terkecuali.

Ketika standar GraphQL mulai semakin populer dan digunakan, komunitas menuntut integrasi yang lebih baik, penggunaan yang disederhanakan, dan intuitif. Dan sebagai pengelola Parse dan kontributor aktif, Back4app mendengar suara-suara itu dan berusaha keras untuk mencapai hasil seperti itu di platform Parse sumber terbuka.

Pengembang kami membawa fungsi baru dari waktu ke waktu, seperti integrasi Cloud Code, tetapi komunitas terus meminta sintaksis GraphQL yang lebih konsisten di seluruh kerangka kerja dan platform, dan dengan Parse 3.9 kami mencapainya dan memberikannya kepada komunitas untuk dimanfaatkan.

Sementara sintaks tersebut berevolusi, beberapa perubahan penting telah dibuat, jadi tergantung pada versi Parse yang Anda gunakan, Anda harus memilih sintaks yang tepat untuknya: 3.7.2, 3.8 dan 3.9 memiliki sintaks yang sedikit berbeda untuk mencapai hasil yang sama.
Untuk alasan ini, saya menulis artikel ini, agar Anda memiliki semuanya terdokumentasi di satu tempat dan, sementara saya melakukan itu, saya sangat menyarankan pengguna untuk memperbarui Parse mereka ke 3.9 bersama dengan sintaks yang baru, versi yang paling kompatibel dengan sintaks lintas platform/kerangka kerja.

Di bawah ini saya akan menunjukkan beberapa contoh.

Kesehatan API

Kueri kesehatan API tidak berubah di antara versi-versi yang ada, dan Anda dapat secara konsisten memanggilnya dengan melakukan kueri:

yang akan menghasilkan respons yang sama di antara semua versi:

Membuat Objek

Mutasi untuk membuat sebuah objek berubah dari waktu ke waktu agar lebih konsisten di antara kerangka kerja GraphQL yang berbeda dan termasuk perubahan yang harus Anda pertimbangkan sebelum mengubah versi Pare.

Menggunakan Mutasi Generik

Pada Parse 3.7.2 Anda cukup meminta pembuatan sebuah objek dan sebuah kelas akan secara otomatis dibuat untuk Anda:

Pada Parse 3.8, ada sedikit perubahan karena permintaan objek telah dihapus, tetapi Anda masih bisa meminta pembuatan sebuah objek dan kelas akan dibuat secara otomatis:

Namun, pada Parse 3.9, Anda harus membuat kelas Anda terlebih dahulu, secara eksplisit menambahkan field-fieldnya:

dan baru setelah itu Anda bisa menyimpan objek dengan menggunakan metode khusus (di bawah).

Menggunakan metode khusus (Mutasi Kelas)

Metode spesifik (metode kelas, dalam hal ini, mutasi kelas) juga berubah:

Dalam Parse 3.7.2 adalah:

Pada Parse 3.8, properti objek telah dihapus:

Dan akhirnya pada Parse 3.9, ObjectId diganti namanya menjadi id, agar sesuai dengan standar:

Mendapatkan Objek

Mengambil objek juga telah berevolusi dari waktu ke waktu untuk konsistensi dan kompatibilitas yang lebih baik.

Menggunakan Kueri Umum

Anda dapat menentukan nama Kelas dan ID Objek untuk mengambil objek tertentu, menggunakan metode umum GET, yang dapat digunakan untuk semua kelas.

Parse 3.7.2:

Kemudian, Parse 3.8 menghapus objek-objek yang memungkinkan pemanggilan yang lebih sederhana:

Parse 3.8:

Dengan hadirnya Parse 3.9, metode umum GET telah dihapus dan Anda harus menggunakan metode kelas tertentu untuk mengambil objek (lebih lanjut tentang hal ini di bawah).

Menggunakan metode spesifik (Query Kelas)

Metode spesifik juga berubah sesuai dengan versi Parse.

Pada Parse 3.7.2 kita memiliki:

Kemudian, di Parse 3.8 kami juga menghapus properti objek untuk memudahkan pemanggilan:

Dan pada Parse 3.9, objectId digantikan oleh id untuk konsistensi yang lebih baik di antara framework:

Menemukan Objek

Menemukan objek juga telah berevolusi dari waktu ke waktu untuk konsistensi dan kompatibilitas yang lebih baik.

Menggunakan Query Umum

Anda dapat menentukan nama kelas untuk mengambil daftar objek, menggunakan metode generik FIND, yang dapat digunakan untuk semua kelas.

Parse 3.7.2:

Kemudian, Parser 3.8 menghapus objek-objek yang memungkinkan pemanggilan yang lebih sederhana:

Parse 3.8:

Dengan hadirnya Parse 3.9, metode umum FIND telah dihapus dan Anda harus menggunakan metode kelas tertentu untuk mengambil objek (lebih lanjut tentang hal ini di bawah).

Menggunakan metode spesifik (Query Kelas)

Metode spesifik juga berubah sesuai dengan versi Parse.

Pada Parse 3.7.2 kita memiliki:

Kemudian, di Parse 3.8 kami juga menghapus properti objek untuk memudahkan pemanggilan:

Dan pada Parse 3.9, objectId digantikan oleh id untuk konsistensi yang lebih baik di antara framework:

Memperbarui Objek

Memperbarui objek juga harus berubah untuk konsistensi dan kompatibilitas yang lebih baik.

Menggunakan Query Umum

Anda dapat menentukan nama Class dan ObjectID untuk memperbarui sebuah objek, menggunakan metode umum UPDATE, yang dapat digunakan untuk semua class.

Parse 3.7.2:

Kemudian, Parse 3.8 menghapus objek-objek yang memungkinkan pemanggilan yang lebih sederhana:

Parse 3.8:

Dengan hadirnya Parse 3.9, metode umum UPDATE telah dihapus dan Anda harus menggunakan metode kelas tertentu untuk mengambil objek (lebih lanjut tentang hal ini di bawah).

Menggunakan metode spesifik (Query Kelas)

Metode spesifik juga berubah sesuai dengan versi Parse.

Pada Parse 3.7.2 kita memiliki:

Kemudian, di Parse 3.8 kami juga menghapus properti objek untuk memudahkan pemanggilan:

Dan pada Parse 3.9 pemanggilannya tetap sama dengan 3.8, tetapi objectId diganti namanya menjadi id pada pemanggilannya:

Metode Aplikasi

Metode aplikasi harus mengikuti perubahan dan menyesuaikan diri dengan standar yang baru. Query dan Mutasi yang spesifik untuk Aplikasi juga telah berubah.

Mendaftarkan Pengguna

Mendaftarkan pengguna baru mengikuti protokol dari waktu ke waktu dan menyesuaikannya:

Parse 3.7.2:

Kemudian, Parse 3.8 tetap mempertahankannya:

Parse 3.8:

Dengan hadirnya Parse 3.9, properti objectId berubah menjadi id untuk menyesuaikan:

Memasukkan Pengguna

Masuknya pengguna diubah dengan cara yang sama:

Parse 3.7.2:

Kemudian, Pars 3.8 mempertahankan panggilan tersebut:

Parse 3.8:

Dengan hadirnya Parse 3.9, properti objectId berubah menjadi id untuk menyesuaikan:

Mendapatkan Pengguna yang Masuk

Mengambil informasi tentang pengguna yang login juga harus berubah. Anda masih harus melewatkan header “X-Parse-Session-Token” bersama dengan Token Sesi yang valid untuk pengguna tersebut, tetapi kueri itu sendiri telah berubah:

Parse 3.7.2:

Kemudian, Parse 3.8 mengubah kueri ME ke format VIEWER yang baru:

Parse 3.8:

Dengan hadirnya Parse 3.9, properti objectId berubah menjadi id untuk menyesuaikan. Jika Anda tidak membutuhkannya, sintaksnya sama dengan 3.8:

Kesimpulan

Dengan evolusi Parse bersama dengan platform dan format lain dari waktu ke waktu, wajar jika Parse terus berubah untuk menyederhanakan pengembangan dan menjaga konsistensi dan interoperabilitas.

Ketika standar-standar baru muncul, Parse harus menerapkan perubahan agar tidak berbeda dengan komponen-komponen utama yang diintegrasikannya.

Sebagai pengguna Parse yang rajin, saya sendiri mengharapkan beberapa perubahan lagi dari waktu ke waktu. Perubahan yang bagus. Perubahan yang masuk akal dan memungkinkan semua orang mencapai tujuan mereka.

Kami di Back4app bangga telah membantu evolusi ini dan kami menyarankan semua orang yang menggunakan GraphQL untuk memperbarui Parse ke 3.9 bersama dengan kueri dan mutasi GraphQL Anda. Anda akan mendapatkan keuntungan dari bahasa query yang jauh lebih konsisten.

Versi 4.0 sedang dalam proses. Apa yang akan dibawanya?