|
|
/ m5 ^6 e3 _0 a* Z8 v
<h2 id="系列导航">系列导航</h2>; H& i- a( h1 ^+ Y
<p><a href="https://www.cnblogs.com/code4nothing/p/graphql-net6-0.html">使用Hot Chocolate和.NET 6构建GraphQL应用文章索引</a></p>1 i( K, d+ Q+ D3 i7 T2 S
<h2 id="需求">需求</h2>
8 A/ T8 r( x! ~6 t0 S6 u<p>在讨论完GraphQL中的查询需求后,这篇文章我们将演示如何实现GraphQL中的数据添加任务。</p>
5 V7 O, X0 n- y* d( Q<h2 id="思路">思路</h2>- a4 o m# b+ K5 D/ x
<p>在GraphQL中,对数据进行查询使用<code>query</code>,而对于修改数据则需要使用<code>mutation</code>,包括新增和修改数据。Hot Chocolate在使用Mutation的逻辑上和使用Query的基本一致,但是需要根据需要定义用于创建或者更新的数据对象,所以我们直接进行实现。</p>+ Z# v7 i3 U/ Y2 K# `
<h2 id="实现">实现</h2>- F/ E& W) { r1 E1 i0 x" @
<p>为了保持简单,我们先定义以下两个类型:</p>
6 V2 w( W5 D+ W" n) I/ K<pre><code class="language-c#">// 定义新增Post的参数/ u! D w$ j2 f( y* \5 r, _* `
public record AddPostInput(string Title, string Author);
4 Z, a- z u" ?2 y) d
: Q( {( k6 @, ^1 d& V// 定义新增Post的返回对象" t- m3 V; e9 v6 I P# T6 I$ {
public record AddPostPayload(Post Post);: y/ F7 K4 B+ T7 c' o2 u& l; F
</code></pre>4 h. }2 @7 j$ e6 q* Z* F) V; i
<p>新建<code>Mutation.cs</code>用来定义相关接口:</p>, j" _' R0 S7 Y+ I2 \: u8 o
<ul>2 m L+ c4 t4 o5 v
<li><code>Mutation.cs</code></li>! {2 m. C, m) b; q- q
</ul>' C2 | d: X9 r; u& u
<pre><code class="language-c#">namespace PostGraphi.Api.GraphQL;
. {5 P6 q* Z* Q s3 ?7 d- L& T+ ^/ L6 T" a/ u0 M5 V
public class Mutation" z1 d) o7 |2 m4 `) c
{! P9 o8 [0 A) i1 g
public async Task<AddPostPayload> AddPostAsync(AddPostInput input, [Service] IRepository<Post> repository)3 l5 t4 T$ {6 h- Q' K# P
{
5 {) _8 O( H9 w& V; w6 n0 { return new AddPostPayload(await repository.AddAsync(new Post
/ P9 w3 H! N- d0 J5 z {
2 \0 T& a- n6 e7 j! g( A4 Y Title = input.Title, d* J' E6 `- y+ r
Author = input.Author$ n9 ?3 v9 B2 @$ x! N9 `
}));# W! e- i" H! z" a9 N. W: ]9 x
}* `! l' w$ H' Z) P
}
L# M6 z1 ?( M" ~; @
% X6 M% F/ S+ n3 @; L7 n$ n</code></pre>
5 a5 q2 p. u5 |5 ?" A<p>最后在注入服务的地方进行配置:</p>
/ h9 M& {. H; f8 p4 a1 O5 x<ul>3 k0 }& V+ X. `8 u# t5 C8 @
<li><code>ProgramExtensions.cs</code></li>: M1 J$ `) x. m% z9 C
</ul>; N* L# n. ^+ L, G3 h* X8 J
<pre><code class="language-c#">builder.Services, W& {1 K1 \* G! ?( m, J+ P u
.AddGraphQLServer()5 H- U. P9 i/ F/ W- S
.SetPagingOptions(new PagingOptions$ e7 c7 f8 H5 p# p* R# D
{
+ I/ g6 M1 j3 ` | MaxPageSize = 50,
* x' q' n) J3 o+ @ IncludeTotalCount = true9 r4 i! g3 e- j2 C' c1 n9 T
})5 d9 e. |# M8 Y5 k
.AddFiltering()
; }2 h2 J! {2 m( Y. q .AddProjections()9 `# B. p+ u2 R7 @2 S2 F2 g
.AddSorting()
/ A: p" O2 X/ h, R) [ .AddQueryType<Query>()
( E& A. q* p+ P .AddMutationType<Mutation>()
! f1 f$ Z4 g+ x6 V5 f .AddMutationConventions(new MutationConventionOptions0 `% K/ u3 i/ W* S" Y* F! |
{
; K3 Y0 T9 C' S1 e ApplyToAllMutations = true,+ w% S% p2 V1 D Y
InputArgumentName = "input",+ Z+ b/ F, U: M. G
InputTypeNamePattern = "{MutationName}Input",# c2 O; n! N. U' e3 F6 P
PayloadTypeNamePattern = "{MutationName}Payload",3 J0 g4 p6 |/ W& d0 U' M! l2 U" ~
PayloadErrorTypeNamePattern = "{MutationName}Error",
$ q9 V6 T% h/ y8 W R& Q$ n& g1 G PayloadErrorsFieldName = "errors"
, M" Z6 L9 r) h& Q% [ })1 z9 U% S0 _; N& D& Z1 e/ r/ \
.AddType<PostType>();
6 G7 S% Y$ w6 _# Q% G! {" u; W</code></pre>) U1 d; m/ ?! z' y0 k7 G0 S+ t
<p>这样就实现了新增Post的需求,下面我们来验证一下。</p>
2 h9 ]# z" R9 _& _% n4 H5 ?( d<h2 id="验证">验证</h2>) F. F G3 j2 F
<p>启动<code>Api</code>项目,调用接口:</p>. }+ o' `0 }& R8 q! F! m8 y' i A
<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104544617-1400586374.png" ></p>
6 D2 |) Y8 C2 P+ i0 |, L3 J4 l<p>终端的日志输出如下:</p>
4 A, A0 u/ d& 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']
! p$ a! o/ i: B# A% \: N8 i& H# j. X! KINSERT INTO "Posts" ("Id", "Abstraction", "Author", "Content", "Created", "CreatedBy", "LastModified", "LastModifiedBy", "Link", "PublishedAt", "Title")9 [- ]3 [6 k8 c* S F0 L3 d
VALUES (@p0, @p1, @p2, @p3, @p4, @p5, @p6, @p7, @p8, @p9, @p10);
) p. ]$ L) e& s. W" K; W) X[10:45:15 INF] Executed endpoint 'Hot Chocolate GraphQL Pipeline'
+ @+ ^% h( \+ U0 l</code></pre>
$ O3 \) @ ^0 z& g1 U, g. _) z7 S0 M<p>可以看到新建的Post已经存储到数据库中了,我们可以通过查询接口来获取详情:</p>3 g! _( D6 D& X
<p><img src="https://img2022.cnblogs.com/blog/2487237/202202/2487237-20220211104851825-1533915064.png" ></p>, X a2 j9 z0 A0 }1 h) G
<h2 id="总结">总结</h2>
/ B( d2 b& `' @) f; v4 E- i+ d<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>& G9 ], ~3 Z4 X4 ~0 N0 [% {
<p>在下一篇文章中,我们通过<code>Mutation</code>对已有数据进行更新。</p>
7 Y1 m1 M9 y, E# R* S0 D8 p" _$ Q+ y! V. z, z. T
|
|