feat: allow configuring api versioning (#343)

ikesnowy · web-flow · commit cdd3a86b6463 · 2025-11-07T13:41:43.000+08:00
diff --git a/src/Cnblogs.Architecture.Ddd.Cqrs.AspNetCore/ApiVersioningInjectors.cs b/src/Cnblogs.Architecture.Ddd.Cqrs.AspNetCore/ApiVersioningInjectors.cs
@@ -1,4 +1,5 @@
 ﻿using Asp.Versioning;
+using Asp.Versioning.ApiExplorer;
 using Asp.Versioning.Conventions;
 
 // ReSharper disable once CheckNamespace
@@ -13,17 +14,31 @@ public static class ApiVersioningInjectors
     /// Add API Versioning, use <see cref="VersionByNamespaceConvention"/> by default.
     /// </summary>
     /// <param name="services"><see cref="IServiceCollection"/></param>
+    /// <param name="versioningSetup">Versioning Setup.</param>
+    /// <param name="mvcApiVersioningSetup">Setups in MVC api versioning.</param>
+    /// <param name="apiExplorerSetup">Setups for ApiExplorer.</param>
     /// <returns></returns>
-    public static IApiVersioningBuilder AddCnblogsApiVersioning(this IServiceCollection services)
+    public static IApiVersioningBuilder AddCnblogsApiVersioning(
+        this IServiceCollection services,
+        Action<ApiVersioningOptions>? versioningSetup = null,
+        Action<MvcApiVersioningOptions>? mvcApiVersioningSetup = null,
+        Action<ApiExplorerOptions>? apiExplorerSetup = null)
     {
         services.AddEndpointsApiExplorer();
-        return services.AddApiVersioning(o => o.ReportApiVersions = true)
-            .AddMvc(o => o.Conventions.Add(new VersionByNamespaceConvention()))
-            .AddApiExplorer(
-                o =>
-                {
-                    o.GroupNameFormat = "'v'VVV";
-                    o.SubstituteApiVersionInUrl = true;
-                });
+        return services.AddApiVersioning(o =>
+            {
+                versioningSetup?.Invoke(o);
+            })
+            .AddMvc(o =>
+            {
+                o.Conventions.Add(new VersionByNamespaceConvention());
+                mvcApiVersioningSetup?.Invoke(o);
+            })
+            .AddApiExplorer(o =>
+            {
+                o.GroupNameFormat = "'v'VVV";
+                o.SubstituteApiVersionInUrl = true;
+                apiExplorerSetup?.Invoke(o);
+            });
     }
 }
diff --git a/src/Cnblogs.Architecture.Ddd.Cqrs.Dapper.SqlServer/Cnblogs.Architecture.Ddd.Cqrs.Dapper.SqlServer.csproj b/src/Cnblogs.Architecture.Ddd.Cqrs.Dapper.SqlServer/Cnblogs.Architecture.Ddd.Cqrs.Dapper.SqlServer.csproj
@@ -11,7 +11,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Data.SqlClient" Version="6.1.1" />
+    <PackageReference Include="Microsoft.Data.SqlClient" Version="6.1.2" />
   </ItemGroup>
 
 </Project>
diff --git a/src/Cnblogs.Architecture.Ddd.Infrastructure.CacheProviders.Redis/Cnblogs.Architecture.Ddd.Infrastructure.CacheProviders.Redis.csproj b/src/Cnblogs.Architecture.Ddd.Infrastructure.CacheProviders.Redis/Cnblogs.Architecture.Ddd.Infrastructure.CacheProviders.Redis.csproj
@@ -12,7 +12,7 @@
     </ItemGroup>
 
     <ItemGroup>
-      <PackageReference Include="StackExchange.Redis" Version="2.9.25" />
+      <PackageReference Include="StackExchange.Redis" Version="2.9.32" />
     </ItemGroup>
 
 </Project>
diff --git a/test/Cnblogs.Architecture.IntegrationTestProject/Program.cs b/test/Cnblogs.Architecture.IntegrationTestProject/Program.cs
@@ -17,7 +17,6 @@
     .AddEventBus(o => o.UseDapr(Constants.AppName));
 builder.Services.AddControllers().AddCqrsModelBinderProvider().AddLongToStringJsonConverter();
 
-// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
 builder.Services.AddCnblogsApiVersioning();
 
 var app = builder.Build();
