对于最新的稳定版本,请使用 Spring GraphQL 1.4.1spring-doc.cadn.net.cn

代码生成

您可以使用 DGS 代码生成等工具来生成 GraphQL 架构中的 Java 类型。可以生成以下内容:spring-doc.cadn.net.cn

  1. 请求(例如查询、突变)、输入类型和响应选择类型的客户端类型。spring-doc.cadn.net.cn

  2. 与 GraphQL 架构类型对应的数据类型。spring-doc.cadn.net.cn

代码生成可能不适合您自己的应用程序的数据类型,尤其是当您 想要为它们添加逻辑。但是,代码生成非常适合客户端类型,因为 这些定义了请求,不需要有其他逻辑。作为客户,您还可以 选择生成响应的数据类型。spring-doc.cadn.net.cn

客户端生成的类型可以与 Spring 的GraphQlClient.首先遵循 DGS 代码生成插件生成客户端 API 类型的说明。然后,给定 像这样的模式:spring-doc.cadn.net.cn

type Query {
    books: [Book]
}

type Book {
    id: ID
    name: String
}

DGS Codegen 生成BooksGraphQLQueryBooksProjectionRoot您可以与GraphQlClient通过 HTTP(或任何支持的传输),如下所示:spring-doc.cadn.net.cn

HttpGraphQlClient client =
        HttpGraphQlClient.create(WebClient.create("http://localhost:8080/graphql"));

BooksGraphQLQuery query = new BooksGraphQLQuery();
String document = new GraphQLQueryRequest(query, new BooksProjectionRoot<>().id().name()).serialize();

List<Book> books = client.document(document)
        .retrieve(query.getOperationName())
        .toEntityList(Book.class)  // possibly also generated or imported if available
        .block();
我们打算在 spring-graphql#846 中进一步简化上述代码。

您可以在 start.spring.io 上使用 Spring 初始化程序创建 Spring 项目 DGS 代码生成 Gradle 或 Maven 插件。spring-doc.cadn.net.cn