update version

.github/workflows/main.yml

@@ -1,34 +0,0 @@
-name: CI
-
-on: [create]
-
-jobs:
-  build:
-    name: Build Project
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v1
-    - name: Setup .NET Core
-      uses: actions/setup-dotnet@v1
-      with:
-        dotnet-version: '3.1.101'
-    - name: Build
-      run: dotnet build
-  
-  publish:
-    needs: build
-    name: Publish Project to Nuget
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v1
-    - name: Setup .NET Core
-      uses: actions/setup-dotnet@v1
-      with:
-        dotnet-version: '3.1.101'
-    - name: Publish
-      run: |
-        version=`git describe --tags`
-        dotnet pack --configuration release -p:PackageVersion=$version
-        dotnet nuget push bin/release/YY-Tech.YYApi.$version.nupkg -k ${APIKEY} -s https://www.nuget.org/api/v2/package
-      env:
-        APIKEY: ${{ secrets.APPKEY }}

.github/workflows/nuget-publish.yml

@@ -0,0 +1,24 @@
+name: PublishNugetPackage
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  publish:
+    name: Publish Project to Nuget
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+      - name: Setup .NET Core
+        uses: actions/setup-dotnet@v1
+        with:
+          dotnet-version: "7.0.100"
+      - name: Publish
+        run: |
+          version=`git describe --tags`
+          dotnet build --configuration release -p:PackageVersion=$version
+          dotnet nuget push bin/release/Simcu.SimApi.$version.nupkg -k ${NUGET_APIKEY} -s https://www.nuget.org/api/v2/package
+        env:
+          NUGET_APIKEY: ${{ secrets.NUGET_APIKEY }}

Attributes/SimApiAuthAttribute.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Linq;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.Filters;
+using SimApi.Communications;
+using SimApi.Exceptions;
+
+namespace SimApi.Attributes
+{
+    /// <summary>
+    /// 检测登录中间件
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
+    public class SimApiAuthAttribute : ActionFilterAttribute
+    {
+        private string[] Types { get; }
+
+
+        //默认是user登录类型
+        public SimApiAuthAttribute()
+        {
+            Types = new[]
+            {
+                "user"
+            };
+        }
+
+        //只检测一种用户类型的快捷方式
+        public SimApiAuthAttribute(string type)
+        {
+            Types = type.Split(",");
+        }
+
+        //设定特定类型的检测
+        public SimApiAuthAttribute(string[] types)
+        {
+            Types = types;
+        }
+
+        //只检测一种用户类型的快捷方式
+        public SimApiAuthAttribute(string type, string url)
+        {
+            Types = new[]
+            {
+                type
+            };
+            new HttpPostAttribute(url);
+        }
+
+        public override void OnActionExecuting(ActionExecutingContext context)
+        {
+            var loginInfo = (SimApiLoginItem)context.HttpContext.Items["LoginInfo"];
+            //检测是否登录
+            if (loginInfo == null)
+            {
+                throw new SimApiException(401);
+            }
+            //检测用户类型
+            if (!Types.Intersect(loginInfo.Type).Any())
+            {
+                throw new SimApiException(403);
+            }
+        }
+    }
+}

Attributes/SimApiDocAttribute.cs

@@ -1,20 +1,20 @@
 using System;
 using Swashbuckle.AspNetCore.Annotations;
 
-namespace YYApi.Attributes
+namespace SimApi.Attributes
 {
     /// <summary>
     /// 快捷自定义接口文档类
     /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]
