feat(task): add extension methods for invoking tasks in scope context

Author: ruattd

FlowNet.Test/Core/FlowTaskTest.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Threading.Tasks;
 using FlowNet.Core;
 
@@ -9,6 +10,20 @@ public class FlowTaskTest
     [TestMethod]
     public async Task TaskInvoke()
     {
-        await FlowInterops.Initialize("app:test");
+        await FlowInterops.Initialize("app:test:test2");
+    }
+}
+
+[Flow.Scope("app:test")]
+public static partial class AppTest
+{
+    [Flow.Task]
+    public static int Test() => 114514;
+
+    [Flow.Task]
+    public static async Task Test2()
+    {
+        var r = await Context.InvokeTask<int>("test");
+        Console.WriteLine(r);
     }
 }

FlowNet/Core/FlowTask.cs

@@ -76,6 +76,54 @@ public static Task<TReturn> InvokeTask<TReturn, TArgument>(string globalIdentifi
                 : throw new KeyNotFoundException($"There is no task with identifier '{globalIdentifier}'.");
         }
     }
+
+    /// <summary>
+    /// 上下文中与 Flow 任务相关的扩展方法
+    /// </summary>
+    /// <param name="context">作用域上下文</param>
+    extension(ScopeContext context)
+    {
+        /// <summary>
+        /// 调用既无参数也无返回值的 Flow 任务，详情参考 <see cref="InvokeTask{TReturn, TArgument}(string, TArgument)"/>。
+        /// </summary>
+        public Task InvokeTask(string identifier)
+            => context.InvokeTask<None, None>(identifier, default);
+
+        /// <summary>
+        /// 调用无参数的 Flow 任务，详情参考 <see cref="InvokeTask{TReturn, TArgument}(string, TArgument)"/>。
+        /// </summary>
+        public Task<TReturn> InvokeTask<TReturn>(string identifier)
+            => context.InvokeTask<TReturn, None>(identifier, default);
+
+        /// <summary>
+        /// 调用无返回值的 Flow 任务，详情参考 <see cref="InvokeTask{TReturn, TArgument}(string, TArgument)"/>。
+        /// </summary>
+        public Task InvokeTask<TArgument>(string identifier, TArgument argument)
+            => context.InvokeTask<None, TArgument>(identifier, argument);
+
+        /// <summary>
+        /// 调用 Flow 任务，传入参数并获取返回值。<br/>
+        /// 当 <see cref="Flow.EnableTaskInvokingInfo"/> 为 <see langword="true"/>
+        /// 时，使用该方法及其变体调用任务会产生包含调用方和目标标识符的调用信息。
+        /// <b>NOTE</b>: 没有返回值或没有参数时用默认的 <see cref="None"/> 类型替代。
+        /// </summary>
+        /// <param name="identifier">任务标识符，可传入相对于当前作用域的短标识符，或包含作用域前缀的完整标识符</param>
+        /// <param name="argument">任务参数，若大于一个，则该值应传入 <see cref="ValueTuple"/></param>
+        /// <typeparam name="TReturn">返回值类型</typeparam>
+        /// <typeparam name="TArgument">参数类型</typeparam>
+        /// <returns>任务返回值</returns>
+        /// <exception cref="KeyNotFoundException">不存在指定全局标识的任务</exception>
+        public Task<TReturn> InvokeTask<TReturn, TArgument>(string identifier, TArgument argument)
+        {
+            var globalIdentifier = $"{context.Identifier}:{identifier}";
+            if (!ExistsTask(globalIdentifier)) globalIdentifier = identifier;
+            var invokingInfo = EnableTaskInvokingInfo ? new FlowTaskInvokingInfo {
+                DirectCaller = context.Identifier,
+                Target = globalIdentifier,
+            } : default;
+            return Internal.InvokeTask<TReturn, TArgument>(globalIdentifier, argument, invokingInfo);
+        }
+    }
 }
 
 public interface IFlowTask