当前位置：首页 > 软件库 > 大数据 > 数据查询 >

graphql-api

Write type-safe GraphQL services in Haskell

授权协议 View license

开发语言 Java

所属分类大数据、数据查询

软件类型开源软件

地区不详

投递者禹昊穹

操作系统跨平台

开源组织无

适用人群未知

软件概览

graphql-api

graphql-api helps you implement a robust GraphQL API in Haskell. By the time a query makes it to your handler you are dealing with strong, static types that make sense for your problem domain. All your handlers are normal Haskell functions because we derive their type signature from the schema. If you have used servant, this will sound familiar.

The library provides type combinators to create a GraphQL schema, and functions to parse and evaluate queries against the schema.

You can find the latest release on hackage.

We implement the GraphQL specification as best as we can in Haskell. We figure they know what they're doing. Even if an alternative API or behaviour looks nicer, we will defer to the spec.

Tutorial

A simple graphql-api tutorial can be read at readthedocs.io.

To follow along and get your hands dirty, clone this repository, enter the graphql-api root directory, and run:

stack repl tutorial

Example

Say we have a simple GraphQL schema like:

type Hello {
  greeting(who: String!): String!
}

which defines a single top-level type Hello which contains a single field, greeting, that takes a single, required argument who.

We can define this schema in Haskell and implement a simple handler like so:

{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE TypeApplications #-}
{-# LANGUAGE TypeOperators #-}

import Data.Text (Text)
import Data.Monoid ((<>))

import GraphQL
import GraphQL.API
import GraphQL.Resolver (Handler, returns)

type Hello = Object "Hello" '[]
  '[ Argument "who" Text :> Field "greeting" Text ]

hello :: Handler IO Hello
hello = pure (\who -> returns ("Hello " <> who))

run :: Text -> IO Response
run = interpretAnonymousQuery @Hello hello

We require GHC 8.0.2 or later for features like the @Hello type application, and for certain bug fixes. We also support GHC 8.2.

With the code above we can now run a query:

run "{ greeting(who: \"mort\") }"

Which will produce the following GraphQL response:

{
  "data": {
    "greeting": "Hello mort"
  }
}

Status

Our current goal is to gather feedback. We have learned a lot about GraphQL in the course of making this library, but we don't know what a good GraphQL library looks like in Haskell. Please let us know what you think. We won't mind if you file a bug telling us how good the library is.

Because we're still learning, we make no guarantees about API stability, or anything at all really.

We are tracking open problems, missing features & wishlist items in GitHub's issue tracker.

Roadmap

Near future:
- Better error messages (this is really important to us)
- Full support for recursive data types
- Close off loose ends in current implementation & gather feedback
Medium future:
- Full schema validation
- Schema introspection
- Stabilize public API
Long term:
- Derive client implementations from types
- Allow users to implement their own type combinators

References

Copyright

src/GraphQL/Internal/Syntax/AST.hs
src/GraphQL/Internal/Syntax/Encoder.hs
src/GraphQL/Internal/Syntax/Parser.hs

for which see LICENSE.BSD3 in this repository.

使用案例

graphQL的使用

最近一直使用graphQL开发接口，这个真的是很方便，再也不用给前端提供API文档啦。基础知识可以直接上官网https://graphql.cn/上学习一下即可。下面我记录一下，自己使用过程中觉得需要注意的细节。 1、每一个函数必须有输出，可以是对象、数组、字符、布尔值 2、输入参数中，若为必输参数，在参数后加！ 3、GraphQL 支持的指令有两个： @include(
GitHub API实战（包含Graphql API）

GitHub API These days, we need to implement a tool to help our team get access to Github service so that we can analysis some data. When searching github API, we find something interesting and useful.
graphql用法

GraphQL 到底怎么用？看看这个例子就知道了 https://www.infoq.cn/article/i5JMm54_aWrRZcem1VgH
GraphQL相关

GQL是什么 graphQL是由Facebook开发的一种查询语言，用于替换REST Api。可以类比SQL也是一种查询语言。 GQL的好处在客户端需求发生变更的时候，可以不需要通知服务端。理论上服务端可知的字段是大而全的，客户端只需要按照自己的需要去请求对应的字段。多个客户端的请求可以合并为一个，减少网络请求次数 Overview翻译 http://facebook.github.io/gr
Graphql入门_0

GraphQL是一个查询语言，由Facebook开发，用于替换RESTful API。服务端可以用任何的语言实现。具体的你可以查看Facebook关于GraphQL的文档和各种语言的实现 GraphQL的小历史早在2012年，Facebook认为人们只有在离开PC的时候才会用智能手机，很快他们就发现这个认识是多么的错误！于是Facebook把注意力从Web移到了智能终端上。在那个时候，他们严重的
[GraphQL] Query a GraphQL API with graphql-request

To query a GraphQL API, all you need to do is send an HTTP request that includes the query operation in the body of the request. In this lesson, we will use the browser’s fetch method to request the t

graphql-api

graphql-api

Tutorial

Example

Status

Roadmap

References

Copyright

同类工具

相关阅读

相关文章

相关问答

相关文档