download ngraphql - download de código fonte ngraphql

ngraphql

Outras categorias

1.0.0

Baixar

NGRAPHQL - GraphQL para .NET

O NGRAPHQL é uma estrutura para implementar as APIs grafql no .NET. Ele fornece componentes do lado do servidor e do cliente.
Aqui está uma visão geral do projeto, o que é diferente e por que eu o criei em primeiro lugar.

Características

Specificação em conformidade com o GraphQL, edição de outubro de 2021.
O modelo GraphQL é definido usando as classes simples C# (POCO) decoradas com alguns atributos. Ao contrário de outras soluções .NET GraphQL, as definições de API baseadas em NGRAPHQL parecem e parecem artefatos .NET reais - fortemente digitados, compactos e legíveis.
Componentes de servidor e cliente. Implementação do servidor HTTP baseado em núcleo do ASP.NET, seguindo as regras padrão "Serviço sobre HTTP"
As assinaturas são totalmente suportadas
O cliente GraphQL leve, mas capaz-suporta objetos fortemente do tipo para os dados retornados. API fácil do lado do cliente para assinaturas
Construção modular - Os módulos codificados separadamente definem partes do esquema geral de API GraphQL; Os módulos são registrados no servidor host do GraphQL, que implementa a API do GraphQL.
Suporta a execução paralela de solicitações de consulta
Métodos de resolução de sincronização e assíncrone
Apoio total da introspecção
As descrições de esquema são importadas automaticamente dos comentários XML no código C#
Suporte completo para fragmentos e diretrizes padrão (@include, @skip, @deprecated)
Escalares personalizados fora da caixa (duplo, id, uuid, dateTime etc)
Analisador de consulta rápido e eficiente; Cache de consulta - as consultas analisadas são salvas em cache para reutilização futura com diferentes variáveis de entrada
Instalações para validação de entrada e falhas de retorno como vários erros de graphql
Implementação robusta do lote (N+1 Problem)
Integração com bancos de dados e ORMs relacionais - A amostra da livraria mostra um servidor grafql na parte superior de um aplicativo conectado a dados, com suporte em lote.

Pacotes e componentes

Os binários NgraphQL são distribuídos como um conjunto de pacotes Nuget:

Pacote	Descrição
Ngraphql	Classes básicas compartilhadas pelos componentes do cliente e do servidor.
Ngraphql.client	Cliente grafql.
Ngraphql.server	Implementação do servidor GraphQL não vinculada a um protocolo de transporte específico.
Ngraphql.server.aspnetcore	Servidor GraphQL HTTP com base na pilha Core ASP.NET.

Exemplos

O repo contém um projeto de teste com o servidor http: things.graphql.httpServer. Você pode iniciá -lo diretamente como um projeto de inicialização no Visual Studio.

Instale o Playground GraphQL para Extensão Chrome da Chrome Store e inicie o projeto. Ele iniciará o servidor da Web e abrirá a página do Playground GraphQL. Digite o seguinte URL como o destino: http: // localhost: 55571/grafql e execute uma amostra de consulta: "Query {Things {Nome Kind theflags abcguids}}". O servidor de teste implementa uma API do GraphQL sobre coisas abstratas e é vazia de qualquer significado semântico real - é apenas para fins de teste. O objetivo deste aplicativo é fornecer vários tipos e métodos que abrangem os muitos aspectos do protocolo GraphQL .

Execute os testes de unidade e veja os muitos exemplos de solicitação/resposta usados lá. Os testes de unidade escrevem um log detalhado à medida que avançam. Execute os testes, localize o arquivo de log na pasta Bin e procure por muitos exemplos de solicitações e respostas grafql, juntamente com as métricas. Veja este arquivo aqui: unittestsllog.

Veja também o exemplo de Guerra nas Estrelas em um repositório GitHub separado.

A Vita ORM contém um projeto de amostra implementando um servidor GraphQL para um aplicativo de amostra de livraria. Entre outras coisas, mostra como (n+1) o problema pode ser tratado com eficiência automaticamente por um ORM inteligente o suficiente. A maioria das entidades relacionadas como Book.Publisher ou Book.Authores são carregadas de lotes automaticamente pelo ORM.