Memahami Langganan GraphQL

Selamat datang! Dalam pelajaran ini, kita akan mendalami Langganan GraphQL, iaitu ciri berkuasa untuk kemas kini data masa nyata. Bayangkan anda menerima pemberitahuan serta-merta atau aliran data langsung terus daripada pelayan anda!

Langganan membolehkan klien menerima kemas kini secara automatik apabila data pada pelayan berubah, tanpa perlu sentiasa meminta maklumat baharu.

GraphQL mempunyai tiga jenis operasi utama:

• Pertanyaan: Digunakan untuk mendapatkan data. Anggap ia sebagai permintaan GET.
• Mutasi: Digunakan untuk mengubah suai data (mencipta, mengemas kini, memadam). Seperti POST, PUT, DELETE.
• Langganan: Digunakan untuk melanggan acara masa nyata dan menerima data apabila acara tersebut berlaku.

Setiap satunya mempunyai tujuan tersendiri dalam berinteraksi dengan API anda.

Mengapakah langganan begitu penting? Langganan menyelesaikan masalah memastikan aplikasi klien sentiasa mempunyai data terkini tanpa pengundian berterusan.

• Aplikasi sembang: Mesej baharu muncul serta-merta.
• Papan pemuka langsung: Metrik dikemas kini dalam masa nyata.
• Pemberitahuan: Terima makluman apabila acara berlaku.
• Paparan saham: Lihat perubahan harga dengan serta-merta.

Langganan menyediakan pengalaman pengguna yang lancar dan dinamik.

Tidak seperti pertanyaan dan mutasi, yang merupakan kitaran permintaan/tindak balas tunggal, langganan mewujudkan sambungan berterusan antara klien dengan pelayan.

Apabila klien melanggan, klien menghantar pertanyaan langganan kepada pelayan. Pelayan kemudiannya mengekalkan sambungan ini dan menolak data kepada klien setiap kali acara yang diminta berlaku.

GraphQL Subscriptions terutamanya bergantung pada WebSockets. WebSocket ialah protokol komunikasi yang menyediakan saluran komunikasi dupleks penuh melalui satu sambungan TCP.

Anggaplah ia sebagai jalan dua hala yang sentiasa terbuka, membolehkan kedua-dua klien dan pelayan menghantar mesej kepada satu sama lain pada bila-bila masa, tidak seperti HTTP tradisional yang menggunakan model permintaan-tindak balas.

Sebelum sambungan WebSocket diwujudkan sepenuhnya, permintaan HTTP khas yang dipanggil jabat tangan berlaku.

Klien menghantar permintaan HTTP dengan pengepala "Upgrade". Jika pelayan menyokong WebSockets, pelayan membalas dengan pengepala "Upgrade", lalu menukar protokol daripada HTTP kepada WebSocket. Selepas itu, semua komunikasi berlaku melalui protokol WebSocket.

Berikut ialah kitar hayat yang dipermudah:

1. Sambung: Klien menghantar jabat tangan WebSocket.
2. Langgan: Klien menghantar pertanyaan langganan GraphQL melalui WebSocket.
3. Pencetus Peristiwa: Data berubah pada pelayan, lalu mencetuskan suatu peristiwa.
4. Terbitkan: Pelayan menolak data baharu (muatan) kepada klien yang melanggan.
5. Nyahlanggan/Putuskan Sambungan: Klien menutup langganan atau sambungan.

Dalam skema GraphQL anda, takrifkan langganan menggunakan jenis akar subscription. Seperti query dan mutation, ia menyenaraikan peristiwa masa nyata yang tersedia.

Setiap medan dalam jenis subscription mewakili peristiwa yang boleh dilanggan oleh klien. Medan itu menentukan jenis data yang akan dikembalikan apabila peristiwa berlaku.

Berikut ialah cara anda boleh mentakrifkan langganan untuk komen baharu dalam Bahasa Takrifan Skema (SDL) anda:

type Subscription {
  commentAdded(postId: ID!): Comment!
}

type Comment {
  id: ID!
  content: String!
  author: String
  postId: ID!
}

Klien boleh melanggan commentAdded dengan memberikan postId, lalu menerima objek Comment setiap kali komen baharu disiarkan untuk ID tersebut.

Syabas! Anda telah mempelajari asas GraphQL Subscriptions.

• Ia menyediakan kemas kini data masa nyata.
• Ia menggunakan sambungan berterusan, biasanya WebSockets.
• Ia berbeza daripada pertanyaan dan mutasi.
• Pelayan menolak data kepada klien apabila peristiwa berlaku.

Seterusnya, kita akan mendalami pelaksanaan ciri ini dalam Spring Boot!