|
|
" J+ y, d0 t. u' Z/ N! M
<h2 id="系列导航">系列导航</h2>* U, l: I& F' n
<p><a href="https://www.cnblogs.com/code4nothing/p/graphql-net6-0.html">使用Hot Chocolate和.NET 6构建GraphQL应用文章索引</a></p>& m+ Z* e- E, C3 D, {' E
<h2 id="需求">需求</h2> z0 {8 O1 E8 [4 {* |
<p>在讨论完GraphQL中的查询需求后,这篇文章我们将演示如何实现GraphQL中的数据添加任务。</p>
6 b* I3 K, W) p6 |, n3 |<h2 id="思路">思路</h2>( ~! k, S. w3 G3 q5 K! V4 O7 S
<p>在GraphQL中,对数据进行查询使用<code>query</code>,而对于修改数据则需要使用<code>mutation</code>,包括新增和修改数据。Hot Chocolate在使用Mutation的逻辑上和使用Query的基本一致,但是需要根据需要定义用于创建或者更新的数据对象,所以我们直接进行实现。</p>; E1 d9 K# u3 D) |& ?
<h2 id="实现">实现</h2>% C$ ^4 |9 j: i7 S4 ^* ^
<p>为了保持简单,我们先定义以下两个类型:</p>
2 I0 g! b/ N8 h<pre><code class="language-c#">// 定义新增Post的参数# n+ F2 J" |- l# X( k
public record AddPostInput(string Title, string Author);- r3 J t. w) H# N# R
% n( l* S% w8 d) V// 定义新增Post的返回对象
1 w2 U8 s8 Z J( ?1 L2 n) mpublic record AddPostPayload(Post Post);
0 u: r- l- b% T& Q</code></pre>, I: E+ G& E _4 l- V* _
<p>新建<code>Mutation.cs</code>用来定义相关接口:</p>8 f1 ]5 z# o! H& h
<ul>
) w6 ^: I4 s4 V5 p) s<li><code>Mutation.cs</code></li>
( K1 ]! q5 L# w$ B' {3 K</ul>' W# m$ X) k1 S' @4 H
<pre><code class="language-c#">namespace PostGraphi.Api.GraphQL;( Z( E* ]* j) _# _3 N
9 Z1 X+ q, p" g: A+ F) r2 `% @public class Mutation) C' L) x% O( \9 x
{
, h3 d$ f, O) i7 v/ S+ M X" R6 n public async Task<AddPostPayload> AddPostAsync(AddPostInput input, [Service] IRepository<Post> repository)$ q- r9 Q s2 s2 E# C
{9 b8 n' Z0 Q9 D. Y% L/ U3 g5 W( O
return new AddPostPayload(await repository.AddAsync(new Post
- @$ `/ {* p8 _9 F: v7 J {1 e4 s7 D9 q5 L+ k, O
Title = input.Title,
+ q/ M/ C+ m& y Author = input.Author& H2 a$ F$ y3 |9 K. [9 y
}));
, X2 [# c- L# Z7 X# }5 N8 ~ }
" Q: b9 Z) `4 `}
\* y# `7 `7 f) k3 }$ w! r& t+ O" q. s: y# Y
</code></pre>6 ^1 t0 s7 n5 u/ P
<p>最后在注入服务的地方进行配置:</p>
8 E4 T6 M# _9 P: ^7 M {<ul>' d. ~3 u. _/ \
<li><code>ProgramExtensions.cs</code></li>: x4 o' X' x7 X. b: {% a' O
</ul>
$ [2 M& d9 ]4 W p% r0 Q<pre><code class="language-c#">builder.Services
. ?: @" o' @6 ?8 {( X' c( ~0 f. H) k2 R .AddGraphQLServer()8 a/ P8 j% n- A5 d! m2 {$ I. b
.SetPagingOptions(new PagingOptions
: q. S6 x1 @ L6 n6 N {
( j8 c; c" X* u' d3 G MaxPageSize = 50,
8 K2 P* ]9 F$ M/ W- Q2 y) Y IncludeTotalCount = true t& |+ q+ M% N& G
})3 e$ b* v$ T; I- u# p
.AddFiltering()
' U/ a: E# C( ]$ i .AddProjections()3 h* d1 V6 R7 ?, |' @
.AddSorting()
u1 }) Y; h+ \7 O .AddQueryType<Query>()5 ?; [8 S2 ]4 P/ n. N% L N
.AddMutationType<Mutation>()5 m' H" j8 [7 P" ?# L3 A, `/ V6 \
.AddMutationConventions(new MutationConventionOptions) z3 u6 k5 c4 c
{
6 z" C7 O9 G7 B+ Q( F6 e ApplyToAllMutations = true,) M# B. |& g9 y8 Y0 P' o, N! d
InputArgumentName = "input",+ e' G5 V }( }8 [ ^
InputTypeNamePattern = "{MutationName}Input",5 ?2 ?+ s' ]' E% h3 i7 Z5 w
PayloadTypeNamePattern = "{MutationName}Payload",& r( M4 M' U0 }5 n
PayloadErrorTypeNamePattern = "{MutationName}Error",
7 g3 v. J, E' T" y5 B2 l3 d. ~ PayloadErrorsFieldName = "errors"
+ w) a; O( Y0 }) d# }8 H1 g })
+ V- w8 V2 _) F2 V& f .AddType<PostType>();
, U) N) e' g+ k1 L5 R# G) j</code></pre>
; m1 G; r4 Z2 C3 ^- r<p>这样就实现了新增Post的需求,下面我们来验证一下。</p>: P# g7 z! E/ d# k# o! Q1 p/ r* v' |* k+ Q
<h2 id="验证">验证</h2>
$ | V# b; F* y* W" l! D4 l" A% v<p>启动<code>Api</code>项目,调用接口:</p>, K9 W6 k" O9 ]6 g+ \
<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104544617-1400586374.png" ></p>1 z- H8 v' ]8 u& l/ |0 {! @9 b( Q
<p>终端的日志输出如下:</p>/ Z) T5 B8 {/ X
<pre><code class="language-bash">[10:45:15 INF] Executed DbCommand (1ms) [Parameters=[@p0='?' (DbType = Guid), @p1='?', @p2='?' (Size = 13), @p3='?', @p4='?' (DbType = DateTime), @p5='?', @p6='?' (DbType = DateTime), @p7='?', @p8='?', @p9='?' (DbType = DateTime), @p10='?' (Size = 30)], CommandType='Text', CommandTimeout='30']2 _- ~/ u. A H- X% {- w
INSERT INTO "Posts" ("Id", "Abstraction", "Author", "Content", "Created", "CreatedBy", "LastModified", "LastModifiedBy", "Link", "PublishedAt", "Title")1 I$ V! h! K/ w
VALUES (@p0, @p1, @p2, @p3, @p4, @p5, @p6, @p7, @p8, @p9, @p10);
0 x2 d( A1 k' _" E# u( L& M[10:45:15 INF] Executed endpoint 'Hot Chocolate GraphQL Pipeline' d! T J5 |% ^0 ?) Y! V' i! W
</code></pre>
( F$ b& r' ^& B<p>可以看到新建的Post已经存储到数据库中了,我们可以通过查询接口来获取详情:</p>2 D% I8 D0 c7 ^2 D! S% j) `" v
<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104851825-1533915064.png" ></p>; n- O1 }2 R5 b7 ]( p6 E1 {
<h2 id="总结">总结</h2>
* J2 C) b4 ~( h. H6 k$ z* m<p>在本文中我们实现了简单的新增Post操作,这里还有一些涉及到错误处理的内容,我没有在文章中演示,可以参考官方文档 <a href="https://chillicream.com/docs/hotchocolate/defining-a-schema/mutations/#errors">Errors</a>,在自定义异常对象后,有三种方式可以进行错误处理:直接返回异常;使用异常工厂方法;使用构造函数。甚至可以在<code>AggregateExceptions</code>中一次性返回多个异常。基本思路都是通过添加属性<code>[Error(typeof(SomeUserDefinedException))]</code>来实现的。</p>! C3 @' G P0 M& j" ^
<p>在下一篇文章中,我们通过<code>Mutation</code>对已有数据进行更新。</p>
1 L! D. \& Q. m+ @+ s
/ x% ~ X) _8 c4 l# G A |
|