Unduh ngraphql - Unduh Kode Sumber ngraphql

ngraphql

Kategori lainnya

1.0.0

Unduh

Ngraphql - graphql untuk .net

NGRAPHQL adalah kerangka kerja untuk mengimplementasikan GraphQL API di .NET. Ini menyediakan komponen sisi server dan klien.
Berikut ini adalah gambaran tentang proyek, apa yang berbeda dan mengapa saya membuatnya di tempat pertama.

Fitur

Sesuai dengan spesifikasi GraphQL, edisi Okt 2021.
Model GraphQL didefinisikan menggunakan kelas C# (POCO) polos yang dihiasi dengan beberapa atribut. Tidak seperti solusi graphql .NET lainnya, definisi API berbasis Ngraphql terlihat dan terasa seperti artefak .NET asli - sangat diketik, kompak dan dapat dibaca.
Komponen server dan klien. Asp.net Core -Based HTTP Server Implementasi Mengikuti aturan "Melayani HTTP" standar
Langganan didukung sepenuhnya
Klien GraphQL yang ringan namun mampu-mendukung objek yang sangat tipe untuk data yang dikembalikan. API sisi klien yang mudah untuk berlangganan
Konstruksi Modular - Modul berkode terpisah menentukan bagian -bagian dari skema API graphQL keseluruhan; Modul terdaftar dengan server host GraphQL yang mengimplementasikan API GraphQL.
Mendukung eksekusi paralel permintaan kueri
Metode Sinkronisasi dan Async Resolver
Dukungan introspeksi penuh
Deskripsi Skema secara otomatis diimpor dari komentar XML dalam kode C#
Dukungan penuh untuk fragmen dan arahan standar (@include, @skip, @deprecated)
Skalar kustom di luar kotak (ganda, id, uuid, datetime dll)
Parser kueri yang cepat dan efisien; Kueri Cache - Kueri Parsed disimpan dalam cache untuk digunakan kembali di masa depan dengan variabel input yang berbeda
Fasilitas untuk validasi input dan kegagalan mengembalikan sebagai beberapa kesalahan graphql
Implementasi Batching (Masalah N +1) yang kuat
Integrasi dengan database relasional dan ORM - sampel toko buku menunjukkan server GraphQL di atas aplikasi yang terhubung data, dengan dukungan batching.

Paket dan Komponen

Binari Ngraphql didistribusikan sebagai satu set paket Nuget:

Kemasan	Keterangan
Ngraphql	Kelas dasar dibagikan oleh komponen klien dan server.
Ngraphql.client	Klien GraphQL.
Ngraphql.server	Implementasi Server GraphQL tidak terikat pada protokol transportasi tertentu.
Ngraphql.server.aspnetcore	GraphQL HTTP Server Berdasarkan Asp.Net Core Stack.

Contoh

REPO berisi proyek uji dengan server http: things.graphql.httpserver. Anda dapat meluncurkannya secara langsung sebagai proyek startup di Visual Studio.

Instal GraphQL Playground for Chrome Extension dari Chrome Store, dan luncurkan proyek. Ini akan memulai server web, dan akan membuka halaman taman bermain GraphQL. Masukkan URL berikut sebagai target: http: // localhost: 55571/graphql, dan jalankan kueri sampel: "kueri {things {name tige theflags abcguids}}". Server uji mengimplementasikan API GraphQL tentang hal -hal abstrak, dan itu tidak memiliki makna semantik nyata - ini hanya untuk tujuan pengujian. Tujuan dari aplikasi ini adalah untuk menyediakan sejumlah jenis dan metode yang mencakup banyak aspek protokol GraphQL .

Jalankan tes unit dan lihat banyak contoh permintaan/respons yang digunakan di sana. Tes unit menulis log terperinci saat mereka pergi. Jalankan tes, cari file log di folder bin , dan lihat ke dalam untuk banyak contoh permintaan dan tanggapan GraphQL bersama dengan metrik. Lihat file ini di sini: Unittestslog.

Lihat juga contoh Star Wars dalam repositori GitHub terpisah.

Vita ORM berisi proyek sampel yang mengimplementasikan server GraphQL untuk aplikasi sampel toko buku. Antara lain, ini menunjukkan bagaimana (n+1) masalah dapat ditangani secara efisien secara otomatis oleh ORM yang cukup pintar. Sebagian besar entitas terkait seperti buku.publisher atau buku. Aauthors dimuat secara otomatis oleh ORM.