Graphql Tutorials（Episode 02）

1.前言

我们在上篇已经了解Graphql的使命以及Graphql的概况，接下来，我们跑起来另外一个Helloworld来开启继续学习。

2.Helloworld（使用Graphql 原生API）

这里呢，我们会用Graphql的原生API来搭建helloword

Java 8

SpringBoot

OKTA:洛杉矶的一个公司，为系统提供信息安全验证。

GraphQL Playground: 类似于Postman的工具，这里呢用Postman也可以，但是，我更喜欢GraphQL Playground黑色页面的风格。

Download：https://www.electronjs.org/apps/graphql-playground

 完整Demo的地址：

https://github.com/lihao5257/GraphqlDemo.git     代码在master分支

我们进入正题。首先是schema.graphqls, 里面定义了Graphql API的结构。

# This is a ❤ comment
type Query {
  bookById(id: ID): Book 
  allBooks: [Book]
}

type Book {
  id: ID
  name: String
  pageCount: Int
  author: Author
}

type Author {
  id: ID
  firstName: String
  lastName: String
}

然后我们需要将上述文件进行解析，将解析后的关键字与逻辑的处理进行匹配。

    public void init() throws IOException {
        URL url = Resources.getResource("schema.graphqls");
        String sdl = Resources.toString(url, Charsets.UTF_8);
        GraphQLSchema graphQLSchema = buildSchema(sdl);
        this.graphQL = GraphQL.newGraphQL(graphQLSchema).build();
    }
    // 解析SDL文件，然后，进行属性的绑定。
    private GraphQLSchema buildSchema(String sdl) {
        TypeDefinitionRegistry typeRegistry = new SchemaParser().parse(sdl);
        RuntimeWiring runtimeWiring = buildWiring();
        SchemaGenerator schemaGenerator = new SchemaGenerator();
        return schemaGenerator.makeExecutableSchema(typeRegistry, runtimeWiring);
    }

    private RuntimeWiring buildWiring() {
        return RuntimeWiring.newRuntimeWiring()
            .type(TypeRuntimeWiring.newTypeWiring("Query")    
                    // bookById的查询，与右边的逻辑进行绑定。当API调用bookById这个方法时，程序就知道该如何进行查询了。
                .dataFetcher("bookById", graphQLDataFetchers.getBookByIdDataFetcher()))
            .type(TypeRuntimeWiring.newTypeWiring("Book")
                .dataFetcher("author", graphQLDataFetchers.getAuthorDataFetcher()))
            .type(TypeRuntimeWiring.newTypeWiring("Query")
                .dataFetcher("allBooks", graphQLDataFetchers.getAllBooksDataFetcher()))
            .build();
    }

接下来，我们要编辑与bookById绑定的方法，比如，从DB里查数据，或是从缓存中查找等等。

    public DataFetcher<Object> getBookByIdDataFetcher() {
        return dataFetchingEnvironment -> {
            String bookId = dataFetchingEnvironment.getArgument("id");
            return books
                .stream()
                .filter(book -> book.get("id").equals(bookId))
                .findFirst()
                .orElse(null);
        };
    }

    public DataFetcher<Object> getAuthorDataFetcher() {
        return dataFetchingEnvironment -> {
            Map<String, String> book = dataFetchingEnvironment.getSource();
            String authorId = book.get("authorId");
            return authors
                .stream()
                .filter(author -> author.get("id").equals(authorId))
                .findFirst()
                .orElse(null);
        };
    }

    public DataFetcher<Object> getAllBooksDataFetcher() {
        return dataFetchingEnvironment -> {
            return books;
        };
    }

到这里，我们API编辑的部分就算完成了。主要的流程就是按照上一篇博文中讲解的Graphql初始化流程来的。

大家可以发现，这种原生API的方式，非常的繁琐，我们必须手动地将查询方法（如：bookById）和对应的逻辑（graphQLDataFetchers.getBookByIdDataFetcher()）绑定在一起。这就非常麻烦。为了简化流程，开发者会使用另外一种基于API，它基于原生API，在其基础上进行了包装，让开发者只需要关注于业务。

3.Helloworld（使用GraphQL Java Tools）

demo地址：

https://github.com/lihao5257/GraphqlDemo.git   选择tutorial-graphql-java-tools-hello分支

同样，先是schema.graphqls文件的创建

# This is a ❤ comment
type Book {
  title: String!
  isbn: String!
}

type Query {
  getBook(isbn: String!): Book 
  getAllBooks : [Book]
}

type Mutation {
    createBook(book:BookWrapper):Book
}

input BookWrapper{
    title:String!
    isbn:String!
}

我们接下来要创建Book的模型

public class Book {

    private String title;
    private String isbn;

    public Book(String title, String isbn) {
        this.title = title;
        this.isbn = isbn;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getIsbn() {
        return isbn;
    }

    public void setIsbn(String isbn) {
        this.isbn = isbn;
    }

}

然后，要创建一个Resolver，意思是调用API（如:调用getBook（））时，处理请求的业务逻辑是什么样的。

// 处理查询的方法时，需要继承GraphQLQueryResolver 这个接口
public class BookResolver implements GraphQLQueryResolver {

    static List<Book> books  = null;
    static {
        books   =new ArrayList<Book>();
        books.add(new Book("Harry Porter 1", "1111"));
        books.add(new Book("Harry Porter 2", "2234"));
        books.add(new Book("Harry Porter 3", "2434324"));
        books.add(new Book("Harry Porter 4", "112343211"));
        books.add(new Book("Harry Porter 5", "5646"));
    }

　　 // method名字跟API调用的名字一致，在方法里面写具体业务逻辑即可
    public Book getBook(String isbn) {
        return new Book("Learn GraphQL", "309234324");
    }
    
    public List<Book> getAllBooks() {
        return books;
    }
}

然后，就OK啦，非常的简便。省去了一切非业务的操作。这个处理方法有些像JPA，操作对象的的感觉。至此，我们的helloword完成了。希望大家亲自跑一跑，感受一下。

3.完整demo

这个完成的demo中，有增删改查的完整功能，以及异常处理等操作。大家感兴趣的话，可以看看。

https://github.com/lihao5257/GraphqlDemo.git     graphql-java-tools-full-demo分支

4.小结

Graphql入门基础，并不难。GraphQL Java Tools的这样类似JPA的，通过对象来操作事情的思想很好，这个月找机会研究一下JPA以及GraphQL Java Tools的源码，学习一下。

References:

https://www.graphql-java.com/tutorials/getting-started-with-spring-boot/#graphql-in-3-minutes
https://www.graphql-java.com/documentation/v15/
https://graphql.org/
https://www.graphql-java-kickstart.com/