内容摘要：系列文章：GraphQL 核心概念 graphql-js 浅尝(本文) 常言道，实践是检验真理的唯一标准。上一篇文章讲了 GraphQL 的核心概念，所提到的一些例子都是理

系列文章：

GraphQL 核心概念 graphql-js 浅尝(本文)

常言道，实现实践是应用举检验真理的唯一标准。

上一篇文章讲了 GraphQL 的实现核心概念，所提到的应用举一些例子都是理论化的，并没有实际代码做支撑，实现就好像在画一个大饼，应用举总是实现让人不那么信服。

它真的应用举有那么神奇吗?那就同我一起看下去，用事实说话。实现

之前那篇文章一直有提到 GraphQL 是应用举一个概念，每个语言可以有自己实现它的实现方式。因为，应用举我是实现搞前端的，对 JavaScript 比较熟悉，应用举所以，实现这里就用 graphql-js(GraphQL 的 JavaScript 实现)来举例。

Hello World

遵循传统，***个例子必须是 Hello World。

首先，安装就不用多说了。站群服务器 

npm install graphql-js --save 

那这个例子该怎么设计哪?假设，查询一个 hello 字符串，就返回一个 world 字符串，很明显 type 的结构就该是这样 

type HelloWorld {  hello: String } 

 如何实现这个 HelloWorld 类型哪?graphql-js 已经定义好了基础类，我们直接调用就行。那么，这个 type 实现起来也就非常简单了

import {      GraphQLString,     GraphQLObjectType, } from graphql; const HelloWorldType = new GraphQLObjectType({      name: HelloWorldType,     fields: () => ({          hello: {              type: GraphQLString,         }     }) }); 

 简单分析一下上面的代码，可以看到 HelloWorldType 是一个 GraphQLObjectType 的实例，它包含一个 fields 是 hello，这个 hello 所对应的返回类型是字符串。

那如何返回 world 字符串?那就给它个 resolve 方法 

const HelloWorldType = new GraphQLObjectType({      name: HelloWorldType,     fields: () => ({          hello: {              type: GraphQLString,             resolve() {                  return world;             },         }     }) }); 

 这样类型就定义好了，还记不记得上篇文章提到的类型定义完成后该怎么办?

对，创建查询的 schema。 

import {      GraphQLString,     GraphQLObjectType,     GraphQLSchema, } from graphql; const HelloWorldType = new GraphQLObjectType({      name: HelloWorldType,     fields: {          hello: {              type: GraphQLString,             resolve() {                  return world;             },         }     } }); const schema = new GraphQLSchema({      query: HelloWorldType }); 

 schema 设置好了，是不是想查询看看哪?

东风当然是服务器啦。GraphQL 官方提供 express-graphql 这个中间件来支持基于 GraphQL 的查询，所以，这里选用 Express 作为服务器。

安装就不再重复了，源码库只需将刚刚建立的 schema 添加到 express 的中间件中就可以了。 

const app = express(); app     .use(/graphql, graphqlHTTP({  schema, pretty: true }))     .listen(3000, () => {          console.log(GraphQL server running on http://localhost:3000/graphql);     }); 

 当当当当~完成，去 Postman 里查询 http://localhost:3000/graphql?query={ hello} 看看吧。

Blog System

在上一篇文章里，我们设计了一个博客的查询 schema，这次我们就来动手实现它。(下面就开始讲例子啦，不愿听我唠叨的可以直接看代码)

前面 HelloWorld 的例子讲的比较详细，现在大家熟悉了语法，接下来的案例就会过得快一些。

首先是 PostType，这里对 Posttype 做了一点小修改，给几个字段添加了不能为空的设计。 

/**  * type Post {   *   id: ID!,  *   name: String!,  *   createDate: String!,  *   title: String!,  *   subtitle: String,  *   content: String,  *   tags: [Tag]  * }  */ const Post = new GraphQLObjectType({      name: PostType,     fields: () => ({          id: {              type: new GraphQLNonNull(GraphQLID)         },         name: {              type: new GraphQLNonNull(GraphQLString)         },         createDate: {              type: new GraphQLNonNull(GraphQLString)         },         title: {              type: new GraphQLNonNull(GraphQLString)         },         subtitle: {              type: GraphQLString         },         content: {              type: GraphQLString         },         tags: {              type: new GraphQLList(TagType),             resolve: post => post.tags.map(tagName => getTagByName(tagName))         }     }) }); 

 然后是另一个主要的 type: Tag type。 

/**  * type Tag {   *   id: ID!,  *   name: String!,  *   label: String!,  *   createDate: String!,  *   posts: [Post]  * }  */ const Tag = new GraphQLObjectType({      name: TagType,     fields: () => ({          id: {              type: new GraphQLNonNull(GraphQLID)         },         name: {              type: new GraphQLNonNull(GraphQLString)         },         label: {              type: new GraphQLNonNull(GraphQLString)         },         createDate: {              type: new GraphQLNonNull(GraphQLString)         },         posts: {              type: new GraphQLList(PostType),             resolve: tag => getPostsList().filter(post => ~post.tags.indexOf(tag.name))         }     }) }); 

 两个主要的类型已经定义好了，把它们俩整合起来就是博客类型了。 

/**  * type Blog {   *   post: Post,    // 查询一篇文章  *   posts: [Post],    // 查询一组文章，用于博客首页  *   tag: Tag,        // 查询一个标签  *   tags: [Tag],    // 查询所有标签，用于博客标签页  * }  */ const BlogType = new GraphQLObjectType({      name: BlogType,     fields: () => ({          post: {              type: PostType,             args: {                  name: {                      type: GraphQLString                 }             },             resolve: (blog, {  name }) => getPostByName(name),         },         posts: {              type: new GraphQLList(PostType),             resolve: () => getPostsList(),         },         tag: {              type: TagType,             args: {                  name: {                      type: GraphQLString                 }             },             resolve: (blog, {  name }) => getTagByName(name),         },         tags: {              type: new GraphQLList(TagType),             resolve: () => getTagsList(),         }     }) }); 

这里有一个新东西，就是高防服务器 arg 字段，用来获取查询参数，如果在没有设置过 arg 字段的属性上添加变量进行查询，graphql-js 的验证系统会报错。

***，将之前的 helloworld 类型稍微修饰一下，独立出来，然后和 blog type 整合到一起成为根查询类。 

const queryType = new GraphQLObjectType({      name: RootQueryType,     fields: () => ({          hello: WorldType,         blog: {              type: BlogType,             resolve: () => ({ })         },     }) }); const schema = new GraphQLSchema({      query: queryType }); 

 OK。这样整个 Demo 就完成了(查看源码戳这里)，快去 Postman 试试各种查询，体验 GraphQL 的神奇吧。(不知道怎么写查询语句的就看上一篇吧)

 ***

如果，你不喜欢 GET 方法或查询字符串过长，express-graphql 也支持 POST 方法，服务器会先查看请求的 URL 中是否包含查询字符串，如果不包含就会去 request body 中获取，只需在 request header 中将 Content-Type 设置为 application/graphql 就可以了。

全文一直在说查询，或许你会疑惑，那我修改怎么做哪?graphql 中的修改称之为 mutation。mutation 可以定义自己的接口解析类，它在 graphql 的 schema 中是一个可选项，其他的和查询并无两样，只是***在 resolve 方法中的处理方式不同而已。 

const schema = new GraphQLSchema({      query: queryType，     mutation: mutationType }); 

 ***的***提一句，nodemon 很好用，谁用谁知道。