GraphQL と Spring Boot の初体験

プロジェクトは GitHub にホストされています：y0ngb1n/spring-boot-samples、Star や Fork を歓迎します 😘

GraphQL は API 用のクエリ言語であり、データクエリを満たすためのランタイムでもあります。 GraphQL はあなたの API 内のデータに対して理解しやすい完全な説明を提供し、クライアントが必要なデータを正確に取得できるようにし、冗長性を排除します。また、API が時間とともに進化しやすくなり、強力な開発者ツールの構築にも利用できます。

スキーマの定義#

# src/main/resources/schema.graphql
schema {
  query: Query
}

type Query {
  allBooks: [Book]
  book(id: String): Book
}

type Book {
  isbn: String
  title: String
  publisher: String
  authors: [String]
  publishedDate: String
}

上記で定義したスキーマの読み込みと解析#

@Service
public class GraphQLService {

  @Value("classpath:schema.graphql")
  private Resource resource;

  @Getter
  private GraphQL graphQL;
  @Autowired
  private AllBooksDataFetcher allBooksDataFetcher;
  @Autowired
  private BookDataFetcher bookDataFetcher;

  @PostConstruct
  private void loadSchema() throws IOException {
    // ローカルで定義されたスキーマファイルを取得
    File schemaFile = resource.getFile();
    // スキーマファイルを解析
    TypeDefinitionRegistry typeRegistry = new SchemaParser().parse(schemaFile);
    RuntimeWiring wiring = buildRuntimeWiring();
    GraphQLSchema schema = new SchemaGenerator().makeExecutableSchema(typeRegistry, wiring);
    graphQL = GraphQL.newGraphQL(schema).build();
  }

  private RuntimeWiring buildRuntimeWiring() {
    return RuntimeWiring.newRuntimeWiring()
      .type("Query", typeWiring -> typeWiring
        .dataFetcher("allBooks", allBooksDataFetcher)
        .dataFetcher("book", bookDataFetcher)
      ).build();
  }
}

DataFetcher の提供#

スキーマ内のクエリの実装を提供します：

type Query {
  allBooks: [Book]
  book(id: String): Book
}

AllBooksDataFetcher は allBooks: [Book] に対応します：

@Component
public class AllBooksDataFetcher implements DataFetcher<List<Book>> {

  @Autowired
  private BookRepository bookRepository;

  @Override
  public List<Book> get(DataFetchingEnvironment dataFetchingEnvironment) {
    return bookRepository.findAll();
  }
}

BookDataFetcher は book(id: String): Book に対応します：

@Component
public class BookDataFetcher implements DataFetcher<Book> {

  @Autowired
  private BookRepository bookRepository;

  @Override
  public Book get(DataFetchingEnvironment dataFetchingEnvironment) {
    String isn = dataFetchingEnvironment.getArgument("id");
    return bookRepository.findById(isn).orElse(null);
  }
}

GraphQL API の提供#

@RestController
@RequestMapping(path = "/v1/books")
public class BookController {

  @Autowired
  private GraphQLService graphQLService;

  @PostMapping
  public ResponseEntity<Object> getAllBooks(@RequestBody String query) {
    ExecutionResult execute = graphQLService.getGraphQL().execute(query);
    return new ResponseEntity<>(execute, HttpStatus.OK);
  }
}

起動とテスト#

$ mvn install
...
[INFO] BUILD SUCCESS
...
$ mvn spring-boot:run
...
2019-08-24 19:35:11.700  INFO 14464 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2019-08-24 19:35:11.702  INFO 14464 --- [           main] i.g.y.s.graphql.GraphQLApplication       : Started GraphQLApplication in 16.808 seconds (JVM running for 25.601)

部分フィールドのクエリ

$ curl -X POST \
  http://127.0.0.1:8080/v1/books \
  -H 'Content-Type: text/plain' \
  -d '{
    allBooks {
      isbn
      title
  }
}' | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   579    0   524  100    55  34933   3666 --:--:-- --:--:-- --:--:-- 38600
{
  "errors": [],
  "data": {
    "allBooks": [
      {
        "isbn": "9787111213826",
        "title": "Java プログラミング思想（第4版）"
      },
      ...
    ]
  },
  "extensions": null,
  "dataPresent": true
}

