|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring GraphQL 1.4.1！ |
Federation
Spring for GraphQL 为 federation-jvm 库提供了集成，该库使用 GraphQL Java 用于初始化联合服务图中子图的架构。 有关详细信息，请参阅 Apollo Federation 和 Subgraph 规范。
配置
要启用集成，请声明一个FederationSchemaFactorybean 的 bean 配置，然后插入
它变成GraphQlSource.Builder.例如，使用 Spring Boot：
@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
一@EntityMapping方法可以加载联合类型实例以响应来自联合网关的_entities查询。例如：
@Controller
private static class BookController {
@EntityMapping
public Book book(@Argument int id) { (1)
// ...
}
@SchemaMapping
public Author author(Book book) { (2)
// ...
}
}| 1 | 这@Argumentmethod 参数从“表示”输入映射中解析
实体。完整的“表示”输入Map也可以解决。有关支持的内容，请参阅方法签名
method 参数和返回值类型。 |
| 2 | @SchemaMapping方法可用于图形的其余部分。 |
您可以通过接受List的 id's，
并返回一个List或Flux实体数量：
@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 | 这idList命名约定有助于将参数名称去复数化，以便
在“表示”输入映射中查找正确的值。您还可以将
参数名称。 |
| 2 | @BatchMapping方法可用于图形的其余部分。 |
您可以使用DataLoader:
@Controller
private static class BookController {
@Autowired
public DataLoaderBookController(BatchLoaderRegistry registry) { (1)
registry.forTypePair(Integer.class, Book.class).registerBatchLoader((bookIds, environment) -> {
// load entities...
});
}
@EntityMapping
public Future<Book> book(@Argument int id, DataLoader<Integer, Book> dataLoader) { (2)
return dataLoader.load(id);
}
@BatchMapping
public Map<Book, Author> author(List<Book> books) { (3)
// ...
}
}| 1 | 为联合实体类型注册批处理加载程序。 |
| 2 | 声明一个DataLoader参数设置为@EntityMapping方法。 |
| 3 | @BatchMapping方法可用于图形的其余部分。 |
方法签名
实体映射方法支持以下参数：
| 方法参数 | 描述 |
|---|---|
|
用于访问“表示”输入映射中的命名值，也转换为类型化对象。 |
|
实体的完整“表示”输入映射。 |
|
使用单个控制器方法加载时的“表示”输入映射列表 给定类型的所有实体。 |
|
用于从 main |
|
用于从本地访问属性 |
|
要从 |
|
从 Spring Security 上下文（如果可用）获取。 |
|
用于访问 |
|
要通过 |
|
要访问 |
|
用于直接访问基础 |
|
要使用 |
@EntityMapping方法可以返回Mono,CompletableFuture,Callable，或实际实体。