Graphql Tutorials（Episode 01）

1.前言

最近认识到Graphql，它是一个基于DSL的api。我曾接触过一个pos机刷卡系统，它是基于JSON-DSL语言开发的框架，很有趣。可是后来，没有机会深入研究。直到最近我认识了Graphql，所以想深入学习，打算写一个系列完整的posts，记录一下。

2.什么是Graphql

你就可以理解成操作数据的API。

如果你使用过Restful，那么理解Graphql也会相当容易。在Restful中，我们为了查询数据，有可能进行了多次查询才能得到我们想要的数据；也可能查询了一次，但是里面大部分数据都是我们这次查询中不需要的。为了解决上述的问题，Graphql出现了。

它是Facebook于2012年开发的内部系统，于2015年发布面向大众。

3.例子

我们来看看它的样子，感受一下：

Post Request:(很像JSON，但不是)

{
    orders {
        id
        productsList {
            product {
                name
                price
            }
            quantity
        }
        totalAmount
    }
}

Answer:

{
    "data": {
        "orders": [
            {
                "id": 1,
                "productsList": [
                    {
                        "product": {
                            "name": "orange",
                            "price": 1.5
                        },
                        "quantity": 100
                    }
                ],
                "totalAmount": 150
            }
        ]
    }
}

4.Helloword

我们先看一个最简单的例子，对Graphql整体有个认识。目的是让大家认知它大体的样子，以及GraphQL加载的流程。

public class GettingStarted {

    final static Logger logger = LoggerFactory.getLogger(GettingStarted.class);

    public static void main(String[] args) {
        String schema = "type Query{hello: String}";

        SchemaParser schemaParser = new SchemaParser();
        TypeDefinitionRegistry typeDefinitionRegistry = schemaParser.parse(schema);

        RuntimeWiring 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}
    }

}

我们可以看到上面的例子中，第6行，我们定义了schema，如果在项目中，应该是一个schema文件。读取这个schema文件后，进行解析得到TypeDefinitionRegistry。然后是执行时的绑定，RuntimeWiring，也即是客户端发送一个请求“hello”，服务端根据这个请求，应该进行什么样的处理。接下来，用TypeDefinitionRegistry和RuntimeWiring，生成GraphQLSchema，进行生成GraphQL。在第19行中，就是执行请求的部分，最后在21行，将返回结果打印出来。

上面的这段话整理一下，流程如下：

到此为止，我们了解了Graphql的背景，对它有个整体的认识。不要着急，知识一点点学习积累。在下一篇的post中，我会给出更具体的示例。

这篇post代码我放在了Github上：

https://github.com/lihao5257/GraphqlDemo.git     分支是master

参考链接：

https://en.wikipedia.org/wiki/GraphQL