-    public class YYDocAttribute : SwaggerOperationAttribute
+    public class SimApiDocAttribute : SwaggerOperationAttribute
     {
         /// <summary>
         /// 定义接口说明
         /// </summary>
         /// <param name="tag">接口分组</param>
         /// <param name="name">接口名称</param>
-        public YYDocAttribute(string tag, string name)
+        public SimApiDocAttribute(string tag, string name)
         {
             Tags = new[] { tag };
             Summary = name;

Attributes/YYAuthAttribute.cs

@@ -1,50 +0,0 @@
-using System;
-using System.Linq;
-using Microsoft.AspNetCore.Mvc.Filters;
-using YYApi.Communications;
-using YYApi.Exceptions;
-
-namespace YYApi.Attributes
-{
-    /// <summary>
-    /// 检测登录中间件
-    /// </summary>
-    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
-    public class YYAuthAttribute : ActionFilterAttribute
-    {
-        private string[] Types { get; }
-
-        //默认是user登录类型
-        public YYAuthAttribute()
-        {
-            Types = new[] { "user" };
-        }
-
-        //只检测一种用户类型的快捷方式
-        public YYAuthAttribute(string type)
-        {
-            Types = new[] { type };
-        }
-
-        //设定特定类型的检测
-        public YYAuthAttribute(string[] types)
-        {
-            Types = types;
-        }
-
-        public override void OnActionExecuting(ActionExecutingContext context)
-        {
-            var loginInfo = (YYLoginItem)context.HttpContext.Items["LoginInfo"];
-            //检测是否登录
-            if (loginInfo == null)
-            {
-                throw new YYApiException(401);
-            }
-            //检测用户类型
-            if (Types.Intersect(loginInfo.Type).Count() == 0)
-            {
-                throw new YYApiException(403);
-            }
-        }
-    }
-}

Communications/SimApiBaseRequest.cs

@@ -0,0 +1,23 @@
+namespace SimApi.Communications
+{
+    /// <summary>
+    /// 只有ID的请求
+    /// </summary>
+    public record SimApiIdOnlyRequest(int Id);
+
+    /// <summary>
+    /// 只有ID的请求(字符串)
+    /// </summary>
+    public record SimApiStringIdOnlyRequest(string Id);
+
+    /// <summary>
+    /// 动态类型单字段请求
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public record SimApiOneFieldRequest<T>(T Data);
+
+    /// <summary>
+    /// 基础分页请求
+    /// </summary>
+    public record SimApiBasePageRequest(int Page, int Count);
+}

Communications/SimApiBaseResponse.cs

@@ -0,0 +1,76 @@
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace SimApi.Communications
+{
+    /// <summary>
+    /// 基础相应
+    /// </summary>
+    public record SimApiBaseResponse(int Code = 200, string Message = "成功")
+    {
+        /// <summary>
+        /// 默认错误代码对应提示信息
+        /// </summary>
+        private static readonly Dictionary<int, string> MsgBox = new()
+        {
+            {
+                200, "成功"
+            },
+            {
+                204, "没有数据"
+            },
+            {
+                400, "参数错误"
+            },
+            {
+                401, "需要登录"
+            },
+            {
+                403, "无权访问"
+            },
+            {
+                404, "接口不存在"
+            },
+            {
+                500, "服务器错误"
+            }
+        };
+
+        public SimApiBaseResponse(int code) : this(code, MsgBox.ContainsKey(code) ? MsgBox[code] : "未知错误")
+        {
+        }
+
+        /// <summary>
+        /// 序列化为JSON字符串
+        /// </summary>
+        /// <returns></returns>
+        public override string ToString()
+        {
+            return JsonSerializer.Serialize(this, new JsonSerializerOptions
+            {
+                IgnoreReadOnlyProperties = true,
+                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+                Converters =
+                {
+                    new JsonStringEnumConverter()
+                }
+            });
+        }
+    }
+
+    /// <summary>
+    /// 动态内容分页
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public record SimApiBasePageResponse<T>
+    (T List, int Page = 1, int Count = 1, int Total = 1, int Code = 200,
+        string Message = "成功") : SimApiBaseResponse(Code, Message);
+
+    /// <summary>
+    /// 动态Data返回
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public record SimApiBaseResponse<T>(T Data, int Code = 200, string Message = "成功") : SimApiBaseResponse(Code,
+        Message);
+}

Communications/SimApiLoginItem.cs

@@ -0,0 +1,7 @@
+namespace SimApi.Communications
+{
+    /// <summary>
+    /// 登录信息中间件
+    /// </summary>
+    public record SimApiLoginItem(string Id, string[] Type);
+}

Communications/YYBaseRequest.cs

@@ -1,20 +0,0 @@
-using System;
-namespace YYApi.Communications
-{
-    /// <summary>
-    /// 只有ID的请求
-    /// </summary>
-    public class YYIdOnlyRequest
-    {
-        public int Id { get; set; }
-    }
-
-    /// <summary>
-    /// 基础分页请求
-    /// </summary>
-    public class YYBasePageRequest
-    {
-        public int Page { get; set; }
-        public int Count { get; set; }
-    }
-}

Communications/YYBaseResponse.cs

@@ -1,132 +0,0 @@
-using System.Collections.Generic;
-using System.Text.Json;
-using System.Text.Json.Serialization;
-
-namespace YYApi.Communications
-{
-    /// <summary>
-    /// 基础相应
-    /// </summary>
-    public class YYBaseResponse
-    {
-        /// <summary>
-        /// 错误代码
-        /// </summary>
-        public int Code { get; set; }
-
-        /// <summary>
-        /// 错误描述
-        /// </summary>
-        public string Message { get; set; }
-
-        /// <summary>
-        /// 默认错误代码对应提示信息
-        /// </summary>
-        private readonly Dictionary<int, string> MsgBox = new Dictionary<int, string>()
-        {
-            {200, "成功"},
-            {204, "没有数据"},
-            {400, "参数错误"},
-            {401, "需要登录"},
-            {403, "无权访问"},
-            {404, "接口不存在"},
-            {500, "服务器错误"}
-        };
-
-        /// <summary>
-        /// 返回一个成功的空结果
-        /// </summary>
-        public YYBaseResponse()
-        {
-            SetCode(200);
-        }
-
-
-        /// <summary>
-        /// 返回指定代码的描述
-        /// </summary>
-        /// <param name="code">错误代码</param>
-        public YYBaseResponse(int code)
-        {
-            SetCode(code);
-        }
-
-        /// <summary>
-        /// 返回指定代码的结果,并自定义提示信息
-        /// </summary>
-        /// <param name="code">错误代码</param>
-        /// <param name="message">错误信息</param>
-        public YYBaseResponse(int code, string message)
-        {
-            SetCodeMsg(code, message);
-        }
-
-        /// <summary>
-        /// 设置响应结果的错误代码
-        /// </summary>
-        /// <param name="code">错误代码</param>
-        public void SetCode(int code)
-        {
-            Code = code;
-            Message = MsgBox.ContainsKey(code) ? MsgBox[code] : "未知错误";
-        }
-
-        /// <summary>
-        /// 设置响应结果的错误代码和错误描述
-        /// </summary>
-        /// <param name="code">错误代码</param>
-        /// <param name="message">错误描述</param>
-        public void SetCodeMsg(int code, string message)
-        {
-            SetCode(code);
-            if (!string.IsNullOrEmpty(message))
-            {
-                Message = message;
-            }
-        }
-
-        /// <summary>
-        /// 序列化为JSON字符串
-        /// </summary>
-        /// <returns></returns>
-        public override string ToString()
-        {
-            return JsonSerializer.Serialize(this, new JsonSerializerOptions
-            {
-                IgnoreReadOnlyProperties = true,
-                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
-                Converters = { new JsonStringEnumConverter() }
-            });
-        }
-    }
-
-    /// <summary>
-    /// 动态内容分页
-    /// </summary>
-    /// <typeparam name="T"></typeparam>
-    public class YYBasePageResponse<T> : YYBaseResponse
-    {
-        /// <summary>
-        /// 动态内容列表
-        /// </summary>
-        public T List { get; set; }
-        //当前页码
-        public int Page { get; set; }
-        //每页条数
-        public int Count { get; set; }
-        //总计条数
-        public int Total { get; set; }
-    }
-
-    /// <summary>
-    /// 动态Data返回
-    /// </summary>
-    /// <typeparam name="T"></typeparam>
-    public class YYBaseResponse<T> : YYBaseResponse
-    {
-        /// <summary>
-        /// 动态内容列表
-        /// </summary>
-        public T Data { get; set; }
-    }
-}

Communications/YYLoginItem.cs

@@ -1,14 +0,0 @@
-using System;
-namespace YYApi.Communications
-{
-    /// <summary>
-    /// 登录信息中间件
-    /// </summary>
-    public class YYLoginItem
-    {
-        //登录用户的ID
-        public int Id { get; set; }
-        //登录用户来源
-        public string[] Type { get; set; }
-    }
-}

Configurations/SimApiDocOptions.cs

@@ -0,0 +1,73 @@
+using System;
+using System.Collections.Generic;
+using Swashbuckle.AspNetCore.SwaggerUI;
+
+namespace SimApi.Configs
+{
+    /// <summary>
+    /// 文档组配置
+    /// </summary>
+    public class SimApiDocGroupOption
+    {
+        /// <summary>
+        /// 文档标识
+        /// </summary>
+        public string Id { get; set; }
+
+        /// <summary>
+        /// 文档名称
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// 文档描述
+        /// </summary>
+        public string Description { get; set; }
+    }
+
+    /// <summary>
+    /// 授权配置, Type支持 "SimApiAuth","ClientCredentials","Implicit","AuthorizationCode"
+    /// </summary>
+    public class SimApiAuthOption
+    {
+        public string[] Type { get; set; } = new[] {"SimApiAuth"};
+        public string Description { get; set; } = "认证服务器颁发的AccessToken";
+        public string AuthorizationUrl { get; set; }
+        public string TokenUrl { get; set; }
+        public Dictionary<string, string> Scopes { get; set; }
+    }
+
+    /// <summary>
+    /// 文档配置
+    /// </summary>
+    public class SimApiDocOptions
+    {
+        /// <summary>
+        /// 文档组配置
+        /// </summary>
+        public SimApiDocGroupOption[] ApiGroups { get; set; } = new[]
+        {
+            new SimApiDocGroupOption
+            {
+                Id = "api",
+                Name = "Api",
+                Description = "Api接口文档"
+            }
+        };
+
+        /// <summary>
+        /// 授权配置
+        /// </summary>
+        public SimApiAuthOption ApiAuth { get; set; } = new SimApiAuthOption();
+
+        /// <summary>
+        /// 文档页面标题
+        /// </summary>
+        public string DocumentTitle { get; set; } = "API接口文档";
+        
+        /// <summary>
+        /// 接口支持的调用方式
+        /// </summary>
+        public SubmitMethod[] SupportedMethod { get; set; } = new[] {SubmitMethod.Post};
+    }
+}

Configurations/SimApiOptions.cs

@@ -0,0 +1,76 @@
+using System;
+
+namespace SimApi.Configs
+{
+    public class SimApiOptions
+    {
+        /// <summary>
+        /// 启用全部Cors，对于开发前后分离的时候很有用。
+        /// default: true
+        /// </summary>
+        public bool EnableCors { get; set; } = true;
+
+        /// <summary>
+        /// 启用SimapiAuth，一个简单的基于Header Token的认证方式。
+        /// default: false
+        /// </summary>
+        public bool EnableSimApiAuth { get; set; } = false;
+
+        /// <summary>
+        /// 启用在线文档，启用后 访问 /swagger 可以查看对应的api文档。
+        /// default: false
+        /// </summary>
+        public bool EnableSimApiDoc { get; set; } = false;
+
+        /// <summary>
+        /// 启用异常拦截,启用后，所有的异常将被通过json反馈。
+        /// default: true
+        /// </summary>
+        public bool EnableSimApiException { get; set; } = true;
+
+        /// <summary>
+        /// 开启S3兼容的存储系统。
+        /// default: false
+        /// </summary>
+        public bool EnableSimApiStorage { get; set; } = false;
+
+        /// <summary>
+        /// 开启ForwardHeaders,开启后可以透传负载均衡的Headers
+        /// default: true
+        /// </summary>
+        public bool EnableForwardHeaders { get; set; } = true;
+
+        /// <summary>
+        /// 将所有的url都格式化为小写字母
+        /// default: true
+        /// </summary>
+        public bool EnableLowerUrl { get; set; } = true;
+
+        /// <summary>
+        /// 启用格式化的 Console Logger
+        /// default: false
+        /// </summary>
+        public bool EnableLogger { get; set; } = false;
+
+        /// <summary>
+        /// Swagger文档相关配置，需要启用 EnableSimApiDoc
+        /// </summary>
+        public SimApiDocOptions SimApiDocOptions { get; set; } = new SimApiDocOptions();
+
+        /// <summary>
+        /// S3兼容的存储系统配置，需要启用 EnableSimApiStorage
+        /// </summary>
+        public SimApiStorageOptions SimApiStorageOptions { get; set; } = new SimApiStorageOptions();
+
+
+        public void ConfigureSimApiDoc(Action<SimApiDocOptions> options = null)
+        {
+            options?.Invoke(SimApiDocOptions);
+        }
+
+        public void ConfigureSimApiStorage(Action<SimApiStorageOptions> options = null)
+        {
+            options?.Invoke(SimApiStorageOptions);
+        }
+    }
+}

Configurations/SimApiStorageOptions.cs

@@ -0,0 +1,24 @@
+namespace SimApi.Configs
+{
+    public class SimApiStorageOptions
+    {
+        /// <summary>
+        /// S3 服务器入口地址
+        /// </summary>
+        public string Endpoint { get; set; }
+
+        /// <summary>
+        /// S3 服务器文件访问地址
+        /// </summary>
+        public string ServeUrl { get; set; }
+
+        /// <summary>
+        /// S3服务 Bucket
+        /// </summary>
+        public string Bucket { get; set; }
+
+        public string AccessKey { get; set; }
+
+        public string SecretKey { get; set; }
+    }
+}

Controllers/SimApiBaseController.cs

@@ -1,11 +1,12 @@
-using YYApi.Communications;
+using SimApi.Communications;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.Mvc.Filters;
 using Microsoft.AspNetCore.Mvc.ModelBinding;
 using System.Linq;
-using YYApi.Exceptions;
+using SimApi.Exceptions;
+using SimApi.Attributes;
 
-namespace YYApi.Controllers
+namespace SimApi.Controllers
 {
     /// <summary>
     /// 基础控制器,所有控制器均继承本控制器
@@ -13,12 +14,12 @@ namespace YYApi.Controllers
     /// 2. 报错返回
     /// 3. 错误回馈页面
     /// </summary>
-    public class YYBaseController : Controller
+    public class SimApiBaseController : Controller
     {
         /// <summary>
         /// 当前登录用户的ID
         /// </summary>
-        protected YYLoginItem LoginInfo => (YYLoginItem)HttpContext.Items["LoginInfo"];
+        protected SimApiLoginItem LoginInfo => (SimApiLoginItem)HttpContext.Items["LoginInfo"];
 
         /// <summary>
         /// 验证请求参数
@@ -28,13 +29,11 @@ namespace YYApi.Controllers
         {
             if (!context.ModelState.IsValid)
             {
-                foreach (var item in context.ModelState.Values)
+                foreach (var item in context.ModelState.Values.Where(item =>
+                             item.ValidationState == ModelValidationState.Invalid))
                 {
-                    if (item.ValidationState == ModelValidationState.Invalid)
-                    {
-                        Error(400, item.Errors.First().ErrorMessage);
-                        break;
-                    }
+                    Error(400, item.Errors.First().ErrorMessage);
+                    break;
                 }
             }
         }
@@ -48,7 +47,7 @@ namespace YYApi.Controllers
         /// <returns></returns>
         protected static void Error(int code = 500, string message = "")
         {
-            throw new YYApiException(code, message);
+            throw new SimApiException(code, message);
         }
 
         /// <summary>
@@ -71,28 +70,18 @@ namespace YYApi.Controllers
         /// <param name="condition">检测条件</param>
         /// <param name="code">错误代码</param>
         /// <param name="message">错误描述</param>
-        protected static void ErrorWhenNull(object condition, int code = 404, string message = "请求的资源不存在")
+        protected static void ErrorWhenNull(object condition, int code = 404, string message = "")
         {
             ErrorWhen(condition == null, code, message);
         }
 
         /// <summary>
-        /// 错误回馈页面
+        /// 上传文件
         /// </summary>
-        /// <param name="code">错误代码</param>
         /// <returns></returns>
-        [HttpGet("exception/{code:int}")]
-        [ApiExplorerSettings(IgnoreApi = true)]
-        public YYBaseResponse ExceptionHandler(int code)
+        protected SimApiBaseResponse<string> UploadFile()
         {
-            var response = new YYBaseResponse();
-            response.SetCode(code);
-            return response;
-        }
-
-        protected YYBaseResponse<string> UploadFile()
-        {
-            return new YYBaseResponse<string>();
+            return new SimApiBaseResponse<string>(null);
         }
     }
 }

Controllers/SimApiCommonController.cs

@@ -0,0 +1,60 @@
+using System;
+using Microsoft.AspNetCore.Mvc;
+using SimApi.Attributes;
+using SimApi.Communications;
+using SimApi.Helpers;
+
+namespace SimApi.Controllers
+{
+    [ApiExplorerSettings(GroupName = "api")]
+    public class YYCommonController : SimApiBaseController
+    {
+        private SimApiAuth Auth { get; }
+
+        public YYCommonController(SimApiAuth auth)
+        {
+            Auth = auth;
+        }
+
+        /// <summary>
+        /// 错误回馈页面
+        /// </summary>
+        /// <param name="code">错误代码</param>
+        /// <returns></returns>
+        [HttpGet("exception/{code:int}")]
+        [ApiExplorerSettings(IgnoreApi = true)]
+        public SimApiBaseResponse ExceptionHandler(int code)
+        {
+            return new SimApiBaseResponse(code);
+        }
+
+        /// <summary>
+        /// 检测用户登陆的控制器
+        /// </summary>
+        /// <returns></returns>
+        [HttpPost("/auth/check"), SimApiDoc("认证", "检测登陆")]
+        public SimApiBaseResponse<string> CheckLogin()
+        {
+            ErrorWhenNull(LoginInfo, 401);
+            return new SimApiBaseResponse<string>(LoginInfo.Id);
+        }
+
+        /// <summary>
+        /// 退出登陆
+        /// </summary>
+        /// <returns></returns>
+        [HttpPost("/auth/logout"), SimApiDoc("认证", "退出登陆")]
+        public SimApiBaseResponse Logout()
+        {
+            string token = null;
+
+            if (Request.Headers.ContainsKey("Token"))
+            {
+                token = Request.Headers["Token"];
+            }
+
+            Auth.Logout(token);
+            return new SimApiBaseResponse();
+        }
+    }
+}

Exceptions/SimApiException.cs

@@ -1,14 +1,14 @@
 using System;
-namespace YYApi.Exceptions
+namespace SimApi.Exceptions
 {
     /// <summary>
     /// Api错误捕获异常
     /// </summary>
-    public class YYApiException : Exception
+    public class SimApiException : Exception
     {
         public int Code { get; }
 
-        public YYApiException(int code, string message = "") : base(message)
+        public SimApiException(int code, string message = "") : base(message)
         {
             Code = code;
         }

Extensions.cs

@@ -1,173 +0,0 @@
-using System;
-using YYApi.Helpers;
-using Microsoft.AspNetCore.Builder;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.OpenApi.Models;
-using Swashbuckle.AspNetCore.SwaggerUI;
-using YYApi.Middlewares;
-
-namespace YYApi
-{
-    /// <summary>
-    /// 加入系统的扩展信息
-    /// </summary>
-    public static class Extensions
-    {
-        //**********快捷添加**************
-
-        /// <summary>
-        /// 添加整个YYAPI,同时增加CORS规则
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <param name="title"></param>
-        /// <param name="description"></param>
-        /// <returns></returns>
-        public static IServiceCollection AddYYApi(this IServiceCollection builder, string title,
-            string description = null)
-        {
-            return builder.AddYYAuth().AddYYDoc(title, description).AddCors().AddYYUpload();
-        }
-
-        /// <summary>
-        ///  使用所有YYApi自定义中间件
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <param name="title"></param>
-        /// <param name="staticFileroot"></param>
-        /// <param name="submitMethods"></param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYApi(this IApplicationBuilder builder, string title = "API文档", params SubmitMethod[] submitMethods)
-        {
-            return builder.UseYYException().UseYYDoc(title, submitMethods).UseMiddleware<YYAuthMiddleware>().UseCors(x => x.AllowAnyHeader().AllowAnyMethod().AllowAnyOrigin()).UseYYUpload();
-        }
-
-
-
-        //*********组件快捷方式*************
-
-        /// <summary>
-        /// 添加自定义授权认证中间价
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <returns></returns>
-        public static IServiceCollection AddYYAuth(this IServiceCollection builder)
-        {
-            return builder.AddScoped<YYAuth>();
-        }
-
-        /// <summary>
-        /// 添加Base64上传组件
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <returns></returns>
-        public static IServiceCollection AddYYUpload(this IServiceCollection builder)
-        {
-            return builder.AddSingleton<YYUpload>();
-        }
-
-        /// <summary>
-        /// 添加Api文档服务
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <param name="title">文档标题</param>
-        /// <param name="description">文档描述</param>
-        /// <returns></returns>
-        public static IServiceCollection AddYYDoc(this IServiceCollection builder, string title,
-            string description = null)
-        {
-            return builder.AddSwaggerGen(x =>
-            {
-                x.SwaggerDoc("api", new OpenApiInfo { Title = title, Description = description });
-                x.EnableAnnotations();
-                x.AddSecurityRequirement(new OpenApiSecurityRequirement
-                {
-                    {
-                        new OpenApiSecurityScheme
-                        {
-                            Reference = new OpenApiReference {Type = ReferenceType.SecurityScheme, Id = "HeaderToken"}
-                        },
-                        new[] {"readAccess", "writeAccess"}
-                    }
-                });
-                x.AddSecurityDefinition("HeaderToken",
-                    new OpenApiSecurityScheme { Name = "Token", In = ParameterLocation.Header });
-            });
-        }
-
-
-        /// <summary>
-        /// 使用异常中间价扩展
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYException(this IApplicationBuilder builder)
-        {
-            return builder.UseMiddleware<YYExceptionMiddleware>();
-        }
-
-        /// <summary>
-        /// 配置上传组件必须
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYUpload(this IApplicationBuilder builder)
-        {
-            return builder.UseStaticFiles();
-        }
-
-        /// <summary>
-        /// 使用文档UI
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <param name="title">文档标题</param>
-        /// <param name="submitMethods">文档支持的提交方式(如果不指定,默认使用POST)</param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYDoc(this IApplicationBuilder builder, string title,
-            params SubmitMethod[] submitMethods)
-        {
-            return builder.UseSwagger(x => x.RouteTemplate = "docs/{documentName}.json").UseSwaggerUI(x =>
-            {
-                x.RoutePrefix = "docs";
-                x.DocumentTitle = title;
-                x.SwaggerEndpoint("/docs/api.json", name: title);
-                x.EnableValidator();
-                if (submitMethods.Length > 0)
-                {
-                    x.SupportedSubmitMethods(submitMethods);
-                }
-                else
-                {
-                    x.SupportedSubmitMethods(SubmitMethod.Post);
-                }
-
-                x.DisplayRequestDuration();
-            });
-        }
-
-
-        /// <summary>
-        /// 同时使用Api文档和异常处理中间件
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <param name="title">文档标题</param>
-        /// <param name="submitMethods">API提交方式定义</param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYDocEx(this IApplicationBuilder builder, string title = "API文档",
-            params SubmitMethod[] submitMethods)
-        {
-            return builder.UseYYException().UseYYDoc(title, submitMethods);
-        }
-
-        /// <summary>
-        /// 使用自定义认证中间件（依赖IDistributedCache）
-        /// </summary>
-        /// <param name="builder"></param>
-        /// <returns></returns>
-        public static IApplicationBuilder UseYYAuth(this IApplicationBuilder builder)
-        {
-            return builder.UseMiddleware<YYAuthMiddleware>();
-        }
-
-
-    }
-}

Helpers/SimApiAuth.cs

@@ -0,0 +1,60 @@
+using System;
+using System.Text.Json;
+using Microsoft.AspNetCore.Http;
+using Microsoft.Extensions.Caching.Distributed;
+using SimApi.Communications;
+
+namespace SimApi.Helpers
+{
+    /// <summary>
+    /// 认证助手
+    /// </summary>
+    public class SimApiAuth
+    {
+        private IDistributedCache Cache { get; }
+
+        public SimApiAuth(IDistributedCache cache)
+        {
+            Cache = cache;
+        }
+
+        /// <summary>
+        /// 产生一个Token记录并返回Token
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
+        public string Login(string id, string type = "user", string token = null)
+        {
+            return Login(id, new[]
+            {
+                type
+            }, token);
+        }
+
+        /// <summary>
+        /// 产生一个Token并记录用户ID角色[多角色]
+        /// </summary>
+        /// <param name="id"></param>
+        /// <param name="type"></param>
+        /// <returns></returns>
+        public string Login(string id, string[] type, string uuid = null)
+        {
+            uuid ??= Guid.NewGuid().ToString();
+            var loginItem = new SimApiLoginItem(id, type);
+            Cache.SetString(uuid, JsonSerializer.Serialize(loginItem));
+            return uuid;
+        }
+
+        /// <summary>
+        /// 退出登陆
+        /// </summary>
+        /// <param name="uuid">登陆标识</param>
+        public void Logout(string uuid)
+        {
+            if (!string.IsNullOrEmpty(uuid))
+            {
+                Cache.Remove(uuid);
+            }
+        }
+    }
+}

Helpers/SimApiStorage.cs

@@ -0,0 +1,103 @@
+using System;
+using System.IO;
+using Microsoft.AspNetCore.Http;
+using Minio;
+using Minio.Exceptions;
+using SimApi.Configs;
+
+namespace SimApi.Helpers
+{
+    public class SimApiStorage
+    {
+        private MinioClient Mc { get; }
+
+        public MinioClient Client => Mc;
+
+        private string ServeUrl { get; }
+
+        public string Bucket { get; }
+
+        private IHttpContextAccessor HttpContextAccessor { get; }
+
+        public SimApiStorage(SimApiOptions apiOptions, IHttpContextAccessor httpContextAccessor)
+        {
+            var options = apiOptions.SimApiStorageOptions;
+            HttpContextAccessor = httpContextAccessor;
+            var useSsl = false;
+            string endpoint;
+            if (options.Endpoint.StartsWith("http://"))
+            {
+                endpoint = options.Endpoint.Replace("http://", string.Empty);
+            }
+            else if (options.Endpoint.StartsWith("https://"))
+            {
+                endpoint = options.Endpoint.Replace("https://", string.Empty);
+                useSsl = true;
+            }
+            else
+            {
+                throw new Exception("SimApiStorage: Error Endpoint");
+            }
+
+            ServeUrl = options.ServeUrl;
+            Bucket = options.Bucket;
+            var mcb = new MinioClient().WithEndpoint(endpoint)
+                .WithCredentials(options.AccessKey, options.SecretKey);
+            if (useSsl)
+            {
+                mcb = mcb.WithSSL();
+            }
+            Mc = mcb.Build();
+
+            var found = Mc.BucketExistsAsync(new BucketExistsArgs().WithBucket(Bucket)).Result;
+            if (!found)
+            {
+                Mc.MakeBucketAsync(new MakeBucketArgs().WithBucket(Bucket)).Wait();
+            }
+        }
+
+        /// <summary>
+        /// 获取上传的URL
+        /// </summary>
+        /// <param name="path"></param>
+        /// <param name="expire"></param>
+        /// <returns></returns>
+        public string GetUploadUrl(string path, int expire = 7200)
+        {
+            return Mc.PresignedPutObjectAsync(new PresignedPutObjectArgs().WithBucket(Bucket)
+                .WithObject(path).WithExpiry(expire)).Result;
+        }
+
+        /// <summary>
+        /// 获取下载的URL
+        /// </summary>
+        /// <param name="path"></param>
+        /// <param name="expire"></param>
+        /// <returns></returns>
+        public string GetDownloadUrl(string path, int expire = 600)
+        {
+            return Mc.PresignedGetObjectAsync(new PresignedGetObjectArgs().WithBucket(Bucket).WithObject(path)
+                .WithExpiry(expire)).Result;
+        }
+
+
+        public string UploadFile(string path, Stream stream, string contentType = "image/png")
+        {
+            Mc.PutObjectAsync(new PutObjectArgs().WithBucket(Bucket).WithObject(path).WithObjectSize(stream.Length)
+                .WithStreamData(stream).WithContentType(contentType)).Wait();
+            return null;
+        }
+
+        public string FullUrl(string path)
+        {
+            var httpRequest = HttpContextAccessor.HttpContext?.Request;
+            var url = $"{httpRequest?.Scheme}://{httpRequest?.Host}";
+            if (string.IsNullOrEmpty(path))
+            {
+                return path;
+            }
+
+            return path.StartsWith("~") ? url + path.Substring(1, path.Length - 1) : $"{ServeUrl}{path}";
+        }
+    }
+}

Helpers/SimApiUtil.cs

@@ -1,12 +1,31 @@
 using System;
 using System.Security.Cryptography;
 using System.Text;
+using System.Text.Encodings.Web;
+using System.Text.Json;
 using System.Text.RegularExpressions;
+using System.Text.Unicode;
 
-namespace YYApi.Helpers
+namespace SimApi.Helpers
 {
-    public static class YYUtil
+    public static class SimApiUtil
     {
+        /// <summary>
+        /// 当前CST时间
+        /// </summary>
+        public static DateTime CstNow
+        {
+            get => DateTime.UtcNow.AddHours(8);
+        }
+
+        /// <summary>
+        /// 当前秒级时间戳
+        /// </summary>
+        public static double TimestampNow
+        {
+            get => (DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0)).TotalSeconds;
+        }
+
         /// <summary>
         /// 检测手机号是否正确
         /// </summary>
@@ -14,7 +33,7 @@ namespace YYApi.Helpers
         /// <returns></returns>
         public static bool CheckCell(string cell)
         {
-            var regex = new Regex("^1[34578]\\d{9}$");
+            var regex = new Regex("^1[3456789]\\d{9}$");
             return regex.IsMatch(cell);
         }
 
@@ -37,5 +56,18 @@ namespace YYApi.Helpers
 
             return strbul.ToString();
         }
+
+        /// <summary>
+        /// 将对象序列化成JSON （控制台输出中文不会被编码）
+        /// </summary>
+        /// <param name="obj"></param>
+        /// <returns></returns>
+        public static string Json(object obj)
+        {
+            return JsonSerializer.Serialize(obj, new JsonSerializerOptions
+            {
+                Encoder = JavaScriptEncoder.Create(UnicodeRanges.All)
+            });
+        }
     }
 }

