luoqian
fc6f9f6bc3
- 为全部 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 项目编译通过
60 lines
2.1 KiB
C#
60 lines
2.1 KiB
C#
using Avalonia_Services.Core;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace Avalonia_Services.Services.AuthService
|
||
{
|
||
/// <summary>
|
||
/// API 鉴权端点服务接口，定义登录、刷新 Token 和登出操作。
|
||
/// </summary>
|
||
public interface IApiAuthEndpointService
|
||
{
|
||
/// <summary>
|
||
/// 处理用户登录请求。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>包含 Token 的认证响应。</returns>
|
||
Task<object?> LoginAsync(ServiceEndpointContext ctx);
|
||
|
||
/// <summary>
|
||
/// 使用 Refresh Token 刷新 Access Token。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>新的 Token 对。</returns>
|
||
Task<object?> RefreshAsync(ServiceEndpointContext ctx);
|
||
|
||
/// <summary>
|
||
/// 处理用户登出请求。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>登出结果。</returns>
|
||
Task<object?> LogoutAsync(ServiceEndpointContext ctx);
|
||
}
|
||
|
||
/// <summary>
|
||
/// PC 端鉴权端点服务接口，定义授权码登录、Token 刷新和登出操作。
|
||
/// </summary>
|
||
public interface IPcAuthEndpointService
|
||
{
|
||
/// <summary>
|
||
/// 使用授权码进行登录授权。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>包含 Token 的认证响应。</returns>
|
||
Task<object?> AuthorizeAsync(ServiceEndpointContext ctx);
|
||
|
||
/// <summary>
|
||
/// 刷新当前 Token。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>新的 Token 响应。</returns>
|
||
Task<object?> RefreshAsync(ServiceEndpointContext ctx);
|
||
|
||
/// <summary>
|
||
/// 处理用户登出请求。
|
||
/// </summary>
|
||
/// <param name="ctx">服务端点上下文。</param>
|
||
/// <returns>登出结果。</returns>
|
||
Task<object?> LogoutAsync(ServiceEndpointContext ctx);
|
||
}
|
||
}
|