Apollo Federation集成

Apollo Federation是一个GraphQL网关,它可以组合多个GraphQL服务,允许每服务仅实现它负责的那一部分数据,参考官方文档

Async-graphql可以完全支持Apollo Federation的所有功能,但需要对Schema定义做一些小小的改造。

  • async_graphql::Objectasync_graphql::Interfaceextends属性声明这个类别是一个已有类型的扩充。

  • 字段的external属性声明这个字段定义来自其它服务。

  • 字段的provides属性用于要求网关提供的字段集。

  • 字段的provides属性表示解析该字段值需要依赖该类型的字段集。

实体查找函数


#![allow(unused)]
fn main() {
struct Query;

#[Object]
impl Query {
    #[entity]
    async fn find_user_by_id(&self, id: ID) -> User {
        User { ... }
    }

    #[entity]
    async fn find_user_by_id_with_username(&self, #[graphql(key)] id: ID, username: String) -> User {
        User { ... }
    }

    #[entity]
    async fn find_user_by_id_and_username(&self, id: ID, username: String) -> User {
        User { ... }
    }
}
}

注意这三个查找函数的不同,他们都是查找User对象。

  • find_user_by_id

    使用id查找User对象,User对象的key是id

  • find_user_by_id_with_username

    使用id查找User对象,User对象的key是id,并且请求User对象的username字段值。

  • find_user_by_id_and_username

    使用idusername查找User对象,User对象的key是idusername

完整的例子请参考https://github.com/async-graphql/examples/tree/master/federation