Edward Rudd 3b7ed74d11 correct doc examples so they compile

- examples to fix still
  - error_extensions.md ResultExt example does not compile!
     - trait ErrorExtensions is not implemented for ParseIntError
  - dataloader
     - requires sqlx to work. So we either "stub" it OR we rewrite them simpler to use a  simple "faux" db library

2022-06-02 17:32:12 -04:00

2.2 KiB

Raw Blame History

输入对象(InputObject)

你可以定义一个对象作为参数类型，GraphQL称之为Input Object，输入对象的定义方式和简单对象很像，不同的是，简单对象只能用于输出，而输入对象只能用于输入。

你也通过可选的#[graphql]属性来给字段添加描述，重命名。

# extern crate async_graphql;
# #[derive(SimpleObject)]
# struct User { a: i32 }
use async_graphql::*;

#[derive(InputObject)]
struct Coordinate {
    latitude: f64,
    longitude: f64,
}

struct Mutation;

#[Object]
impl Mutation {
    async fn users_at_location(&self, coordinate: Coordinate, radius: f64) -> Vec<User> {
        // 将坐标写入数据库
        // ...
#       todo!()
    }
}

泛型

如果你希望其它类型能够重用InputObject，则可以定义泛型的InputObject，并指定具体的类型。

在下面的示例中，创建了两种InputObject类型：

# extern crate async_graphql;
# use async_graphql::*;
# #[derive(InputObject)]
# struct SomeType { a: i32 }
# #[derive(InputObject)]
# struct SomeOtherType { a: i32 }
#[derive(InputObject)]
#[graphql(concrete(name = "SomeName", params(SomeType)))]
#[graphql(concrete(name = "SomeOtherName", params(SomeOtherType)))]
pub struct SomeGenericInput<T: InputType> {
    field1: Option<T>,
    field2: String
}

注意：每个泛型参数必须实现InputType，如上所示。

生成的SDL如下:

input SomeName {
  field1: SomeType
  field2: String!
}

input SomeOtherName {
  field1: SomeOtherType
  field2: String!
}

在其它InputObject中使用具体的泛型类型：

# extern crate async_graphql;
# use async_graphql::*;
# #[derive(InputObject)]
# struct SomeType { a: i32 }
# #[derive(InputObject)]
# struct SomeOtherType { a: i32 }
# #[derive(InputObject)]
# #[graphql(concrete(name = "SomeName", params(SomeType)))]
# #[graphql(concrete(name = "SomeOtherName", params(SomeOtherType)))]
# pub struct SomeGenericInput<T: InputType> {
#     field1: Option<T>,
#     field2: String
# }
#[derive(InputObject)]
pub struct YetAnotherInput {
    a: SomeGenericInput<SomeType>,
    b: SomeGenericInput<SomeOtherType>,
}

你可以将多个通用类型传递给params（），并用逗号分隔。

2.2 KiB Raw Blame History Unescape Escape

输入对象(InputObject)

泛型

2.2 KiB

Raw Blame History