利用Express创建GraphQL HTTP服务器:GraphQL Express Middleware

GraphQL Express Middleware   2015-08-13 08:44:44 发布
您的评价:
     
0.0
收藏     0收藏
文件夹
标签
(多个标签用逗号分隔)
利用Express创建GraphQL HTTP服务器。
npm install --save express-graphql

Install express-graphql as middleware in your express server:

var graphqlHTTP = require('express-graphql');

var app = express();

app.use('/graphql', graphqlHTTP({ schema: MyGraphQLSchema }));

Options

ThegraphqlHTTPfunction accepts the following options:

  • schema: AGraphQLSchemainstance from graphql-js. Aschemamust be provided.

  • rootValue: A value to pass as the rootValue to thegraphql()function from graphql-js.

  • pretty: Iftrue, any JSON response will be pretty-printed.

HTTP Usage

Once installed at a path,express-graphqlwill accept requests with the parameters:

  • query: A string GraphQL document to be executed.

  • variables: The runtime values to use for any GraphQL query variables as a JSON object.

  • operationName: If the providedquerycontains multiple named operations, this specifies which operation should be executed. If not provided, an 400 error will be returned if thequerycontains multiple named operations.

GraphQL will first look for each parameter in the URL's query-string:

/graphql?query=query+getUser($id:ID){user(id:$id){name}}&variables={"id":"4"}

If not found in the query-string, it will look in the POST request body.

If a previous middleware has already parsed the POST body, therequest.bodyvalue will be used. Use multer or a similar middleware to add support formultipart/form-datacontent, which may be useful for GraphQL mutations involving uploading files.

If the POST body has not yet been parsed, graphql-express will interpret it depending on the provided Content-Type header.

  • application/json: the POST body will be parsed as a JSON object of parameters.

  • application/x-www-form-urlencoded: this POST body will be parsed as a url-encoded string of key-value pairs.

  • application/graphql: The POST body will be parsed as GraphQL query string, which provides thequeryparameter.

Advanced Options

In order to support advanced scenarios such as installing a GraphQL server on a dynamic endpoint or accessing the current authentication information, graphql-express allows options to be provided as a function of each express request.

This example uses express-session to run GraphQL on a rootValue based on the currently logged-in session.

var session = require('express-session');
var graphqlHTTP = require('express-graphql');

var app = express();

app.use(session({ secret: 'keyboard cat', cookie: { maxAge: 60000 }}));

app.use('/graphql', graphqlHTTP(request => ({
  schema: MySessionAwareGraphQLSchema,
  rootValue: request.session
})));

项目主页:http://www.open-open.com/lib/view/home/1439378757489

扩展阅读

JavaScript 开发者必备的资源合集
阿里技术文章分享:Node.js 服务端实践之 GraphQL 初探
GraphQL的简单JavaScript客户端:lokka
Express框架入门:初级篇
Node.js Web框架之Express

为您推荐

详解Jquery中DOM操作
HTML5 CSS3专题 纯CSS打造相册效果
实用的Json工具类(Gson)
jQuery入门笔记之(一)选择器引擎
CSS基础语法和选择器的使用

更多

GraphQL Express Middleware
Web服务器
相关文档  — 更多
相关经验  — 更多
相关讨论  — 更多