opt: 添加中间件选项IgnoreOptionsRequest以忽略OPTIONS请求

Author: stratosblue

src/Cuture.AspNetCore.ResponseAutoWrapper/Cuture.AspNetCore.ResponseAutoWrapper.csproj

@@ -16,7 +16,7 @@
     <IsPackable>true</IsPackable>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
 
-    <Version>1.2.1</Version>
+    <Version>1.2.2</Version>
     <Description>Response and exception automatic wrapper for `asp.net core` to provide a consistent response content format for `Action`. 用于`asp.net core`的响应和异常自动包装器，使`Action`提供一致的响应内容格式。</Description>
 
     <PackageIdPrefix>Cuture.AspNetCore.ResponseAutoWrapper</PackageIdPrefix>

src/Cuture.AspNetCore.ResponseAutoWrapper/Extensions/ResponseDescriptionHttpContextExtensions.cs

@@ -106,7 +106,7 @@ public static bool TryGetResponseDescription<TCode, TMessage>(this ResultExecuti
     #region Private 方法
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    private static Exception DescriptionTypeNotMatchException<TCode, TMessage>()
+    private static InvalidOperationException DescriptionTypeNotMatchException<TCode, TMessage>()
     {
         return new InvalidOperationException($"The http context has description object. But it's not the instance of {typeof(ResponseDescription<TCode, TMessage>)}. This situation is likely to be the description type use error. Please check it.");
     }

src/Cuture.AspNetCore.ResponseAutoWrapper/ResponseAutoWrapMiddleware.cs

@@ -41,6 +41,9 @@ internal class ResponseAutoWrapMiddleware
 
     private readonly IHttpResponseStreamWriterFactory _httpResponseStreamWriterFactory;
 
+    /// <inheritdoc cref="ResponseAutoWrapMiddlewareOptions.IgnoreOptionsRequest"/>
+    private readonly bool _ignoreOptionsRequest;
+
     private readonly OutputFormatterSelector _outputFormatterSelector;
 
     #endregion OutputFormat
@@ -86,6 +89,7 @@ public ResponseAutoWrapMiddleware(RequestDelegate next,
 
         _notCatchExceptions = !options.CatchExceptions;
         _throwCaughtExceptions = options.ThrowCaughtExceptions;
+        _ignoreOptionsRequest = options.IgnoreOptionsRequest;
 
         var delegateCollection = GetService<ResponseAutoWrapperWorkDelegateCollection>();
 
@@ -101,6 +105,13 @@ public ResponseAutoWrapMiddleware(RequestDelegate next,
 
     public async Task InvokeAsync(HttpContext context)
     {
+        if (_ignoreOptionsRequest
+            && HttpMethods.IsOptions(context.Request.Method))
+        {
+            await _next(context);
+            return;
+        }
+
         try
         {
             await _next(context);

src/Cuture.AspNetCore.ResponseAutoWrapper/ResponseAutoWrapMiddlewareOptions.cs

@@ -27,6 +27,11 @@ public class ResponseAutoWrapMiddlewareOptions
         = static formatters => formatters.FirstOrDefault(m => m.GetType() == typeof(SystemTextJsonOutputFormatter))
                                                             ?? throw new InvalidOperationException($"Can not found {nameof(SystemTextJsonOutputFormatter)} by default. Must select a formatter manually by \"{nameof(ResponseAutoWrapMiddlewareOptions)}.{nameof(DefaultOutputFormatterSelector)}\" at middleware setup.");
 
+    /// <summary>
+    /// 忽略 OPTIONS 请求
+    /// </summary>
+    public bool IgnoreOptionsRequest { get; set; } = true;
+
     /// <summary>
     /// 是否将捕获到的异常抛出给上层中间件<para/>
     /// default is <see langword="false"/>