- 为全部 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 项目编译通过
62 lines
2.9 KiB
C#
62 lines
2.9 KiB
C#
using Avalonia_Services.Core;
|
|
using Avalonia_Services.Services.AuthService;
|
|
|
|
namespace Avalonia_Services.Endpoints
|
|
{
|
|
/// <summary>
|
|
/// 认证端点统一入口。端点定义在这里,宿主项目只提供对应实现。
|
|
/// </summary>
|
|
public static class AuthEndpoints
|
|
{
|
|
/// <summary>
|
|
/// 配置 API 端鉴权端点(登录、刷新、登出)。
|
|
/// </summary>
|
|
/// <param name="builder">端点构建器。</param>
|
|
public static void ConfigureApi(ServiceEndpointBuilder builder)
|
|
{
|
|
builder.ConfigureEndpoints(endpoints =>
|
|
{
|
|
endpoints.MapPost<IApiAuthEndpointService>("api/auth/login", (service, ctx) => service.LoginAsync(ctx))
|
|
.WithName("ApiLogin")
|
|
.WithOpenApi("Auth", "API 登录,返回 access token 和 refresh token。", "", typeof(ApiLoginRequest), typeof(AuthTokenResponse))
|
|
.ApiOnly();
|
|
|
|
endpoints.MapPost<IApiAuthEndpointService>("api/auth/refresh", (service, ctx) => service.RefreshAsync(ctx))
|
|
.WithName("ApiRefresh")
|
|
.WithOpenApi("Auth", "API refresh token 轮换。", "", typeof(ApiRefreshTokenRequest), typeof(AuthTokenResponse))
|
|
.ApiOnly();
|
|
|
|
endpoints.MapPost<IApiAuthEndpointService>("api/auth/logout", (service, ctx) => service.LogoutAsync(ctx))
|
|
.WithName("ApiLogout")
|
|
.WithOpenApi("Auth", "API 退出登录并吊销 refresh token。", "", typeof(ApiLogoutRequest))
|
|
.ApiOnly();
|
|
});
|
|
}
|
|
|
|
/// <summary>
|
|
/// 配置 PC 端鉴权端点(授权码登录、刷新、登出)。
|
|
/// </summary>
|
|
/// <param name="builder">端点构建器。</param>
|
|
public static void ConfigurePc(ServiceEndpointBuilder builder)
|
|
{
|
|
builder.ConfigureEndpoints(endpoints =>
|
|
{
|
|
endpoints.MapPost<IPcAuthEndpointService>("api/pc/auth/authorize", (service, ctx) => service.AuthorizeAsync(ctx))
|
|
.WithName("PcAuthorize")
|
|
.WithOpenApi("Auth", "PC 授权码登录,生成本地全局 token。", "", typeof(PcAuthorizeRequest), typeof(PcTokenResponse))
|
|
.PcOnly();
|
|
|
|
endpoints.MapPost<IPcAuthEndpointService>("api/pc/auth/refresh", (service, ctx) => service.RefreshAsync(ctx))
|
|
.WithName("PcRefresh")
|
|
.WithOpenApi("Auth", "PC 全局 token 刷新。", "", typeof(PcRefreshRequest), typeof(PcTokenResponse))
|
|
.PcOnly();
|
|
|
|
endpoints.MapPost<IPcAuthEndpointService>("api/pc/auth/logout", (service, ctx) => service.LogoutAsync(ctx))
|
|
.WithName("PcLogout")
|
|
.WithOpenApi("Auth", "PC 退出登录。", "", typeof(PcLogoutRequest))
|
|
.PcOnly();
|
|
});
|
|
}
|
|
}
|
|
}
|