ngraphql Скачать - ngraphql исходный код скачать

ngraphql

Другие категории

1.0.0

Скачать

Ngraphql - graphql для .net

Ngraphql - это структура для реализации API GraphQL в .NET. Он предоставляет компоненты сервера и клиента.
Вот обзор проекта, что отличается и почему я создал его в первую очередь.

Функции

Соответствует спецификации GraphQL, издание октября 2021 года.
Модель GraphQL определяется с использованием классов Plain C# (POCO), украшенных некоторыми атрибутами. В отличие от других решений .NET GraphQL, NGRAPHQL определения API выглядят и чувствуют себя реальными артефактами .NET - сильно напечатанными, компактными и читаемыми.
Сервер и клиентские компоненты. ASP.NET CORE Реализация HTTP -сервера по стандартному «обслуживанию над HTTP».
Подписки полностью поддерживаются
Легкий, но способный клиент GraphQL-поддерживает объекты крепкого типа для возвращенных данных. Легкий API клиента для подписок
Модульная конструкция - отдельно кодированные модули определяют части общей схемы API GraphQL; Модули зарегистрированы на сервере хоста GraphQL, который реализует API GraphQL.
Поддерживает параллельное выполнение запросов запросов
Синхронизированные и асинхронные методы
Полная поддержка самоанализа
Описания схемы автоматически импортируются из комментариев XML в C# Code
Полная поддержка фрагментов и стандартных директив (@include, @skip, @deprecated)
Пользовательские скаляры из коробки (Double, ID, UUID, DateTime и т. Д.)
Быстрый, эффективный анализатор запросов; Кэш запросов - Проанализированные запросы сохраняются в кэше для повторного использования в будущем с различными входными переменными
Средства для проверки ввода и сбоев возврата в качестве нескольких ошибок GraphQL
Надежная реализация партии (проблема n+1)
Интеграция с реляционными базами данных и ORM - образец книжного магазина показывает сервер GraphQL поверх приложения, подключенного к данным, с поддержкой пакетирования.

Пакеты и компоненты

Двоичные файлы ngraphql распределены как набор пакетов Nuget:

Упаковка	Описание
Ngraphql	Основные классы, разделяемые клиентскими и серверными компонентами.
Ngraphql.client	GraphQL Client.
Ngraphql.server	Реализация GraphQL Server не привязана к конкретному транспортному протоколу.
Ngraphql.server.aspnetcore	Graphql http server на основе стека ASP.NET Core.

Примеры

Repo содержит тестовый проект с HTTP -сервером: things.graphql.httpserver. Вы можете запустить его непосредственно в качестве стартап -проекта в Visual Studio.

Установите Playground GraphQL для расширения Chrome от Chrome Store и запустите проект. Он запустит веб -сервер и откроет страницу GraphQL Playground. Введите следующий URL в качестве цели: http: // localhost: 55571/graphql и запустите образец запроса: «Query {Things {name wind theflags abcguids}}». Тестовый сервер реализует API GraphQL об абстрактных вещах , и он лишен какого -либо реального семантического значения - он предназначен только для цели тестирования. Целью данного приложения является предоставление ряда типов и методов, охватывающих множество аспектов протокола GraphQL .

Запустите модульные тесты и смотрите множество примеров запроса/ответа, используемых там. Модульные тесты пишут подробный журнал по мере их поступления. Запустите тесты, найдите файл журнала в папке Bin и посмотрите внутрь многих примеров запросов и ответов GraphQL вместе с метриками. Смотрите этот файл здесь: Unittestslog.

См. Также пример «Звездных войн» в отдельном репозитории GitHub.

Vita Orm содержит образец проекта, реализующий сервер GraphQL для приложения для книжного магазина. Среди прочего, это показывает, как (n+1) проблема может быть эффективно выполнена автоматически умным ормом. Большинство связанных сущностей, таких как Book.Publisher или Book.Authors автоматически загружаются ORM.