ngraphql

ngraphql - graphql สำหรับ. net

NGRAPHQL เป็นกรอบสำหรับการใช้งาน GraphQL APIs ใน. NET มันมีส่วนประกอบเซิร์ฟเวอร์และฝั่งไคลเอ็นต์
นี่คือภาพรวมของโครงการสิ่งที่แตกต่างและทำไมฉันถึงสร้างมันขึ้นมาตั้งแต่แรก

คุณสมบัติ

• สอดคล้องกับข้อมูลจำเพาะ GraphQL, Oct 2021 Edition
• โมเดล GraphQL ถูกกำหนดโดยใช้คลาส C# (POCO) ที่ตกแต่งด้วยคุณลักษณะบางอย่าง ซึ่งแตกต่างจาก. NET GraphQl Solutions อื่น ๆ คำจำกัดความ API ของ NGRAPHQL -based API นั้นมีลักษณะและความรู้สึกเหมือนสิ่งประดิษฐ์. NET จริง - พิมพ์อย่างมากกะทัดรัดและอ่านได้
• ส่วนประกอบเซิร์ฟเวอร์และไคลเอนต์ การใช้งานเซิร์ฟเวอร์ HTTP ที่ใช้ ASP.NET CORE ตามกฎ "การให้บริการผ่าน HTTP" มาตรฐานมาตรฐาน
• การสมัครสมาชิกได้รับการสนับสนุนอย่างเต็มที่
• ไคลเอนต์ GraphQl น้ำหนักเบา แต่มีความสามารถ-รองรับวัตถุประเภทที่ดีสำหรับข้อมูลที่ส่งคืน API ฝั่งไคลเอ็นต์ง่ายสำหรับการสมัครสมาชิก
• การก่อสร้างแบบแยกส่วน - โมดูลรหัสแยกต่างหากกำหนดส่วนของ schema graphql โดยรวม API; โมดูลจะลงทะเบียนกับเซิร์ฟเวอร์โฮสต์ GraphQL ซึ่งใช้ API GraphQL
• รองรับการดำเนินการตามคำขอแบบสอบถามแบบขนาน
• วิธีการซิงค์และ async ตัวแก้ไข
• การสนับสนุนวิปัสสนาเต็มรูปแบบ
• คำอธิบายสคีมาจะถูกนำเข้าโดยอัตโนมัติจากความคิดเห็น XML ในรหัส C#
• การสนับสนุนอย่างเต็มรูปแบบสำหรับชิ้นส่วนและคำสั่งมาตรฐาน (@include, @skip, @deprecated)
• Scalars ที่กำหนดเองออกจากกล่อง (double, id, uuid, dateTime ฯลฯ )
• ตัวแยกวิเคราะห์แบบสอบถามที่รวดเร็วและมีประสิทธิภาพ แคชคิวรี - คิวรีที่แยกวิเคราะห์จะถูกบันทึกไว้ในแคชสำหรับการนำกลับมาใช้ใหม่ในอนาคตด้วยตัวแปรอินพุตที่แตกต่างกัน
• สิ่งอำนวยความสะดวกสำหรับการตรวจสอบอินพุตและความล้มเหลวในการส่งคืนเป็นข้อผิดพลาด graphQL หลายข้อผิดพลาด
• การใช้งานแบทช์ที่แข็งแกร่ง (ปัญหา N+1)
• การรวมเข้ากับฐานข้อมูลเชิงสัมพันธ์และ ORMS - ตัวอย่างร้านหนังสือแสดงเซิร์ฟเวอร์ GraphQL ที่ด้านบนของแอปพลิเคชันที่เชื่อมต่อข้อมูลพร้อมการสนับสนุนแบบแบทช์

แพ็คเกจและส่วนประกอบ

NGRAPHQL BINARIES มีการแจกจ่ายเป็นชุดของแพ็คเกจ NUGET:

บรรจุุภัณฑ์	คำอธิบาย
ngraphql	คลาสพื้นฐานที่แชร์โดยส่วนประกอบไคลเอนต์และเซิร์ฟเวอร์
ngraphql.client	ไคลเอนต์ GraphQl
ngraphql.server	การใช้งานเซิร์ฟเวอร์ GraphQL ไม่ได้เชื่อมโยงกับโปรโตคอลการขนส่งเฉพาะ
ngraphql.server.aspnetcore	GraphQL HTTP Server ใช้ ASP.NET CORE Stack

ตัวอย่าง

repo มีโครงการทดสอบด้วย HTTP Server: Things.graphql.httpserver คุณสามารถเปิดใช้งานได้โดยตรงเป็นโครงการเริ่มต้นใน Visual Studio

ติดตั้งสนามเด็กเล่น GraphQL สำหรับส่วนขยาย Chrome จาก Chrome Store และเปิดโครงการ มันจะเริ่มต้นเว็บเซิร์ฟเวอร์และจะเปิดหน้าสนามเด็กเล่น GraphQL ป้อน URL ต่อไปนี้เป็นเป้าหมาย: http: // localhost: 55571/graphql และเรียกใช้แบบสอบถามตัวอย่าง: "การสืบค้น {สิ่งต่าง ๆ {ชื่อประเภท Theflags abcguids}}" เซิร์ฟเวอร์ทดสอบใช้ graphQL API เกี่ยวกับ สิ่งที่ เป็นนามธรรมและเป็นโมฆะของความหมายเชิงความหมายที่แท้จริง - มันมีไว้เพื่อการทดสอบเท่านั้น วัตถุประสงค์ของแอพนี้คือการจัดหาประเภทและวิธีการที่ครอบคลุมหลายแง่มุมของโปรโตคอล GraphQL

เรียกใช้ การทดสอบหน่วย และดูตัวอย่างการร้องขอ/การตอบกลับจำนวนมากที่ใช้ที่นั่น การทดสอบหน่วยเขียนบันทึกโดยละเอียดเมื่อไป เรียกใช้การทดสอบค้นหาไฟล์บันทึกในโฟลเดอร์ Bin และดูภายในสำหรับตัวอย่างของคำขอ graphQL และการตอบกลับมากมายพร้อมกับตัวชี้วัด ดูไฟล์นี้ที่นี่: Unittestslog

ดูเพิ่มเติมตัวอย่าง Star Wars ในที่เก็บ GitHub แยกต่างหาก

Vita ORM มีโครงการตัวอย่างที่ใช้เซิร์ฟเวอร์ GraphQL สำหรับแอปพลิเคชันตัวอย่างร้านหนังสือ เหนือสิ่งอื่นใดมันแสดงให้เห็นว่าปัญหา (n+1) สามารถจัดการได้อย่างมีประสิทธิภาพ โดยอัตโนมัติ โดย orm อัจฉริยะ หน่วยงานที่เกี่ยวข้องส่วนใหญ่เช่น Book.Publisher หรือ Book.Authors จะถูกโหลดโดยอัตโนมัติโดย ORM

เอกสาร

ดูหน้า Wiki สำหรับโครงการนี้

ข้อกำหนดของระบบ

.NET มาตรฐาน 2.0, .NET 6/8

graphql อื่น ๆ บน. NET Solutions

• graphql dotnet
• ฮอทโชคาเลต
• tanka graphql