1.介绍

GraphQL官网的介绍如下：

GraphQL 是一个用于 API 的查询语言，是一个使用基于类型系统来执行查询的服务端运行时（类型系统由你的数据定义）。GraphQL 并没有和任何特定数据库或者存储引擎绑定，而是依靠你现有的代码和数据支撑。

一个 GraphQL 服务是通过定义类型和类型上的字段来创建的，然后给每个类型上的每个字段提供解析函数。例如，一个 GraphQL 服务告诉我们当前登录用户是 me，这个用户的名称可能像这样：

type Query {  me: User}type User {  id: ID  name: String}

一并的还有每个类型上字段的解析函数：

function Query_me(request) {  return request.auth.user;}function User_name(user) {  return user.getName();}

一旦一个 GraphQL 服务运行起来（通常在 web 服务的一个 URL 上），它就能接收 GraphQL 查询，并验证和执行。接收到的查询首先会被检查确保它只引用了已定义的类型和字段，然后运行指定的解析函数来生成结果。

例如这个查询：

{  me {    name  }}

会产生这样的JSON结果：

{  "me": {    "name": "Luke Skywalker"  }}

总结来说：GraphQL提供数据的聚合查询。支持哪些数据呢？都列在文档中，下面就是文档信息。

type Query {  me: User}type User {  id: ID  name: String}

文档以类型划分字段，字段支持多种类型。比如Query中的me是支持的一个查询字段，它的类型是User。User这种类型中又有id和name两个字段，id是ID类型，name是String类型。

字段的值由GraphQL服务来提供，需要分别定义字段的获取方式。可以从数据库查询或者程序计算或从其他存储形式获取。GraphQL文档中可以定义很多字段，单个业务查询只需要其中几个时，查询文档就声明需要的字段，GraphQL只会发起声明字段的查询。

2.使用

2.1 声明文档，列出支持的查询字段。Query是查询的入口，那么我们可以查询getUserById，返回值类型是User，参数是id。返回值User类型，包含id，name和location字段。

type Query {  getUserById(id: ID): User}type User {  id: ID  name: String  location: Location}type Location {	id: ID	name: String}

2.2 定义字段的数据获取。需要将数据获取的方法放在带有@Controller注解的Controller类中。数据获取的方法需要使用注解@QueryMapping，参数使用@Argument注解，注解@BatchMapping暂时理解成批量获取子字段。

@Controllerpublic class UserController {    @QueryMapping    public User getUserById(@Argument Integer id) {				//此处的查询参数，id并没有使用，只列举该功能        User user = new User();        user.setName("aaa");        user.setId(1);        return user;    }    @BatchMapping(field = "location", typeName = "User")    public Map<User, Location> getLocation(@Argument List<User> users) {        Location location = new Location();        location.setId(11);        location.setName("location11");        return Map.of(users.get(0), location);    }}

2.3 查询数据。运行GraphQL服务程序，使用graphigl界面访问工具或者访问接口${服务地址}/graphql。

设置查询文档：

{  getUserById(id:1) {    id,    name  }}

查询结果如下：

文档中我们没有查询User类型中的location字段，代码debug可以验证，没有执行location字段的数据获取方法。

全部字段的查询：

{  getUserById(id:1) {    id,    name,    location {      id,      name    }  }}

查询结果：

整体完成了GraphQL中的文档定义，字段数据获取和查询结果。

使用GraphQL服务，我们可以把提供的数据聚合展示出来，对于各种查询需求，或者多端展示不同时，自行组合查询字段完成数据获取，避免了多个接口的定义。