Helpers/YYAuth.cs

@@ -1,50 +0,0 @@
-using System;
-using System.Text.Json;
-using Microsoft.AspNetCore.Http;
-using Microsoft.Extensions.Caching.Distributed;
-using YYApi.Communications;
-
-namespace YYApi.Helpers
-{
-    /// <summary>
-    /// 认证助手
-    /// </summary>
-    public class YYAuth
-    {
-        private IDistributedCache Cache { get; }
-
-        public YYAuth(IDistributedCache cache)
-        {
-            Cache = cache;
-        }
-
-        /// <summary>
-        /// 产生一个Token记录并返回Token
-        /// </summary>
-        /// <param name="id"></param>
-        /// <returns></returns>
-        public string Set(int id, string type = "user")
-        {
-            return Set(id, new[] { type });
-        }
-
-        /// <summary>
-        /// 产生一个TOken并记录用户ID角色[多角色]
-        /// </summary>
-        /// <param name="id"></param>
-        /// <param name="type"></param>
-        /// <returns></returns>
-        public string Set(int id, string[] type)
-        {
-            var uuid = Guid.NewGuid().ToString();
-            var loginItem = new YYLoginItem
-            {
-                Id = id,
-                Type = type
-            };
-            Cache.SetString(uuid, JsonSerializer.Serialize(loginItem));
-            return uuid;
-        }
-
-    }
-}

