|
|
1 G S. ^8 X& h( }$ Q7 C* i) Z2 d. [<h2 id="系列导航">系列导航</h2>
/ a. h2 O9 ]/ Z3 Q# Z6 l1 L' C<p><a href="https://www.cnblogs.com/code4nothing/p/graphql-net6-0.html">使用Hot Chocolate和.NET 6构建GraphQL应用文章索引</a></p>
& \9 i; y0 b+ A. a5 d% x<h2 id="需求">需求</h2>9 T; V; j- N& I- S' `, G
<p>在讨论完GraphQL中的查询需求后,这篇文章我们将演示如何实现GraphQL中的数据添加任务。</p>
0 y- E' P% O! B7 j8 u1 E) y<h2 id="思路">思路</h2>
& w; ?0 u% P* t0 U! K4 i<p>在GraphQL中,对数据进行查询使用<code>query</code>,而对于修改数据则需要使用<code>mutation</code>,包括新增和修改数据。Hot Chocolate在使用Mutation的逻辑上和使用Query的基本一致,但是需要根据需要定义用于创建或者更新的数据对象,所以我们直接进行实现。</p>6 K5 H* Z/ z0 f% c [8 j
<h2 id="实现">实现</h2>5 D; ~. |+ |) [& g. o5 Y
<p>为了保持简单,我们先定义以下两个类型:</p>) X7 ]4 s3 N/ S# q
<pre><code class="language-c#">// 定义新增Post的参数
1 ^6 e0 F1 u. j& @public record AddPostInput(string Title, string Author);% D- V3 S% h0 N9 U0 l: i% n
7 x( b5 ~# m# r( W/ {8 {9 K) V& @
// 定义新增Post的返回对象' F! Y& n: j# R4 \; S
public record AddPostPayload(Post Post);8 s0 P/ ~* r5 G3 ~2 v5 A- b0 K+ D
</code></pre>- [; U3 O* l; Y/ |+ I) ]) l
<p>新建<code>Mutation.cs</code>用来定义相关接口:</p> K+ z/ {( r+ G7 o* h% B. L
<ul>
. l0 @- R) B3 b7 S<li><code>Mutation.cs</code></li>
: `; ?5 n. Q) q</ul>. P4 y2 Z9 J2 e6 y! ?" F6 Y! H
<pre><code class="language-c#">namespace PostGraphi.Api.GraphQL;! C' g! ]# B& {! W6 D& \
! X% ]$ M+ i/ U; r( C1 F
public class Mutation
! L" p$ ~; j" a{0 b# H& a$ H) p: e& C* o
public async Task<AddPostPayload> AddPostAsync(AddPostInput input, [Service] IRepository<Post> repository)7 O6 {8 l7 B7 _; h8 `4 `! E9 e
{
6 Q" F# z. B2 m' ?3 V, q: d return new AddPostPayload(await repository.AddAsync(new Post) R3 s9 m- J0 U% o. K6 o9 R3 V4 W
{
& p* c& W0 u8 C, k Title = input.Title,
! o% k7 m8 x- E5 \- t; u' x! I6 ?; c! G7 C Author = input.Author
. O0 ~2 s. _! o4 d% W$ u }));" d7 E3 Q ^. a, k) H. w
}
7 R) D3 G8 M" t$ l7 O}
' M' O/ w" V- ?2 o" C# k E) n5 }: c/ n# i
</code></pre>/ J% L+ u$ P+ {5 M
<p>最后在注入服务的地方进行配置:</p>
2 P5 h* g7 J" ?+ M<ul>
( a$ ?0 u4 W) M<li><code>ProgramExtensions.cs</code></li>. {, L: g2 _3 H) B$ T F6 J5 b
</ul>
1 \0 z1 o- w4 q5 f; Q8 c5 e<pre><code class="language-c#">builder.Services
* `1 p" ~; l0 A* t2 ]) B# Q .AddGraphQLServer()7 U$ ?, p& g+ y7 o1 j) x7 _0 w
.SetPagingOptions(new PagingOptions
O; \' @0 E& ?8 O0 U {
3 e( v0 _4 T& L: ~/ s" o MaxPageSize = 50,( t9 M! i7 U p* G+ q5 t7 t
IncludeTotalCount = true
x( Z% Z- [+ U7 M( \7 u })
" G5 j; ^) D" S; B1 l2 s, N. R .AddFiltering(), h1 k' G9 f$ S+ F
.AddProjections()
. N. L+ }, M& V$ S, c0 x .AddSorting()
5 I$ X# n$ H( r4 o8 W2 O .AddQueryType<Query>()& W4 I. B' G7 o4 D) q$ f
.AddMutationType<Mutation>()
6 w5 T6 C# ^, O5 I# W# ^ .AddMutationConventions(new MutationConventionOptions
; V! i5 j0 n1 f9 q- E* f {" U" ~6 `- J5 f
ApplyToAllMutations = true,
7 C1 ~1 M7 y0 R v) @9 @ InputArgumentName = "input",, `- e! n- W/ E$ A1 X5 j6 }
InputTypeNamePattern = "{MutationName}Input",
5 C' l; j3 h0 R s4 Z PayloadTypeNamePattern = "{MutationName}Payload",9 D$ y, l* w* o
PayloadErrorTypeNamePattern = "{MutationName}Error",. j: H8 x/ Q% n% O$ A
PayloadErrorsFieldName = "errors". } t$ }: {* r7 B$ Y- ]( U
})
: w$ L3 ]- [, ?3 s* y9 [# ]6 @ .AddType<PostType>();
2 t9 w! y% x6 }</code></pre>
7 Q* m* r$ S' r& E, C4 s<p>这样就实现了新增Post的需求,下面我们来验证一下。</p>
, x1 f [! B4 q7 S$ l7 ?* h& v<h2 id="验证">验证</h2>, @* Z: B7 O9 A: z
<p>启动<code>Api</code>项目,调用接口:</p>
2 q8 K$ s# f3 D( b. Z/ E) p<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104544617-1400586374.png" ></p>
, U6 q2 |, k9 v( f6 K; y6 d<p>终端的日志输出如下:</p>
! a! s# C6 M' Q! I- }. |/ ?& O<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']+ r6 @- w7 T) w1 I9 Y
INSERT INTO "Posts" ("Id", "Abstraction", "Author", "Content", "Created", "CreatedBy", "LastModified", "LastModifiedBy", "Link", "PublishedAt", "Title")6 c$ W& r* S' ~; o; t: Y
VALUES (@p0, @p1, @p2, @p3, @p4, @p5, @p6, @p7, @p8, @p9, @p10);
; V2 o) }+ L) L/ f) W1 B" l6 R: G[10:45:15 INF] Executed endpoint 'Hot Chocolate GraphQL Pipeline' J# g7 a! g- X3 J' w+ K2 K
</code></pre>) Y4 `9 X I- i! R0 [4 [
<p>可以看到新建的Post已经存储到数据库中了,我们可以通过查询接口来获取详情:</p>
" n+ U8 T& d9 ]( c, i3 d<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104851825-1533915064.png" ></p>
3 |# z# q1 b5 q/ @" c1 `' m<h2 id="总结">总结</h2>
% q: l! |) b4 T9 M6 y0 [, L<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>
" v, L$ P. r* o" K<p>在下一篇文章中,我们通过<code>Mutation</code>对已有数据进行更新。</p>9 o8 h+ q9 G' z6 Z4 E; O# ]" t
8 {3 w" D: M* ]' X: C3 _& r |
|