摘要：實踐由于是一種規范，它不是一種實現，如果要自己實現還是比較難的，不用擔心，強大的開源社區已經幫我們準備好了，這就是開源項目。然后執行這樣項目就啟動了，如下圖注這里存在跨域問題，所以服務器端需要使用解決跨域問題，具體看代碼。

讓我們先回顧一下我們現在所使用的API設計風格

優點：靈活、解構
缺點：由于一個endpoint對應一個資源所以需要很多次請求

優點：一次請求、所得即所需
缺點：不夠靈活、高度耦合、很高的維護成本、迭代慢

上面是我們兩種常用的接口方式，兩種都有各自的優缺點，有沒有可以包攬所有優點的方案呢？我們需要一個標準的API層，那這就是GraphQL，請注意GraphQL是一個規范，是由facebook倡導的一個規范，不是一個實現。
GraphQL有下面三個定義：

一個用來描述數據類型和關系的API定義語言

一個可以描述具體需要獲取哪些數據的查詢語言

一個可以resolve到數據單個屬性的可執行模型

GraphQL是長什么樣子的呢？

可能這樣看起來還比較難理解，沒事，我們直接coding。

由于GraphQL是一種規范，它不是一種實現，如果要自己實現還是比較難的，不用擔心，強大的開源社區已經幫我們準備好了，這就是Apollo開源項目。Apollo提供了豐富的后端實現（node支持：express、koa、hapi、restify等框架）和前端（React、RN、Angular、IOS、Android等）實現。官方文檔：http://dev.apollodata.com/too...。下面的實踐都是基于Apollo以nodejs的Express框架來實現的。
Demo代碼：https://github.com/jasondu/ap...

搭建服務器

import express from "express";
import { 
  graphqlExpress, 
  graphiqlExpress, 
} from "apollo-server-express";
import bodyParser from "body-parser";
import schema from "./data/schema";    // 定義GraphQL查詢格式

const GRAPHQL_PORT = 3002;

const graphQLServer = express();

graphQLServer.use("/graphql", bodyParser.json(), graphqlExpress({ schema }));    // 實現GraphQL接口功能
graphQLServer.use("/graphiql", graphiqlExpress({ endpointURL: "/graphql" }));    // 實現GraphQL瀏覽器調試界面

graphQLServer.listen(GRAPHQL_PORT, () => console.log(
  `GraphiQL is now running on http://localhost:${GRAPHQL_PORT}/graphiql`
));

懂Express的童鞋應該都可以看到上面的代碼，我做一下解釋：

apollo-server-express 是由Apollo提供在express環境下實現grapql的庫，這里使用了里面兩個類

graphqlExpress是實現grapql接口功能的類

graphiqlExpress是實現grapql瀏覽器調試界面（An in-browser IDE for exploring GraphQL.）的類，就多了一個“i”，這個調試界面可以在后面看到

schema就是上文講的是定義GraphQL查詢格式的

編寫Schema

讓我們看看Schema.js是怎么寫的

import {
  makeExecutableSchema,
} from "graphql-tools";
import resolvers from "./resolvers";

// 定義schema
const typeDefs = `
type Author {   # 作者的字段有：id，名字，還有 發表的帖子
  id: Int
  firstName: String
  lastName: String
  posts: [Post]
}
type Post {    # 帖子的字段有下面這些，包括 這個帖子是哪個作者寫的
  id: Int
  title: String
  text: String
  views: Int
  author: Author
}
type Query {    # 定義查詢內容
  author(firstName: String, lastName: String): Author # 查詢作者信息
  getFortuneCookie: String
}
`;

const schema = makeExecutableSchema({ typeDefs, resolvers });

export default schema;

這里用到Apollo提供的makeExecutableSchema方法，這個方法是將Schema結構的數據轉換成GraphQLSchema實例。
typeDefs里面定義了三個格式Author,Post,Query，這里Query就是查詢的時候返回的結構，Author,Post是解釋了在Query中的結構類型。
接下來，我們就可以編寫具體的實現了。

編寫Resolvers

const resolvers = {
  Query: {
    author(root, args){    // args就是上面schema中author的入參
      return { id: 1, firstName: "Hello", lastName: "World" };
    },
  },
  Author: {
    // 定義author中的posts
    posts(author){
      return [
        { id: 1, title: "A post", text: "Some text", views: 2},
        { id: 2, title: "Another post", text: "Some other text", views: 200}
      ];
    },
  },
  Post: {
    // 定義Post里面的author
    author(post){
      return { id: 1, firstName: "Hello", lastName: "World" };
    },
  },
};

export default resolvers;

上面這段代碼比較簡單，就不做解釋了。
至此，我們就完成了一個GraphQL服務端的開發，加下來我們npm i & npm start

吶，這樣就啟動啦！打開http://localhost:3002/graphiql就可以看到剛才前面說的graphiql，就是GraphQL瀏覽器調試界面。

graphiql可以支持聯想功能，可以非常快的書寫查詢語句。

使用create-react-app創建一個項目，并且按照Apollo客戶端解決方案庫：react-apollo

create-react-app client & yarn add react-apollo

修改App.js

import React, { Component } from "react";
import logo from "./logo.svg";
import "./App.css";

// -------- 添加內容 -------- //
import {
  ApolloClient,
  ApolloProvider,
  createNetworkInterface,
  gql,
  graphql,
} from "react-apollo";

// 設置接口地址
const networkInterface = createNetworkInterface({ uri: "http://localhost:3002/graphql" });

const client = new ApolloClient({
  networkInterface,
});

const Test = ({ data: { loading, error, author } }) => {
  if (loading) {
    return 
Loading ...
;
  }
  if (error) {
    return 
{error.message}
;
  }

  return (
    
{author.firstName} {author.lastName}
  );
};
// 查詢語句
const query = gql`
  query AuthorQuery {
    author (firstName: "firstName", lastName: "lastName") {
      firstName,
      lastName
    }
  }
`;

const Gtest = graphql(query)(Test);

// -------- 添加內容 -------- //

class App extends Component {
  render() {
    return (
      
        

          

            
            
          
          

            To get started, edit src/App.js and save to reload.
        
        
      
    );
  }
}


export default App;

這里的寫法跟redux類似，使用包裹項目，通過graphql方法將數據注入到組件中。

然后執行yarn start 這樣項目就啟動了，如下圖

注：這里存在跨域問題，所以服務器端需要使用cors解決跨域問題，具體看代碼。

https://dev-blog.apollodata.c...

《Tutorial: How to build a GraphQL server》講解了如何搭建node GraphQL服務器，如何定義schema，還有如何鏈接以前的SQL數據庫，rest等，入門必讀

https://dev-blog.apollodata.c...

《Full-stack React + GraphQL Tutorial》講解如何和客戶端結合起來，還有如果實現ws實時通信等

https://launchpad.graphql.com...

這個是apollo提供的線上編輯器，可以在線上編寫schema和resolve，然后可以下載下來部署

https://www.howtographql.com/

這個網站詳細講解了如何在各種服務器客戶端使用graphql

http://taobaofed.org/blog/201...

《Node.js 服務端實踐之 GraphQL 初探》阿里在15年寫的文章

http://graphql.org/官網