Helpers/YYUpload.cs

@@ -1,82 +0,0 @@
-using System;
-using System.IO;
-using Microsoft.AspNetCore.Hosting;
-
-namespace YYApi.Helpers
-{
-    public class YYUpload
-    {
-        private string FilePathFolder = "/uploads/";
-        public string FilePath
-        {
-            set
-            {
-                if (!value.StartsWith("/"))
-                {
-                    FilePathFolder = $"/{value}";
-                }
-                if (!FilePathFolder.EndsWith("/"))
-                {
-                    FilePathFolder += "/";
-                }
-            }
-            get
-            {
-                return FilePathFolder;
-            }
-        }
-
-        private IWebHostEnvironment Env { get; }
-
-        public YYUpload(IWebHostEnvironment env)
-        {
-            Env = env;
-        }
-
-        /// <summary>
-        /// 保存base64文件,如果有标头按照标头自动识别
-        /// </summary>
-        /// <param name="base64"></param>
-        /// <param name="ext">扩展名</param>
-        /// <param name="path">存放路径</param>
-        /// <param name="fileName">文件名</param>
-        /// <returns></returns>
-        public string SaveFile(string base64, string ext = null, string path = null, string fileName = null)
-        {
-            byte[] bt;
-            var filePath = FilePath + path;
-            if (fileName == null)
-            {
-                fileName = Guid.NewGuid().ToString();
-            }
-            var baseArr = base64.Split(";");
-            if (baseArr.Length == 2)
-            {
-                var info = baseArr[0].Split(":")[1].Split("/");
-                if (path == null)
-                {
-                    filePath += $"{info[0]}/";
-                }
-                if (ext == null)
-                {
-                    ext = info[1];
-                }
-                var data = baseArr[1].Split(",");
-                bt = Convert.FromBase64String(data[1]);
-            }
-            else
-            {
-                bt = Convert.FromBase64String(base64);
-            }
-
-            var realPath = Directory.GetCurrentDirectory() + "/wwwroot" + filePath;
-            if (!Directory.Exists(realPath))
-            {
-                Directory.CreateDirectory(realPath);
-            }
-            var fn = fileName + (string.IsNullOrEmpty(ext) ? string.Empty : $".{ext}");
-            File.WriteAllBytes(realPath + fn, bt);
-            return filePath + fn;
-        }
-    }
-}

