docs: 补全全部缺失的 XML 文档注释(中文)
- 为全部 5 个项目(Avalonia-API、Avalonia-Common、Avalonia-EFCore、 Avalonia-PC、Avalonia-Services)中缺失注释的类、方法、属性、字段、 接口成员等补全中文 XML 文档注释 - 共修改约 37 个文件,补全约 220+ 处注释 - 修复 ServiceEndpointCollection.cs 中 MapDelete<TService> 语法错误 - 修复 PcAuthService.cs 中 const prefix 位置错乱导致编译失败的问题 - 扫描结果:缺失项 0 - 构建结果:4/4 项目编译通过
This commit is contained in:
@@ -95,6 +95,13 @@ namespace Avalonia_API.Extensions
|
||||
return routeBuilder;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 根据端点的 HTTP 方法(GET/POST/PUT/DELETE)将其映射到 ASP.NET Core 路由。
|
||||
/// </summary>
|
||||
/// <param name="group">路由组。</param>
|
||||
/// <param name="endpoint">统一端点定义。</param>
|
||||
/// <param name="serviceProvider">服务提供程序。</param>
|
||||
/// <returns>路由处理器构建器,用于叠加过滤器等配置。</returns>
|
||||
private static RouteHandlerBuilder MapEndpoint(
|
||||
IEndpointRouteBuilder group,
|
||||
ServiceEndpoint endpoint,
|
||||
@@ -112,6 +119,12 @@ namespace Avalonia_API.Extensions
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建适配 ASP.NET Core 的委托处理器,将统一处理器包装为 ASP.NET Core 可识别的委托。
|
||||
/// </summary>
|
||||
/// <param name="unifiedHandler">统一端点处理器。</param>
|
||||
/// <param name="serviceProvider">服务提供程序。</param>
|
||||
/// <returns>ASP.NET Core 兼容的委托。</returns>
|
||||
private static Delegate CreateAspNetCoreHandler(
|
||||
Func<ServiceEndpointContext, Task<object?>> unifiedHandler,
|
||||
IServiceProvider serviceProvider)
|
||||
@@ -135,6 +148,12 @@ namespace Avalonia_API.Extensions
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 从 ASP.NET Core 的 HttpContext 构建统一的 ServiceEndpointContext,
|
||||
/// 提取路径、方法、请求头、查询参数和请求体。
|
||||
/// </summary>
|
||||
/// <param name="httpContext">ASP.NET Core 的 HttpContext。</param>
|
||||
/// <returns>构建好的统一端点上下文。</returns>
|
||||
private static async Task<ServiceEndpointContext> BuildContextFromHttpContext(HttpContext httpContext)
|
||||
{
|
||||
var ctx = new ServiceEndpointContext
|
||||
@@ -166,6 +185,14 @@ namespace Avalonia_API.Extensions
|
||||
return ctx;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 将统一过滤器转换为 ASP.NET Core 端点过滤器,
|
||||
/// 在调用统一过滤器前后桥接上下文和状态。
|
||||
/// </summary>
|
||||
/// <param name="unifiedFilter">统一过滤器。</param>
|
||||
/// <param name="aspContext">ASP.NET Core 过滤器调用上下文。</param>
|
||||
/// <param name="aspNext">ASP.NET Core 过滤器管道中的下一个委托。</param>
|
||||
/// <returns>过滤器执行结果,可能包含短路响应体。</returns>
|
||||
private static async ValueTask<object?> ConvertFilterAsync(
|
||||
UnifiedFilter unifiedFilter,
|
||||
AspNetCoreFilterContext aspContext,
|
||||
|
||||
Reference in New Issue
Block a user