|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring GraphQL 1.3.3！ |
Federation
Spring for GraphQL 为 federation-jvm 库提供了一个集成，该库使用 GraphQL Java，用于初始化联合服务图中子图的架构。 有关详细信息，请参阅 Apollo Federation 和 Subgraph 规范。
配置
要启用集成，请在配置中声明一个 Bean，然后将
它变成 。例如，使用 Spring Boot：FederationSchemaFactoryGraphQlSource.Builder
@Configuration
public class FederationConfig {
@Bean
public GraphQlSourceBuilderCustomizer customizer(FederationSchemaFactory factory) {
return builder -> builder.schemaFactory(factory::createGraphQLSchema);
}
@Bean
public FederationSchemaFactory schemaFactory() {
return new FederationSchemaFactory();
}
}现在，子图服务的架构可以扩展联合类型：
type Book @key(fields: "id") @extends {
id: ID! @external
author: Author
}
type Author {
id: ID
firstName: String
lastName: String
}@EntityMapping
方法可以加载联合类型实例以响应来自 Federation Gateway 的 _entities 查询。例如：@EntityMapping
例如：
@Controller
private static class BookController {
@EntityMapping
public Book book(@Argument int id) { (1)
// ...
}
@SchemaMapping
public Author author(Book book) { (2)
// ...
}
}| 1 | method 参数是从
实体。也可以解析完整的 “representation” 输入。请参阅支持的方法签名
method 参数和返回值类型。@ArgumentMap |
| 2 | @SchemaMapping方法可用于图形的其余部分。 |
方法可以批量加载给定类型的联合实体。为此，
将 method 参数声明为 List，并返回相应的实体
实例作为列表。@EntityMapping@Argument
例如：
@Controller
private static class BookController {
@EntityMapping
public List<Book> book(@Argument List<Integer> idList) { (1)
// ... return books in the same order
}
@BatchMapping
public Map<Book, Author> author(List<Book> books) { (2)
// ...
}
}| 1 | 命名约定有助于将参数名称去复数化，以便
在 “representation” input map 中查找正确的值。您还可以设置
argument name 的 Bean S 的 Intent S 的idList |
| 2 | @BatchMapping方法可用于图形的其余部分。 |
方法签名
实体映射方法支持以下参数：
| 方法参数 | 描述 |
|---|---|
|
用于从 “representation” 输入映射访问命名值，也转换为类型化 Object。 |
|
实体的完整 “representation” 输入映射。 |
|
使用单个控制器方法加载时的 “representation” input maps 列表 给定类型的所有实体。 |
|
要从 中的主 访问属性。 |
|
要从 中的本地访问属性。 |
|
要从 . |
|
从 Spring Security 上下文获取（如果可用）。 |
|
用于从 Spring Security 上下文访问。 |
|
要通过 . |
|
要从 访问 。 |
|
要直接访问底层 . |
@EntityMapping方法可以返回 、 、 或 实际实体。MonoCompletableFutureCallable