JobService/YYHFDashboardAuth.cs

@@ -1,124 +0,0 @@
-using System;
-using Hangfire.Dashboard;
-using Microsoft.Extensions.Configuration;
-using Microsoft.AspNetCore.Http;
-using StackExchange.Redis;
-using System.Collections.Generic;
-using System.Text;
-using System.Security.Cryptography;
-
-namespace YYApi.JobService
-{
-    /// <summary>
-    /// Redis缓存Key定义
-    /// </summary>
-    public struct CacheKey
-    {
-        public const string HangfireDashboardAuthPrefix = "{hangfire}:dashboard:auth:";
-    }
-
-    /// <summary>
-    /// HangFire Dashboard Digest认证.
-    /// </summary>
-    public class YYHFDashboardAuth : IDashboardAuthorizationFilter
-    {
-        private IConfiguration _config { get; }
-        private IDatabase _redis { get; }
-        public YYHFDashboardAuth(IConfiguration config, IDatabase redis)
-        {
-            _redis = redis;
-            _config = config;
-        }
-
-        public bool Authorize(DashboardContext context)
-        {
-            var http = context.GetHttpContext();
-            if (http.Request.Headers.ContainsKey("Authorization"))
-            {
-                var authObj = _processAuthHeader(http.Request.Headers["Authorization"].ToString());
-                if (http.Request.QueryString.ToString().Contains("logout"))
-                {
-                    _redis.KeyDelete(CacheKey.HangfireDashboardAuthPrefix + authObj["opaque"]);
-                    _redirect(http);
-                    return true;
-                }
-                if (authObj["username"] == _config["Hangfire:User"])
-                {
-                    var a1 = _md5(string.Format("{0}:Need Login:{1}", authObj["username"], _config["Hangfire:Pass"]));
-                    var a2 = _md5(string.Format("{0}:{1}", http.Request.Method, authObj["uri"]));
-                    var nonce = _redis.StringGet(CacheKey.HangfireDashboardAuthPrefix + authObj["opaque"]);
-                    var validCode = _md5(string.Format("{0}:{1}:{2}:{3}:{4}:{5}", a1, nonce, authObj["nc"], authObj["cnonce"], authObj["qop"], a2));
-                    if (authObj["response"] == validCode)
-                    {
-                        _redis.StringSet(CacheKey.HangfireDashboardAuthPrefix + authObj["opaque"], nonce, new TimeSpan(0, 5, 0));
-                        return true;
-                    }
-                }
-            }
-            _challenge(http);
-            return false;
-        }
-
-        /// <summary>
-        /// 生成401认证header
-        /// </summary>
-        /// <returns>The challenge.</returns>
-        private void _challenge(HttpContext http)
-        {
-            var response = http.Response;
-            var guid = Guid.NewGuid().ToString();
-            var opaque = _md5(guid);
-            _redis.StringSet(CacheKey.HangfireDashboardAuthPrefix + opaque, guid, new TimeSpan(0, 0, 30));
-            response.StatusCode = 401;
-            response.Headers.Add("WWW-Authenticate", string.Format("Digest realm=\"Need Login\",qop=\"auth\",nonce=\"{0}\",opaque=\"{1}\"", guid, opaque));
-        }
-
-        /// <summary>
-        /// 跳转到页面不附加参数
-        /// </summary>
-        /// <param name="http">Http.</param>
-        private void _redirect(HttpContext http)
-        {
-            var response = http.Response;
-            response.StatusCode = 302;
-            response.Headers.Add("Location", (http.Request.PathBase + http.Request.Path).ToString());
-        }
-
-        /// <summary>
-        /// 处理DigestHeader中的参数为字典
-        /// </summary>
-        /// <returns>The auth header.</returns>
-        /// <param name="authData">Auth data.</param>
-        private Dictionary<string, string> _processAuthHeader(string authData)
-        {
-            var authDataArray = authData.Replace("Digest ", string.Empty).Replace("\"", string.Empty).Split(", ");
-            var authDic = new Dictionary<string, string>();
-            foreach (var item in authDataArray)
-            {
-                var tmp = item.Split("=", 2);
-                authDic.Add(tmp[0], tmp[1]);
-            }
-            return authDic;
-        }
-
-        /// <summary>
-        /// 计算字符串32位MD5
-        /// </summary>
-        /// <returns>The md5.</returns>
-        /// <param name="source">Source.</param>
-        private string _md5(string source)
-        {
-            byte[] sor = Encoding.UTF8.GetBytes(source);
-            var md5 = MD5.Create();
-            byte[] result = md5.ComputeHash(sor);
-            StringBuilder strbul = new StringBuilder(40);
-            for (int i = 0; i < result.Length; i++)
-            {
-                strbul.Append(result[i].ToString("x2"));//加密结果"x2"结果为32位,"x3"结果为48位,"x4"结果为64位
-
-            }
-            return strbul.ToString();
-
-        }
-    }
-}

