async-graphql/docs/zh-CN/src/define_simple_object.md

66 lines
1.4 KiB
Markdown
Raw Normal View History

2020-04-16 02:22:57 +00:00
# 简单对象(SimpleObject)
2020-05-13 04:49:43 +00:00
简单对象是把Rust结构的所有字段都直接映射到GraphQL对象不支持定义单独的Resolver函数。
2020-04-16 02:22:57 +00:00
2020-09-28 09:44:00 +00:00
下面的例子定义了一个名称为MyObject的对象包含字段`a`和`b``c`由于标记为`#[graphql(skip)]`所以不会映射到GraphQL。
2020-04-16 02:22:57 +00:00
```rust
use async_graphql::*;
#[derive(SimpleObject)]
2020-04-16 02:22:57 +00:00
struct MyObject {
/// Value a
2020-04-16 02:22:57 +00:00
a: i32,
2020-09-28 09:44:00 +00:00
/// Value b
2020-04-16 02:22:57 +00:00
b: i32,
2020-09-28 09:44:00 +00:00
#[graphql(skip)]
2020-04-16 02:22:57 +00:00
c: i32,
}
```
2021-01-16 00:08:36 +00:00
## 泛型
如果你希望其它类型能够重用`SimpleObject`,则可以定义泛型的`SimpleObject`,并指定具体的类型。
在下面的示例中,创建了两种`SimpleObject`类型:
```rust
#[derive(SimpleObject)]
#[graphql(concrete(name = "SomeName", params(SomeType)))]
#[graphql(concrete(name = "SomeOtherName", params(SomeOtherType)))]
pub struct SomeGenericObject<T: OutputType> {
field1: Option<T>,
field2: String
}
```
注意:每个泛型参数必须实现`OutputType`,如上所示。
生成的SDL如下:
```gql
type SomeName {
field1: SomeType
field2: String!
}
type SomeOtherName {
field1: SomeOtherType
field2: String!
}
```
在其它`Object`中使用具体的泛型类型:
```rust
#[derive(SimpleObject)]
pub struct YetAnotherObject {
a: SomeGenericObject<SomeType>,
b: SomeGenericObject<SomeOtherType>,
}
```
你可以将多个通用类型传递给`params`,并用逗号分隔。