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

66 lines
2.0 KiB
Markdown
Raw Normal View History

2020-04-15 03:15:30 +00:00
# Warp
2020-04-17 10:22:24 +00:00
`Async-graphql-warp`提供了两个`Filter``graphql`和`graphql_subscription`。
2021-11-16 06:51:20 +00:00
`graphql`用于执行`Query`和`Mutation`请求它提取GraphQL请求然后输出一个包含`async_graphql::Schema`和`async_graphql::Request`元组你可以在之后组合其它Filter或者直接调用`Schema::execute`执行查询。
2020-04-17 10:22:24 +00:00
`graphql_subscription`用于实现基于Web Socket的订阅它输出`warp::Reply`。
## 请求例子
```rust
# extern crate async_graphql_warp;
# extern crate async_graphql;
# extern crate warp;
# use async_graphql::*;
# use std::convert::Infallible;
# use warp::Filter;
# struct QueryRoot;
# #[Object]
# impl QueryRoot { async fn version(&self) -> &str { "1.0" } }
# async fn other() {
2020-09-11 15:38:18 +00:00
type MySchema = Schema<QueryRoot, EmptyMutation, EmptySubscription>;
2020-04-17 10:22:24 +00:00
let schema = Schema::new(QueryRoot, EmptyMutation, EmptySubscription);
2020-09-11 15:38:18 +00:00
let filter = async_graphql_warp::graphql(schema).and_then(|(schema, request): (MySchema, async_graphql::Request)| async move {
2020-04-17 10:22:24 +00:00
// 执行查询
2020-09-11 15:38:18 +00:00
let resp = schema.execute(request).await;
2020-04-17 10:22:24 +00:00
// 返回结果
Ok::<_, Infallible>(async_graphql_warp::GraphQLResponse::from(resp))
2020-04-17 10:22:24 +00:00
});
warp::serve(filter).run(([0, 0, 0, 0], 8000)).await;
# }
2020-04-17 10:22:24 +00:00
```
## 订阅例子
```rust
# extern crate async_graphql_warp;
# extern crate async_graphql;
# extern crate warp;
# use async_graphql::*;
# use futures_util::stream::{Stream, StreamExt};
# use std::convert::Infallible;
# use warp::Filter;
# struct SubscriptionRoot;
# #[Subscription]
# impl SubscriptionRoot {
# async fn tick(&self) -> impl Stream<Item = i32> {
# futures_util::stream::iter(0..10)
# }
# }
# struct QueryRoot;
# #[Object]
# impl QueryRoot { async fn version(&self) -> &str { "1.0" } }
# async fn other() {
2020-04-17 10:22:24 +00:00
let schema = Schema::new(QueryRoot, EmptyMutation, SubscriptionRoot);
let filter = async_graphql_warp::graphql_subscription(schema);
warp::serve(filter).run(([0, 0, 0, 0], 8000)).await;
# }
2020-04-17 10:22:24 +00:00
```
2020-10-14 01:10:06 +00:00
## 更多例子
2020-10-14 01:17:00 +00:00
[https://github.com/async-graphql/examples/tree/master/warp](https://github.com/async-graphql/examples/tree/master/warp)