Apollo Federation 集成

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

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

• async_graphql::Object和async_graphql::Interface的extends属性声明这个类别是一个已有类型的扩充。

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

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

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

实体查找函数

#![allow(unused)]
fn main() {
extern crate async_graphql;
use async_graphql::*;
#[derive(SimpleObject)]
struct User { id: ID }
struct Query;

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

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

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

注意这三个查找函数的不同，他们都是查找 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

  使用id和username查找User对象，User对象的 key 是id和username。

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

定义复合主键

一个主键可以包含多个字段，什么包含嵌套字段，你可以用InputObject来实现一个嵌套字段的 Key 类型。

下面的例子中User对象的主键是key { a b }。

#![allow(unused)]
fn main() {
extern crate async_graphql;
use async_graphql::*;
#[derive(SimpleObject)]
struct User { id: i32 }
#[derive(InputObject)]
struct NestedKey {
  a: i32,
  b: i32,
}

struct Query;

#[Object]
impl Query {
  #[graphql(entity)]
  async fn find_user_by_key(&self, key: NestedKey) -> User {
    User { id: key.a }
  }
}
}