运行一个 Express GraphQL 服务器 | GraphQL

运行 GraphQL 最简单的方法是使用 Express（一个 Node.js 上流行的 web 应用框架）。你需要安装两个依赖库：

npm install express express
-
graphql graphql 
--
save

现在我们来改进 “hello world” 示例，把它从一个只能使用一个查询的简单的脚本变成一个 API 服务器。使用 express 模块来运行一个服务器，然后不再直接调用 graphql 函数进行查询，而是使用 express-graphql 库来构建 GraphQL API 服务器，响应入口端点为 “/graphql” 的 HTTP 请求。

var
 express 
=
 
require
(
'express'
)
;
var
 
{
 graphqlHTTP 
}
 
=
 
require
(
'express-graphql'
)
;
var
 
{
 buildSchema 
}
 
=
 
require
(
'graphql'
)
;
 
var
 schema 
=
 
buildSchema
(
`
  type Query {
    hello: String
  }
`
)
;
 
var
 root 
=
 
{
  hello
:
 
(
)
 
=
>
 
{
    
return
 
'Hello world!'
;
  
}
,
}
;
 
var
 app 
=
 
express
(
)
;
app
.
use
(
'/graphql'
,
 
graphqlHTTP
(
{
  schema
:
 schema
,
  rootValue
:
 root
,
  graphiql
:
 
true
,
}
)
)
;
app
.
listen
(
4000
)
;
console
.
log
(
'Running a GraphQL API server at http://localhost:4000/graphql'
)
;

用以下命令启动该 GraphQL 服务器：

node server
.
js

由于我们对 graphqlHTTP 设置 graphiql: true，你可以使用 GraphiQL 工具来手动执行 GraphQL 查询。若使用浏览器浏览 http://localhost:4000/graphql，你会看到一个界面能让你输入查询语句。它看起来是这样的：

截图显示，向 GraphQL 查询 { hello }，返回结果为 { data: { hello: 'Hello world!' } }。GraphiQL 是一个调试和检测服务器的一个绝佳工具，我们推荐应用在开发阶段时一直使用它。

看到这里，你已学到了如何运行一个 GraphQL 服务器，以及使用 GraphiQL 界面执行查询。接下来学习 从客户端代码中发起 GraphQL 查询。