2020-04-15 09:19:26 +00:00
|
|
|
|
# 快速开始
|
|
|
|
|
|
|
|
|
|
## 添加依赖
|
|
|
|
|
|
|
|
|
|
```toml
|
|
|
|
|
[dependencies]
|
2020-10-13 15:13:36 +00:00
|
|
|
|
async-graphql = "2.0"
|
|
|
|
|
async-graphql-actix-web = "2.0" # 如果你需要集成到Actix-web
|
|
|
|
|
async-graphql-warp = "2.0" # 如果你需要集成到Warp
|
|
|
|
|
async-graphql-tide = "2.0" # 如果你需要集成到Tide
|
2020-04-15 09:19:26 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 写一个Schema
|
|
|
|
|
|
2020-09-28 09:44:00 +00:00
|
|
|
|
一个GraphQL的Schema包含一个必须的查询(Query)根对象,可选的变更(Mutation)根对象和可选的订阅(Subscription)根对象,这些对象类型都是用Rust语言的结构来描述它们,结构的字段对应GraphQL对象的字段。
|
2020-04-15 09:19:26 +00:00
|
|
|
|
|
|
|
|
|
Async-graphql实现了常用数据类型到GraphQL类型的映射,例如`i32`, `f64`, `Option<T>`, `Vec<T>`等。同时,你也能够[扩展这些基础类型](custom_scalars.md),基础数据类型在GraphQL里面称为标量。
|
|
|
|
|
|
|
|
|
|
下面是一个简单的例子,我们只提供一个查询,返回`a`和`b`的和。
|
|
|
|
|
|
|
|
|
|
```rust
|
|
|
|
|
use async_graphql::*;
|
|
|
|
|
|
|
|
|
|
struct Query;
|
|
|
|
|
|
2020-09-18 00:52:13 +00:00
|
|
|
|
#[Object]
|
2020-04-15 09:19:26 +00:00
|
|
|
|
impl Query {
|
2020-09-28 06:43:12 +00:00
|
|
|
|
/// Returns the sum of a and b
|
2020-06-15 13:07:38 +00:00
|
|
|
|
async fn add(&self, a: i32, b: i32) -> i32 {
|
2020-04-15 09:19:26 +00:00
|
|
|
|
a + b
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2020-04-16 02:22:57 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 执行查询
|
|
|
|
|
|
2020-04-22 03:16:41 +00:00
|
|
|
|
在我们这个例子里面,只有Query,没有Mutation和Subscription,所以我们用`EmptyMutation`和`EmptySubscription`来创建Schema,然后调用`Schema::execute`来执行查询。
|
2020-04-15 09:19:26 +00:00
|
|
|
|
|
2020-04-16 02:22:57 +00:00
|
|
|
|
```rust
|
2020-06-15 13:07:38 +00:00
|
|
|
|
let schema = Schema::new(Query, EmptyMutation, EmptySubscription);
|
2020-09-17 00:14:07 +00:00
|
|
|
|
let res = schema.execute("{ add(a: 10, b: 20) }").await;
|
2020-04-15 09:19:26 +00:00
|
|
|
|
```
|
|
|
|
|
|
2020-04-16 02:22:57 +00:00
|
|
|
|
## 把查询结果输出为JSON
|
|
|
|
|
|
|
|
|
|
```rust
|
2020-09-17 00:14:07 +00:00
|
|
|
|
let json = serde_json::to_string(&res);
|
2020-04-22 03:16:41 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 和Web Server的集成
|
|
|
|
|
|
2020-10-13 15:13:36 +00:00
|
|
|
|
请参考https://github.com/async-graphql/examples。
|