为API增加成功和失败返回方法。

Falcon.SugarApi/ApiDefinistions/ApiControllerBase.cs

@@ -1,4 +1,5 @@
 using Falcon.SugarApi.DatabaseDefinitions;
+using Falcon.SugarApi.ModelValidation;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -6,6 +7,7 @@ using System;
 using System.Text.Encodings.Web;
 using System.Text.Json;
 using System.Text.Unicode;
+using System.Threading.Tasks;
 
 namespace Falcon.SugarApi.ApiDefinistions
 {
@@ -55,6 +57,8 @@ namespace Falcon.SugarApi.ApiDefinistions
             this.SugarDb = service.GetService<SugarDbContext>() ?? throw new NullReferenceException("SugarDbContext");
         }
 
+        #region 记录日志
+
         /// <summary>
         /// 保存文本日志
         /// </summary>
@@ -77,6 +81,9 @@ namespace Falcon.SugarApi.ApiDefinistions
             this.Logger.LogInformation(logmsg);
         }
 
+        #endregion
+
+
         /// <summary>
         /// 从对象序列化字符串
         /// </summary>
@@ -98,6 +105,21 @@ namespace Falcon.SugarApi.ApiDefinistions
             return JsonSerializer.Deserialize<T>(json);
         }
 
+        /// <summary>
+        /// 验证模型。如果失败抛出异常
+        /// </summary>
+        /// <param name="model">模型</param>
+        protected virtual void ModelValidation(object? model) {
+            model.ThrowNullExceptionWhenNull();
+            if(!model.TryModelValidation(out var errors)) {
+                ThrowApiException("传入的数据验证错误",null,e => {
+                    e.Data.Add("ModelValidation",errors);
+                });
+            }
+        }
+
+        #region 抛出异常
+
         /// <summary>
         /// 抛出api异常
         /// </summary>
@@ -132,5 +154,48 @@ namespace Falcon.SugarApi.ApiDefinistions
             exAction?.Invoke(ex);
             throw ex;
         }
+
+        #endregion
+
+
+        #region 返回api调用结果
+
+        /// <summary>
+        /// 同步返回成功的结果
+        /// </summary>
+        /// <typeparam name="T">data携带的数据类型</typeparam>
+        /// <param name="result">携带数据</param>
+        /// <returns>异步api结果</returns>
+        protected virtual ApiResult<T> SuccessResult<T>(T result)
+            => new() { Code = 0,Msg = "",Data = result,};
+
+        /// <summary>
+        /// 异步返回成功的结果
+        /// </summary>
+        /// <typeparam name="T">data携带的数据类型</typeparam>
+        /// <param name="result">携带数据</param>
+        /// <returns>异步api结果</returns>
+        protected virtual async Task<ApiResult<T>> SuccessResultAsync<T>(T result)
+            => await Task.FromResult(SuccessResult(result));
+
+        /// <summary>
+        /// 同步返回失败的结果
+        /// </summary>
+        /// <typeparam name="T">data携带的数据类型</typeparam>
+        /// <param name="failMessage">失败信息</param>
+        /// <returns>异步api结果</returns>
+        protected virtual ApiResult<T> FailResult<T>(string failMessage)
+            => new() { Code = 1,Msg = failMessage,};
+
+        /// <summary>
+        /// 异步返回失败的结果
+        /// </summary>
+        /// <typeparam name="T">data携带的数据类型</typeparam>
+        /// <param name="failMessage">失败信息</param>
+        /// <returns>异步api结果</returns>
+        protected virtual async Task<ApiResult<T>> FailResultAsync<T>(string failMessage)
+            => await Task.FromResult(FailResult<T>(failMessage));
+
+        #endregion
     }
 }

Falcon.SugarApi/ApiDefinistions/ApiResult.cs

@@ -0,0 +1,27 @@
+using System.Text.Json.Serialization;
+
+namespace Falcon.SugarApi.ApiDefinistions
+{
+    /// <summary>
+    /// api返回结果
+    /// </summary>
+    /// <typeparam name="T">携带的数据类型</typeparam>
+    public class ApiResult<T>
+    {
+        /// <summary>
+        /// 结果代码 0成功 1失败
+        /// </summary>
+        [JsonPropertyName("code")]
+        public int Code { get; set; }
+        /// <summary>
+        /// 失败信息
+        /// </summary>
+        [JsonPropertyName("msg")]
+        public string Msg { get; set; }
+        /// <summary>
+        /// 携带数据
+        /// </summary>
+        [JsonPropertyName("data")]
+        public T? Data { get; set; }
+    }
+}