各种语言graph案例代码 - mowatermelon/learn-GraphQL GitHub Wiki

GraphQL 已有多种编程语言支持。下表包含一些流行的服务端框架、客户端库、服务和其他有用的内容。

除了 GraphQL JavaScript 参考实现，还有其他服务端库：

• C# / .NET
• Clojure
• Elixir
• Erlang
• Go
• Groovy
• Java
• JavaScript
• PHP
• Python
• Scala
• Ruby

• graphql-dotnet：.NET 的 GraphQL 实现
• graphql-net：转换 GraphQL 到 IQueryable

一套 Clojure 的 GraphQL 可复用组件，满足 alumbra.spec 规范要求的数据结构。

(require '[alumbra.core :as alumbra]
    '[claro.data :as data])
(def schema
"type Person { name: String!, friends: [Person!]! }
type QueryRoot { person(id: ID!): Person, me: Person! }
schema { query: QueryRoot }")
(defrecord Person [id]
data/Resolvable
(resolve! [_ _]
{:name    (str "Person #" id)
:friends (map ->Person  (range (inc id) (+ id 3)))}))
(def QueryRoot
{:person (map->Person {})
:me     (map->Person {:id 0})})
(def app
(alumbra/handler
{:schema schema
:query  QueryRoot}))
(defonce my-graphql-server
(aleph.http/start-server #'app {:port 3000}))

$ curl -XPOST "http://0:3000" -H'Content-Type: application/json' -d'{
"query": "{ me { name, friends { name } } }"
}'
{"data":{"me":{"name":"Person #0","friends":[{"name":"Person #1"},{"name":"Person #2"}]}}}

一个提供 GraphQL 实现的 Clojure 库。

可以执行一个 hello world GraphQL 查询的 graphql-clj 代码如下：

(def schema "type QueryRoot {
hello: String
}")
(defn resolver-fn [type-name field-name]
(get-in {"QueryRoot" {"hello" (fn [context parent & rest]
"Hello world!")}}
[type-name field-name]))
(require '[graphql-clj.executor :as executor])
(executor/execute nil schema resolver-fn "{ hello }")

• lacinia：一套 GraphQL 规范的完整实现，致力于维护对规范的外部兼容。

• absinthe：Elixir 的 GraphQL 实现。
• graphql-elixir: 一个 Facebook GraphQL 的 Elixir 实现。

• graphql-erlang：Erlang 的 GraphQL 实现。

• graphql-go: 一个 Go/Golang 的 GraphQL 实现。
• graphql-relay-go: 一个用于帮助构建 graphql-go 服务器的 Go/Golang 库，支持 react-relay 。
• neelance/graphql-go：一个活跃的 Golang GraphQL 实现。

核心库 —— GORM GraphQL 库提供了基于你的 GORM 实体来生成 GraphQL schema 的功能。除了能够将域类映射到 GraphQL schema 之外，核心库还提供了通过 schema 的执行来查询、更新和删除数据的“数据访问者”的默认实现。

Grails 插件 —— 作为对核心库的补充，GORM GraphQL Grails 插件能够：

• 提供一个通过 HTTP 来接收和响应 GraphQL 请求的控制器。
• 在启动时使用 spring bean 配置生成 schema，以便于扩展。
• 包含一个在开发环境下默认启用的 GraphiQL 浏览器。这一浏览器可以在 /graphql/browser 下访问。
• 使用 Grails 提供的数据绑定覆盖默认的数据绑定
• 提供一个 特质 以使您更容易对 GraphQL 入口端点进行集成测试

更多信息请查看 文档。

GQL 是一个在 Groovy 中使用 GraphQL 的库。

一个用于构建 GraphQL API 的 Java 库。

可以执行一个 hello world GraphQL 查询的 graphql-java 代码如下：

import graphql.ExecutionResult;
import graphql.GraphQL;
import graphql.schema.GraphQLSchema;
import graphql.schema.StaticDataFetcher;
import graphql.schema.idl.RuntimeWiring;
import graphql.schema.idl.SchemaGenerator;
import graphql.schema.idl.SchemaParser;
import graphql.schema.idl.TypeDefinitionRegistry;
import static graphql.schema.idl.RuntimeWiring.newRuntimeWiring;
public class HelloWorld {
public static void main(String[] args) {
String schema = "type Query{hello: String} schema{query: Query}";
SchemaParser schemaParser = new SchemaParser();
TypeDefinitionRegistry typeDefinitionRegistry = schemaParser.parse(schema);
RuntimeWiring runtimeWiring = newRuntimeWiring()
.type("Query", builder -> builder.dataFetcher("hello", new StaticDataFetcher("world")))
.build();
SchemaGenerator schemaGenerator = new SchemaGenerator();
GraphQLSchema graphQLSchema = schemaGenerator.makeExecutableSchema(typeDefinitionRegistry, runtimeWiring);
GraphQL build = GraphQL.newGraphQL(graphQLSchema).build();
ExecutionResult executionResult = build.execute("{hello}");
System.out.println(executionResult.getData().toString());
// Prints: {hello=world}
}
}

查看 graphql-java 文档 以了解更多信息。

GraphQL 规范的参考实现，设计用于在 Node.js 环境中运行。

如果要在命令行中运行一个 GraphQL.js 的 hello world 脚本：

npm install graphql

然后使用 node hello.js 以运行 hello.js 中的代码：

var { graphql, buildSchema } = require('graphql');
var schema = buildSchema(type Query { hello: String });
var root = { hello: () => 'Hello world!' };
graphql(schema, '{ hello }', root).then((response) => {
console.log(response);
});

基于 Express webserver 服务器的一个 GraphQL API 服务端参考实现，你可以用它结合常规 Express webserver 来运行 GraphQL，也可以作为独立 GraphQL 服务器。

如果要运行 express-graphql 的 hello world 服务器：

npm install express express-graphql graphql

然后使用 node server.js 以运行 server.js 中的代码：

var express = require('express');
var graphqlHTTP = require('express-graphql');
var { buildSchema } = require('graphql');
var schema = buildSchema(type Query { hello: String });
var root = { hello: () => 'Hello world!' };
var app = express();
app.use('/graphql', graphqlHTTP({
schema: schema,
rootValue: root,
graphiql: true,
}));
app.listen(4000, () => console.log('Now browse to localhost:4000/graphql'));

来自于 Apollo 的一套 GraphQL server 包，可用于多种 Node.js HTTP 框架（Express，Connect，Hapi，Koa 等）。

如果要运行 apollo-server-express 的 hello world 服务器：

npm install apollo-server-express body-parser express graphql graphql-tools

然后使用 node server.js 以运行 server.js 中的代码：

var express = require('express');
var bodyParser = require('body-parser');
var { graphqlExpress, graphiqlExpress } = require('apollo-server-express');
var { makeExecutableSchema } = require('graphql-tools');
var typeDefs = [`
type Query {
hello: String
}
schema {
query: Query
}`];
var resolvers = {
Query: {
hello(root) {
return 'world';
}
}
};
var schema = makeExecutableSchema({typeDefs, resolvers});
var app = express();
app.use('/graphql', bodyParser.json(), graphqlExpress({schema}));
app.use('/graphiql', graphiqlExpress({endpointURL: '/graphql'}));
app.listen(4000, () => console.log('Now browse to localhost:4000/graphiql'));

Apollo Server 也支持所有的 Node.js HTTP 服务器框架：Express、Connect、HAPI 和 Koa。

• graphql-php：GraphQL 参考实现的 PHP 移植版本。
• graphql-relay-php：一个用于辅助构建 graphql-php 服务器的库，支持 react-relay。

一个用于构建 GraphQL API 的 Python 库。

如果要运行一个 Graphene hello world 脚本：

pip install graphene

然后使用 python hello.py 以运行 hello.py 中的代码：

import graphene
class Query(graphene.ObjectType):
hello = graphene.String()
def resolve_hello(self, args, context, info):
return 'Hello world!'
schema = graphene.Schema(query=Query)
result = schema.execute('{ hello }')
print(result.data['hello'])

其也有对 Relay、Django、SQLAlchemy 和 Google App Engine 的良好绑定。

一个用于构建 GraphQL API 的 Ruby 库。

如果要使用 graphql-ruby 运行一个 hello world 脚本：

gem install graphql

然后使用 ruby hello.rb 运行 hello.rb 中的代码：

require 'graphql'
QueryType = GraphQL::ObjectType.define do
name 'Query'
field :hello do
type types.String
resolve -> (obj, args, ctx) { 'Hello world!' }
end
end
Schema = GraphQL::Schema.define do
query QueryType
end
puts Schema.execute('{ hello }')

其也有对于 Relay 和 Rails 的良好绑定。

使用的 sangria 的一个 GraphQL schema 以及 hello world 查询：

import sangria.schema._
import sangria.execution._
import sangria.macros._
val QueryType = ObjectType("Query", fields[Unit, Unit](
Field("hello", StringType, resolve = _ ⇒ "Hello world!")
))
val schema = Schema(QueryType)
val query = graphql"{ hello }"
Executor.execute(schema, query) map println

• C# / .NET
• Go
• Java / Android
• JavaScript
• Swift / Objective-C iOS
• Python

• graphql-net-client：基于 .Net 的 GraphQL 客户端基本样例。

• graphql: 一个使用 Go 编写的 GraphQL 客户端实现。

• Apollo Android：一个用于 Android 的 GraphQL 客户端，强类型、带缓存功能，使用 Java 编写。

• Relay ( github) ( npm)：Facebook 的框架，用于构建与 GraphQL 后端交流的 React 应用。
• Apollo Client ( github)：一个强大的 JavaScript GraphQL 客户端，设计用于与 React、React Native、Angular 2 或者原生 JavaScript 一同工作。
• graphql-request：一个简单的弹性的 JavaScript GraphQL 客户端，可以运行于所有的 JavaScript 环境（浏览器，Node.js 和 React Native）—— 基本上是 fetch 的轻度封装。
• Lokka：一个简单的 JavaScript GraphQL 客户端，可以运行于所有的 JavaScript 环境 —— 浏览器，Node.js 和 React Native。
• nanogql：一个使用模板字符串的小型 GraphQL 客户端库。

• Apollo iOS ( github)：一个用于 iOS 的 GraphQL 客户端，返回查询特定的 Swift 类型，与 Xcode 集成后可以分屏显示你的 Swift 源代码和 GraphQL，并能在行内展示验证错误。
• GraphQL iOS：一个用于 iOS 的 Objective-C GraphQL 客户端。

• GQL：一个 Python 中的 GraphQL 客户端。

• graphiql ( npm)：一个交互式的运行于浏览器中的 GraphQL IDE.
• libgraphqlparser：一个 C++ 版 GraphQL 查询语言分析器，提供 C 和 C++ API。
• Graphql Language Service：一个用于构建 IDE 的 GraphQL 语言服务（诊断、自动完成等）的接口。

• Apollo Engine：一个用于监视 GraphQL 后端的性能和使用的服务。
• GraphCMS：一个 BaaS（后端即服务），它为您配置了一个作为内容编辑工具来处理存储数据的 GraphQL 后端。
• Graphcool ( github)：一个 BaaS（后端即服务），它为您的应用程序提供了一个 GraphQL 后端，且具有用于管理数据库和存储数据的强大的 web ui。
• Reindex ( github)：一个 BaaS（后端即服务），它针对使用 React 和 Relay 的应用程序配置了 GraphQL 后端。
• Scaphold ( github)：一个 BaaS（后端即服务），为您的应用程序配置了一个拥有多种不同集成的 GraphQL 后端。
• Tipe ( github)：一个 SaaS（软件即服务）内容管理系统，允许您使用强大的编辑工具创建您的内容，并通过 GraphQL 或 REST API 从任何地方访问它。
• AWS AppSync：完全托管的 GraphQL 服务，包含实时订阅、离线编程和同步、企业级安全特性以及细粒度的授权控制。

• awesome-graphql：一个神奇的社区，维护一系列库、资源等。