$ curl -X POST \
  http://127.0.0.1:8080/v1/books \
  -H 'Content-Type: text/plain' \
  -d '{
    book(id: "9787121362132") {
      title
  }
}' | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   210    0   159  100    51   1691    542 --:--:-- --:--:-- --:--:--  2234
{
  "errors": [],
  "data": {
    "book": {
      "title": "高可用可伸縮マイクロサービスアーキテクチャ：Dubbo、Spring Cloud と Service Mesh に基づく"
    }
  },
  "extensions": null,
  "dataPresent": true
}

全フィールドのクエリ

$ curl -X POST \
  http://127.0.0.1:8080/v1/books \
  -H 'Content-Type: text/plain' \
  -d '{
    allBooks {
      isbn
      title
      authors
      publisher
      publishedDate
  }
}' | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  1139    0  1044  100    95    750     68  0:00:01  0:00:01 --:--:--   818
{
  "errors": [],
  "data": {
    "allBooks": [
      {
        "isbn": "9787111213826",
        "title": "Java プログラミング思想（第4版）",
        "authors": [
          "Bruce Eckel"
        ],
        "publisher": "機械工業出版社",
        "publishedDate": "2007-06-01"
      },
      ...
    ]
  },
  "extensions": null,
  "dataPresent": true
}

$ curl -X POST \
  http://127.0.0.1:8080/v1/books \
  -H 'Content-Type: text/plain' \
  -d '{
    book(id: "9787121362132") {
      title
      authors
      publisher
      publishedDate
  }
}' | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   421    0   320  100   101   312k    98k --:--:-- --:--:-- --:--:--  411k
{
  "errors": [],
  "data": {
    "book": {
      "title": "高可用可伸縮マイクロサービスアーキテクチャ：Dubbo、Spring Cloud と Service Mesh に基づく",
      "authors": [
        "程超",
        "梁桂釗",
        "秦金衛",
        "方志斌",
        "張逸",
        "杜琪",
        "殷琦",
        "肖冠宇"
      ],
      "publisher": "電子工業出版社",
      "publishedDate": "2019-05-01"
    }
  },
  "extensions": null,
  "dataPresent": true
}

複数データのクエリ

$ curl -X POST \
  http://127.0.0.1:8080/v1/books \
  -H 'Content-Type: text/plain' \
  -d '{
    allBooks {
      isbn
      title
    }
    book(id: "9787121362132") {
      title
      authors
      publisher
      publishedDate
  }
}' | jq
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   930    0   785  100   145   3866    714 --:--:-- --:--:-- --:--:--  4581
{
  "errors": [],
  "data": {
    "allBooks": [
      {
        "isbn": "9787111213826",
        "title": "Java プログラミング思想（第4版）"
      },
      {
        "isbn": "9787111421900",
        "title": "Java 仮想マシンを深く理解する：JVM の高度な機能とベストプラクティス（第2版）"
      },
      {
        "isbn": "9787115221704",
        "title": "リファクタリング 既存コードの設計を改善する（第2版）"
      },
      {
        "isbn": "9787121362132",
        "title": "高可用可伸縮マイクロサービスアーキテクチャ：Dubbo、Spring Cloud と Service Mesh に基づく"
      },
      {
        "isbn": "9787302392644",
        "title": "人月の神話（40周年中国語記念版）"
      }
    ],
    "book": {
      "title": "高可用可伸縮マイクロサービスアーキテクチャ：Dubbo、Spring Cloud と Service Mesh に基づく",
      "authors": [
        "程超",
        "梁桂釗",
        "秦金衛",
        "方志斌",
        "張逸",
        "杜琪",
        "殷琦",
        "肖冠宇"
      ],
      "publisher": "電子工業出版社",
      "publishedDate": "2019-05-01"
    }
  },
  "extensions": null,
  "dataPresent": true
}

以上のように、API は変わらず、クエリの内容だけが変更されると、自動的に異なる結果が返されます。

Aben Blog