JobService/YYJobDashboardConfig.cs

@@ -1,10 +0,0 @@
-using System;
-namespace YYApi.JobService
-{
-    public class JobDashboardConfig
-    {
-        public string Path { get; set; }
-        public string Username { get; set; }
-        public string Password { get; set; }
-    }
-}

JobService/YYJobStorage.cs

@@ -1,10 +0,0 @@
-using System;
-namespace YYApi.JobService
-{
-    public class JobStorage
-    {
-        public JobStorage()
-        {
-        }
-    }
-}

Logger/SimApiLogger.cs

@@ -0,0 +1,45 @@
+using System;
+using Microsoft.Extensions.Logging;
+using SimApi.Helpers;
+
+namespace SimApi.Logger
+{
+    public class SimApiLogger : ILogger
+    {
+        private string Name { get; }
+
+        public SimApiLogger(string name)
+        {
+            Name = name;
+        }
+
+        public IDisposable BeginScope<TState>(TState state) => default!;
+
+        public bool IsEnabled(LogLevel logLevel) => true;
+
+        public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception,
+            Func<TState, Exception, string> formatter)
+        {
+            var defautColor = Console.ForegroundColor;
+            Console.ForegroundColor = logLevel switch
+            {
+                LogLevel.Debug => ConsoleColor.DarkMagenta,
+                LogLevel.Information => ConsoleColor.DarkCyan,
+                LogLevel.Warning => ConsoleColor.Yellow,
+                LogLevel.Error => ConsoleColor.Red,
+                LogLevel.Critical => ConsoleColor.DarkRed,
+                _ => defautColor
+            };
+            Console.WriteLine(
+                $"[ {Name} ][ {SimApiUtil.CstNow.ToString("yyyy-MM-dd HH:mm:ss:ffff")} ][ {logLevel.ToString()} ]");
+            Console.ForegroundColor = defautColor;
+            Console.WriteLine($"{state}");
+            if (exception != null)
+            {
+                Console.WriteLine($"{exception}");
+            }
+
+            Console.WriteLine();
+        }
+    }
+}

Logger/SimApiLoggerConfiguration.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.Extensions.Logging;
+
+namespace SimApi.Logger;
+
+public class SimApiLoggerConfiguration
+{
+    public int EventId { get; set; }
+
+    public Dictionary<LogLevel, ConsoleColor> LogLevels { get; set; } = new()
+    {
+        [LogLevel.Information] = ConsoleColor.Green
+    };
+}

Logger/SimApiLoggerProvider.cs

@@ -0,0 +1,22 @@
+using System.Collections.Concurrent;
+using Microsoft.Extensions.Logging;
+
+namespace SimApi.Logger
+{
+    public class SimApiLoggerProvider : ILoggerProvider
+    {
+        private readonly ConcurrentDictionary<string, SimApiLogger> _loggers =
+            new ConcurrentDictionary<string, SimApiLogger>();
+
+
+        public ILogger CreateLogger(string categoryName)
+        {
+            return _loggers.GetOrAdd(categoryName, name => new SimApiLogger(name));
+        }
+
+        public void Dispose()
+        {
+            _loggers.Clear();
+        }
+    }
+}

Middlewares/SimApiAuthMiddleware.cs

@@ -2,18 +2,18 @@
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.Caching.Distributed;
-using YYApi.Communications;
+using SimApi.Communications;
 
-namespace YYApi.Middlewares
+namespace SimApi.Middlewares
 {
     /// <summary>
     /// 认证信息获取中间件
     /// </summary>
-    public class YYAuthMiddleware
+    public class SimApiAuthMiddleware
     {
         private RequestDelegate Next { get; }
 
-        public YYAuthMiddleware(RequestDelegate next)
+        public SimApiAuthMiddleware(RequestDelegate next)
         {
             Next = next;
         }
@@ -31,10 +31,10 @@ namespace YYApi.Middlewares
                 var login = cache.GetString(token);
                 if (login != null)
                 {
-                    httpContext.Items.Add("LoginInfo", JsonSerializer.Deserialize<YYLoginItem>(login));
+                    httpContext.Items.Add("LoginInfo", JsonSerializer.Deserialize<SimApiLoginItem>(login));
                 }
             }
-
+           
             return Next(httpContext);
         }
     }

Middlewares/SimApiExceptionMiddleware.cs

@@ -0,0 +1,80 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
+using SimApi.Communications;
+using Microsoft.Extensions.Logging;
+using SimApi.Exceptions;
+
+namespace SimApi.Middlewares
+{
+    /// <summary>
+    /// 异常处理中间件
+    /// </summary>
+    public class SimApiExceptionMiddleware
+    {
+        private RequestDelegate Next { get; }
+
+        private ILogger<SimApiExceptionMiddleware> Log { get; }
+
+        public SimApiExceptionMiddleware(RequestDelegate next, ILogger<SimApiExceptionMiddleware> log)
+        {
+            Log = log;
+            Next = next;
+        }
+
+        public async Task InvokeAsync(HttpContext context)
+        {
+            if (context.Request.Headers.ContainsKey("Query-Id"))
+            {
+                context.Response.Headers["Query-Id"] = context.Request.Headers["Query-Id"];
+            }
+
+            var response = new SimApiBaseResponse();
+            try
+            {
+                await Next(context);
+                if (context.Response.StatusCode != 200)
+                {
+                    if (!new[]
+                        {
+                            301, 302
+                        }.Contains(context.Response.StatusCode))
+                    {
+                        throw new SimApiException(context.Response.StatusCode);
+                    }
+                }
+            }
+            catch (SimApiException ex)
+            {
+                response = string.IsNullOrEmpty(ex.Message)
+                    ? new SimApiBaseResponse(ex.Code)
+                    : new SimApiBaseResponse(ex.Code, ex.Message);
+
+                ErrorResponse(context, response);
+            }
+            catch (Exception ex)
+            {
+                Log.LogError(ex.Message);
+                Log.LogError(ex.StackTrace);
+                response = new SimApiBaseResponse(500, ex.Message);
+                ErrorResponse(context, response);
+            }
+        }
+
+        /// <summary>
+        /// 异常抛出错误
+        /// </summary>
+        /// <param name="context"></param>
+        /// <param name="response"></param>
+        private void ErrorResponse(HttpContext context, SimApiBaseResponse response)
+        {
+            if (!context.Response.HasStarted)
+            {
+                context.Response.StatusCode = 200;
+                context.Response.Headers.Add("Content-Type", "application/json");
+                context.Response.WriteAsync(response.ToString());
+            }
+        }
+    }
+}

Middlewares/YYExceptionMiddleware.cs

@@ -1,57 +0,0 @@
-using System;
-using System.Threading.Tasks;
-using Microsoft.AspNetCore.Http;
-using YYApi.Communications;
-using Microsoft.Extensions.Logging;
-using YYApi.Exceptions;
-
-namespace YYApi.Middlewares
-{
-    /// <summary>
-    /// 异常处理中间件
-    /// </summary>
-    public class YYExceptionMiddleware
-    {
-        private RequestDelegate Next { get; }
-        private ILogger<YYExceptionMiddleware> Log { get; }
-
-        public YYExceptionMiddleware(RequestDelegate next, ILogger<YYExceptionMiddleware> log)
-        {
-            Log = log;
-            Next = next;
-        }
-
-        public async Task InvokeAsync(HttpContext context)
-        {
-            var response = new YYBaseResponse();
-            try
-            {
-                await Next(context);
-            }
-            catch (YYApiException ex)
-            {
-                response.SetCodeMsg(ex.Code, ex.Message);
-                ErrorResponse(context, response);
-            }
-            catch (Exception ex)
-            {
-                Log.LogError(ex.Message);
-                Log.LogError(ex.StackTrace);
-                response.SetCodeMsg(500, ex.Message);
-                ErrorResponse(context, response);
-            }
-        }
-
-        /// <summary>
-        /// 异常抛出错误
-        /// </summary>
-        /// <param name="context"></param>
-        /// <param name="response"></param>
-        private void ErrorResponse(HttpContext context, YYBaseResponse response)
-        {
-            context.Response.StatusCode = 200;
-            context.Response.Headers.Add("Content-Type", "application/json");
-            context.Response.WriteAsync(response.ToString());
-        }
-    }
-}

Models/SimApiBaseModel.cs

@@ -0,0 +1,84 @@
+using System;
+using System.Linq;
+using System.Text.Json;
+using SimApi.Helpers;
+
+namespace SimApi.Models
+{
+    public class SimApiBaseModel
+    {
+        protected virtual string[] MapperIgnoreField { get; set; } =
+        {
+            "Id", "CreatedAt", "UpdatedAt"
+        };
+
+        protected virtual string UpdatedTimeField { get; set; } = "UpdatedAt";
+
+        public void MapData<TS>(TS source, bool mapAll = false)
+        {
+            //获取要赋值的源数据不为null的项目
+            var sourceProps = source.GetType().GetProperties().Where(x => x.GetValue(source) != null)
+                .Select(x => new
+                {
+                    x.Name,
+                    x.PropertyType
+                })
+                .ToDictionary(x => x.Name, x => x.PropertyType);
+
+            //获取目标对象的属性信息
+            var targetProps = GetType().GetProperties().Select(x => new
+                {
+                    x.Name,
+                    x.PropertyType
+                })
+                .ToDictionary(x => x.Name, x => x.PropertyType);
+            foreach (var sp in sourceProps.Where(sp =>
+                         targetProps.ContainsKey(sp.Key) && sp.Value == targetProps[sp.Key] &&
+                         (!MapperIgnoreField.Contains(sp.Key) || mapAll)))
+            {
+                GetType().GetProperty(sp.Key)?
+                    .SetValue(this, source.GetType().GetProperty(sp.Key)?.GetValue(source));
+            }
+
+            UpdateTime();
+        }
+
+        public void MapData<TS>(TS source, string[] mapFields)
+        {
+            //获取要赋值的源数据不为null的项目
+            var sourceProps = source.GetType().GetProperties().Where(x => x.GetValue(source) != null)
+                .Select(x => new
+                {
+                    x.Name,
+                    x.PropertyType
+                })
+                .ToDictionary(x => x.Name, x => x.PropertyType);
+
+            //获取目标对象的属性信息
+            var targetProps = GetType().GetProperties().Select(x => new
+                {
+                    x.Name,
+                    x.PropertyType
+                })
+                .ToDictionary(x => x.Name, x => x.PropertyType);
+            foreach (var sp in sourceProps.Where(sp =>
+                         targetProps.ContainsKey(sp.Key) && sp.Value == targetProps[sp.Key] &&
+                         mapFields.Contains(sp.Key)))
+            {
+                GetType().GetProperty(sp.Key)?
+                    .SetValue(this, source.GetType().GetProperty(sp.Key)?.GetValue(source));
+            }
+
+            UpdateTime();
+        }
+
+        /// <summary>
+        /// 更新update时间
+        /// </summary>
+        /// <returns></returns>
+        public void UpdateTime()
+        {
+            GetType().GetProperty(UpdatedTimeField)?.SetValue(this, SimApiUtil.CstNow);
+        }
+    }
+}

Properties/launchSettings.json

@@ -4,7 +4,7 @@
     "anonymousAuthentication": true
   },
   "profiles": {
-    "YYApi": {
+    "SimApi": {
       "commandName": "Project",
       "launchBrowser": true,
       "environmentVariables": {

README.md

@@ -1,7 +1,6 @@
-# YYApi 基于Asp.net Core 3的一个基础辅助包
-
-![CI](https://github.com/YY-Tech/YYApi/workflows/CI/badge.svg)
+# YYApi 基于Asp.net Core 3/5的一个基础辅助包
 
+[![PublishNugetPackage](https://github.com/simcu/simapi-net/actions/workflows/nuget-publish.yml/badge.svg)](https://github.com/simcu/simapi-net/actions/workflows/nuget-publish.yml)
 ### 包含了以下组件:
 
 1. 统一的参数检测,基础认证服务
@@ -9,56 +8,47 @@
 
 ```C#
 using Models;
+using SimApi.Controllers;
 
 namespace Controllers
 {
-    public class BaseController : YYApi.Controllers.BaseController
+    public class BaseController : SimApiBaseController
     {
         /// <summary>
         /// 获取登录用户信息
         /// </summary>
-        protected LoginInfoItem LoginInfo => (LoginInfoItem) HttpContext.Items["LoginInfo"];
+        protected SimApiLoginInfoItem LoginInfo => (SimApiLoginInfoItem) HttpContext.Items["LoginInfo"];
     }
 }
 ```
 
-2. 基于Swagger的API文档服务
 
+统一配置，现在只需要进行AddSimApi的配置， Configure中直接 UseSimApi即可。
 ```C#
-#Startup.cs
-
-	services.AddYYDoc("文档名称", "文档描述");
-
-	app.UseYYDoc("名称",SubmitMethod[])
-
-#控制器中可以直接使用特性
-
-	[YYDoc("分组","名称")]
+services.AddSimApi(options =>
+{
+   options.ConfigureSimApiDoc(options =>
+   {
+     options.ApiGroups = new[]
+     {
+        new SimApiDocGroupOption
+            {Id = "admin", Name = "后台管理接口", Description = "本接口调用需要Scope：sac.api.admin"},
+        new SimApiDocGroupOption
+            {Id = "user-v1", Name = "用户中心接口", Description = "本接口调用需要Scope：sac.api.user"}
+     };
+     options.ApiAuth = new SimApiAuthOption
+       {
+         Type = new[] {"ClientCredentials", "Implicit", "AuthorizationCode"},
+         Scopes = new Dictionary<string, string>
+            {
+              {"sac.api.user", "用户信息接口权限"},
+              {"sac.api.admin", "后台管理API"}
+            },
+         AuthorizationUrl = "/connect/authorize",
+         TokenUrl = "/connect/token"
+       };
+     });
+     options.EnableSimApiStorage = true;
+     options.SimApiStorageOptions = Configuration.GetSection("S3").Get<SimApiStorageOptions>();
+});
 ```
-
-3. 简单的基于Redis的登录TOKEN服务
-
-```C#
-#Startup.cs
-service.AddYYAuth();
-```
-添加时候, 可以从DI中获取 Auth 类,调用 Auth.Set(int,string) 将用户ID/类型和生成的Token绑定,本方法返回缓存中的Key名称
-
-```C#
-#Startup.cs
-app.UseYYAuth();
-```
-调用本中间件,然后再需要登录认证的地方,使用 [YYAuth] 特性,即可完成检测登录相关的操作,
-如果需要获取用户的ID, 只需要 直接使用 LoginId 属性即可获取
-
-4. 统一返回
-所有Response 均需要继承 BaseResponse类
-
-
-5. 异常处理
-本异常中间件封装了API错误的异常处理,控制器可以使用 Error(int,string) 直接返回API错误
-
-```C#
-#Startup.cs
-app.UseYYException();
-```

SimApi.csproj

@@ -1,34 +1,35 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
     <OutputType>Library</OutputType>
     <PackOnBuild>true</PackOnBuild>
     <Version>0.2.3</Version>
-    <Authors>xRain@YYTech</Authors>
+    <Authors>xRain@SimcuTeam</Authors>
     <Description>AspNetCore一个方便的API文档,捕获异常,统一输入输出的API类库</Description>
-    <PackageId>YY-Tech.YYApi</PackageId>
+    <PackageId>Simcu.SimApi</PackageId>
     <IsPackable>true</IsPackable>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
     <IncludeSymbols>true</IncludeSymbols>
+    <ReleaseVersion>5.0.0</ReleaseVersion>
+    <SynchReleaseVersion>false</SynchReleaseVersion>
+    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+    <PackageVersion>5.0.2</PackageVersion>
+    <TargetFrameworks>net6.0;net7.0</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>
     <Folder Include="Helpers\" />
     <Folder Include="Communications\" />
     <Folder Include="Controllers\" />
-    <Folder Include="JobService\" />
     <Folder Include="Middlewares\" />
     <Folder Include="Attributes\" />
     <Folder Include="Exceptions\" />
+    <Folder Include="Configurations\" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Swashbuckle.AspNetCore.Annotations" Version="5.0.0" />
-    <PackageReference Include="Swashbuckle.AspNetCore.SwaggerUI" Version="5.0.0" />
-    <PackageReference Include="HangFire.Core" Version="1.7.9" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.9" />
-    <PackageReference Include="Hangfire.Console" Version="1.4.2" />
-    <PackageReference Include="Hangfire.Redis.StackExchange" Version="1.8.1" />
+    <PackageReference Include="Minio" Version="4.0.7" />
+    <PackageReference Include="Swashbuckle.AspNetCore.Annotations" Version="6.5.0" />
+    <PackageReference Include="Swashbuckle.AspNetCore.SwaggerUI" Version="6.5.0" />
   </ItemGroup>
   <ProjectExtensions>
     <MonoDevelop>

SimApiExtensions.cs

@@ -0,0 +1,260 @@
+using System;
+using SimApi.Helpers;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.OpenApi.Models;
+using SimApi.Middlewares;
+using Microsoft.AspNetCore.HttpOverrides;
+using Microsoft.Extensions.Logging;
+using SimApi.Configs;
+using SimApi.Logger;
+
+namespace SimApi
+{
+    /// <summary>
+    /// 加入系统的扩展信息
+    /// </summary>
+    public static class SimApiExtensions
+    {
+        //**********快捷添加**************
+        public static IServiceCollection AddSimApi(this IServiceCollection builder,
+            Action<SimApiOptions> options = null)
+        {
+            var simApiOptions = new SimApiOptions();
+            options?.Invoke(simApiOptions);
+            if (simApiOptions.EnableLogger)
+            {
+                builder.AddLogging(logger =>
+                {
+                    logger.ClearProviders();
+                    logger.AddProvider(new SimApiLoggerProvider());
+                });
+            }
+            // 是否使用 AUTH
+            if (simApiOptions.EnableSimApiAuth)
+            {
+                builder.AddScoped<SimApiAuth>();
+            }
+
+            if (simApiOptions.EnableCors)
+            {
+                builder.AddCors(cors => cors.AddPolicy("any",
+                    policy => { policy.AllowAnyHeader().AllowAnyMethod().AllowAnyOrigin(); }));
+            }
+
+            // 使用SimApiDoc
+            if (simApiOptions.EnableSimApiDoc)
+            {
+                var docOptions = simApiOptions.SimApiDocOptions;
+                builder.AddSwaggerGen(x =>
+                {
+                    foreach (var group in docOptions.ApiGroups)
+                    {
+                        x.SwaggerDoc(group.Id, new OpenApiInfo
+                        {
+                            Title = group.Name,
+                            Description = group.Description
+                        });
+                    }
+
+                    x.EnableAnnotations();
+                    var haveOauth = false;
+                    var haveSimApiAuth = false;
+                    var oauthFlows = new OpenApiOAuthFlows();
+                    foreach (var auth in docOptions.ApiAuth.Type)
+                    {
+                        switch (auth)
+                        {
+                            case "SimApiAuth":
+                                x.AddSecurityRequirement(new OpenApiSecurityRequirement
+                                {
+                                    {
+                                        new OpenApiSecurityScheme
+                                        {
+                                            Reference = new OpenApiReference
+                                            {
+                                                Type = ReferenceType.SecurityScheme,
+                                                Id = "HeaderToken"
+                                            }
+                                        },
+                                        new[]
+                                        {
+                                            "readAccess", "writeAccess"
+                                        }
+                                    }
+                                });
+                                haveSimApiAuth = true;
+                                break;
+                            case "ClientCredentials":
+                                oauthFlows.ClientCredentials = new OpenApiOAuthFlow
+                                {
+                                    TokenUrl = new Uri(docOptions.ApiAuth.TokenUrl, UriKind.RelativeOrAbsolute),
+                                    Scopes = docOptions.ApiAuth.Scopes
+                                };
+                                haveOauth = true;
+                                break;
+                            case "Implicit":
+                                oauthFlows.Implicit = new OpenApiOAuthFlow
+                                {
+                                    AuthorizationUrl = new Uri(docOptions.ApiAuth.AuthorizationUrl,
+                                        UriKind.RelativeOrAbsolute),
+                                    Scopes = docOptions.ApiAuth.Scopes
+                                };
+                                haveOauth = true;
+                                break;
+                            case "AuthorizationCode":
+                                oauthFlows.AuthorizationCode = new OpenApiOAuthFlow
+                                {
+                                    TokenUrl = new Uri(docOptions.ApiAuth.TokenUrl, UriKind.RelativeOrAbsolute),
+                                    AuthorizationUrl = new Uri(docOptions.ApiAuth.AuthorizationUrl,
+                                        UriKind.RelativeOrAbsolute),
+                                    Scopes = docOptions.ApiAuth.Scopes
+                                };
+                                haveOauth = true;
+                                break;
+                            case "Password":
+                                oauthFlows.Password = new OpenApiOAuthFlow
+                                {
+                                    TokenUrl = new Uri(docOptions.ApiAuth.TokenUrl, UriKind.RelativeOrAbsolute),
+                                    Scopes = docOptions.ApiAuth.Scopes
+                                };
+                                haveOauth = true;
+                                break;
+                        }
+                    }
+
+                    if (haveOauth)
+                    {
+                        x.AddSecurityDefinition("oauth2", new OpenApiSecurityScheme
+                        {
+                            Type = SecuritySchemeType.OAuth2,
+                            Flows = oauthFlows,
+                            Description = docOptions.ApiAuth.Description,
+                            In = ParameterLocation.Header
+                        });
+                        x.AddSecurityRequirement(new OpenApiSecurityRequirement
+                        {
+                            {
+                                new OpenApiSecurityScheme
+                                {
+                                    Reference = new OpenApiReference
+                                    {
+                                        Type = ReferenceType.SecurityScheme,
+                                        Id = "oauth2"
+                                    }
+                                },
+                                new[]
+                                {
+                                    "SimApiAuth"
+                                }
+                            }
+                        });
+                    }
+
+                    if (haveSimApiAuth)
+                    {
+                        x.AddSecurityDefinition("HeaderToken",
+                            new OpenApiSecurityScheme
+                            {
+                                Name = "Token",
+                                In = ParameterLocation.Header
+                            });
+                    }
+                });
+            }
+
+            // 使用Header转发，应对代理后获取真实ip
+            if (simApiOptions.EnableForwardHeaders)
+            {
+                builder.Configure<ForwardedHeadersOptions>(fwOptions =>
+                {
+                    fwOptions.ForwardedHeaders = ForwardedHeaders.All;
+                    fwOptions.KnownNetworks.Clear();
+                    fwOptions.KnownProxies.Clear();
+                });
+            }
+
+            if (simApiOptions.EnableLowerUrl)
+            {
+                builder.AddRouting(rOptions => rOptions.LowercaseUrls = true);
+            }
+
+            if (simApiOptions.EnableSimApiStorage)
+            {
+                builder.AddHttpContextAccessor();
+                builder.AddSingleton<SimApiStorage>();
+            }
+
+            builder.AddSingleton(simApiOptions);
+            return builder;
+        }
+
+        /// <summary>
+        ///  使用所有SimApi自定义中间件
+        /// </summary>
+        /// <param name="builder"></param>
+        /// <returns></returns>
+        public static IApplicationBuilder UseSimApi(this IApplicationBuilder builder)
+        {
+            var options = builder.ApplicationServices.GetRequiredService<SimApiOptions>();
+
+            var logger = builder.ApplicationServices.GetRequiredService<ILogger<SimApiOptions>>();
+
+            if (options.EnableForwardHeaders)
+            {
+                logger.LogInformation("开始配置ForwardedHeaders...");
+                builder.UseForwardedHeaders();
+            }
+
+            if (options.EnableCors)
+            {
+                logger.LogInformation("开始配置Cors全部允许...");
+                builder.UseCors("any");
+            }
+
+            if (options.EnableSimApiAuth)
+            {
+                logger.LogInformation("开始配置SimApiAuth...");
+                builder.UseMiddleware<SimApiAuthMiddleware>();
+            }
+
+            if (options.EnableSimApiDoc)
+            {
+                logger.LogInformation("开始配置SimApiDoc...");
+                var docOptions = options.SimApiDocOptions;
+                builder.UseSwagger(x => x.RouteTemplate = "/swagger/{documentName}.json").UseSwaggerUI(x =>
+                {
+                    x.DocumentTitle = docOptions.DocumentTitle;
+                    foreach (var group in docOptions.ApiGroups)
+                    {
+                        x.SwaggerEndpoint($"/swagger/{group.Id}.json", name: group.Name);
+                    }
+
+                    x.EnableValidator();
+                    x.SupportedSubmitMethods(docOptions.SupportedMethod);
+                    x.DisplayRequestDuration();
+                });
+            }
+
+            if (options.EnableSimApiException)
+            {
+                logger.LogInformation("开始配置SimApiException...");
+                builder.UseMiddleware<SimApiExceptionMiddleware>();
+            }
+
+            //请求一下检测存储错误
+            if (options.EnableSimApiStorage)
+            {
+                logger.LogInformation("开始配置SimApiStorage...");
+                builder.ApplicationServices.GetService<SimApiStorage>();
+            }
+
+            if (options.EnableLowerUrl)
+            {
+                logger.LogInformation("开始配置使用URL小写...");
+            }
+
+            return builder;
+        }
+    }
+}