Rename projects to FileShare
This commit is contained in:
@@ -0,0 +1,115 @@
|
||||
using FileShare_Common.Core;
|
||||
using FileShare_Services.Core;
|
||||
using FileShare_Services.Services.FileLibrary;
|
||||
using FileShare_Services.Services.QrCode;
|
||||
|
||||
namespace FileShare_Services.Endpoints
|
||||
{
|
||||
/// <summary>
|
||||
/// 统一端点配置 —— 所有业务端点在此定义一次。
|
||||
/// 这是 FileShare-API 和 FileShare-PC 的唯一入口。
|
||||
/// </summary>
|
||||
public static class AppEndpoints
|
||||
{
|
||||
/// <summary>
|
||||
/// 配置所有业务端点。调用方传入 builder，按需叠加鉴权、过滤器等。
|
||||
/// </summary>
|
||||
/// <param name="builder">端点构建器</param>
|
||||
/// <param name="includeDetails">是否在错误响应中包含异常详情（开发环境 true）</param>
|
||||
public static ServiceEndpointBuilder Configure(ServiceEndpointBuilder builder, bool includeDetails = false)
|
||||
{
|
||||
// ---- 全局异常拦截（自动捕获所有端点中未处理的异常） ----
|
||||
builder.Endpoints.AddGlobalFilter(new GlobalExceptionFilter(includeDetails));
|
||||
|
||||
builder.ConfigureEndpoints(endpoints =>
|
||||
{
|
||||
// ---- 全局日志过滤器（记录每个请求） ----
|
||||
endpoints.AddGlobalFilter(async (ctx, next) =>
|
||||
{
|
||||
Serilog.Log.Debug("→ {Method} {Path}", ctx.Method, ctx.Path);
|
||||
await next(ctx);
|
||||
Serilog.Log.Debug("← {Method} {Path} | {StatusCode}", ctx.Method, ctx.Path, ctx.StatusCode);
|
||||
});
|
||||
|
||||
// ---- 业务端点注册 ----
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService>("api/library/drives", (service, ctx) => service.GetDrivesAsync(ctx))
|
||||
.WithOpenApi("FileLibrary", "查询服务器磁盘。")
|
||||
.WithName("GetLibraryDrives");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService, DirectoryQueryRequest>("api/library/directories", (service, request, _) => service.GetDirectoriesAsync(request))
|
||||
.WithOpenApi("FileLibrary", "查询服务器目录。")
|
||||
.WithName("GetLibraryDirectories");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService>("api/library/roots", (service, ctx) => service.GetRootsAsync(ctx))
|
||||
.WithOpenApi("FileLibrary", "查询文件库目录。")
|
||||
.WithName("GetLibraryRoots");
|
||||
|
||||
endpoints.MapPost<IFileLibraryEndpointService, AddLibraryRootRequest>("api/library/roots", (service, request, _) => service.AddRootAsync(request))
|
||||
.WithOpenApi("FileLibrary", "添加文件库目录。")
|
||||
.WithName("AddLibraryRoot");
|
||||
|
||||
endpoints.MapPost<IFileLibraryEndpointService, UpdateLibraryRootRequest>("api/library/roots/enabled", (service, request, _) => service.SetRootEnabledAsync(request))
|
||||
.WithOpenApi("FileLibrary", "启用或禁用文件库目录。")
|
||||
.WithName("SetLibraryRootEnabled");
|
||||
|
||||
endpoints.MapPost<IFileLibraryEndpointService, DeleteLibraryRootRequest>("api/library/roots/delete", (service, request, _) => service.DeleteRootAsync(request))
|
||||
.WithOpenApi("FileLibrary", "删除文件库目录。")
|
||||
.WithName("DeleteLibraryRoot");
|
||||
|
||||
endpoints.MapPost<IFileLibraryEndpointService, ScanLibraryRootRequest>("api/library/roots/scan", (service, request, _) => service.ScanRootAsync(request))
|
||||
.WithOpenApi("FileLibrary", "立即扫描文件库目录。")
|
||||
.WithName("ScanLibraryRoot");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService, SearchFilesRequest>("api/files", (service, request, _) => service.SearchFilesAsync(request))
|
||||
.WithOpenApi("FileLibrary", "分页查询已扫描文件。")
|
||||
.WithName("SearchFiles");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService, BrowseDirectoryRequest>("api/files/browse", (service, request, _) => service.BrowseDirectoryAsync(request))
|
||||
.WithOpenApi("FileLibrary", "浏览文件库目录结构。")
|
||||
.WithName("BrowseDirectory");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService, FileQueryRequest>("api/files/detail", (service, request, _) => service.GetFileAsync(request))
|
||||
.WithOpenApi("FileLibrary", "查询文件详情。")
|
||||
.WithName("GetFileDetail");
|
||||
|
||||
endpoints.MapGet<IFileLibraryEndpointService, FileQueryRequest>("api/files/text", (service, request, _) => service.GetTextPreviewAsync(request))
|
||||
.WithOpenApi("FileLibrary", "预览文本文件。")
|
||||
.WithName("GetTextPreview");
|
||||
|
||||
endpoints.MapGet("api/files/stream", GetFileStreamAsync)
|
||||
.WithOpenApi("FileLibrary", "流式传输文件（支持 Range 请求）。")
|
||||
.WithName("StreamManagedFile");
|
||||
|
||||
endpoints.MapGet<IQrCodeService>("api/qrcode", (service, ctx) => service.GenerateQrCodeAsync(ctx))
|
||||
.WithOpenApi("Utility", "生成局域网访问二维码。")
|
||||
.WithName("GetQrCode");
|
||||
|
||||
// ---- 需要鉴权的端点示例 ----
|
||||
// endpoints.MapGet("api/admin/dashboard", AdminDashboardAsync)
|
||||
// .WithName("AdminDashboard")
|
||||
// .RequireAuthorization = true
|
||||
// .Policy = "AdminOnly";
|
||||
|
||||
});
|
||||
|
||||
return builder;
|
||||
}
|
||||
|
||||
#region 业务处理方法
|
||||
|
||||
private static async Task<object?> GetFileStreamAsync(ServiceEndpointContext ctx)
|
||||
{
|
||||
var sp = ctx.Items["ServiceProvider"] as IServiceProvider;
|
||||
var service = sp?.GetService(typeof(IFileStreamService)) as IFileStreamService;
|
||||
if (service is null) return null;
|
||||
|
||||
if (!int.TryParse(ctx.Query.GetValueOrDefault("id"), out var id) || id <= 0)
|
||||
return null;
|
||||
|
||||
return await service.GetFileStreamAsync(id);
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
using FileShare_Services.Core;
|
||||
using FileShare_Services.Services.AuthService;
|
||||
|
||||
namespace FileShare_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, ApiLoginRequest>("api/auth/login", (service, request, ctx) => service.LoginAsync(request, ctx))
|
||||
.WithName("ApiLogin")
|
||||
.WithOpenApi("Auth", "API 登录，返回 access token 和 refresh token。", "", typeof(ApiLoginRequest), typeof(AuthTokenResponse))
|
||||
.ApiOnly();
|
||||
|
||||
endpoints.MapPost<IApiAuthEndpointService, ApiRefreshTokenRequest>("api/auth/refresh", (service, request, ctx) => service.RefreshAsync(request, ctx))
|
||||
.WithName("ApiRefresh")
|
||||
.WithOpenApi("Auth", "API refresh token 轮换。", "", typeof(ApiRefreshTokenRequest), typeof(AuthTokenResponse))
|
||||
.ApiOnly();
|
||||
|
||||
endpoints.MapPost<IApiAuthEndpointService, ApiLogoutRequest>("api/auth/logout", (service, request, ctx) => service.LogoutAsync(request, 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, PcAuthorizeRequest>("api/pc/auth/authorize", (service, request, ctx) => service.AuthorizeAsync(request, ctx))
|
||||
.WithName("PcAuthorize")
|
||||
.WithOpenApi("Auth", "PC 授权码登录，生成本地全局 token。", "", typeof(PcAuthorizeRequest), typeof(PcTokenResponse))
|
||||
.PcOnly();
|
||||
|
||||
endpoints.MapPost<IPcAuthEndpointService, PcRefreshRequest>("api/pc/auth/refresh", (service, request, ctx) => service.RefreshAsync(request, ctx))
|
||||
.WithName("PcRefresh")
|
||||
.WithOpenApi("Auth", "PC 全局 token 刷新。", "", typeof(PcRefreshRequest), typeof(PcTokenResponse))
|
||||
.PcOnly();
|
||||
|
||||
endpoints.MapPost<IPcAuthEndpointService, PcLogoutRequest>("api/pc/auth/logout", (service, request, ctx) => service.LogoutAsync(request, ctx))
|
||||
.WithName("PcLogout")
|
||||
.WithOpenApi("Auth", "PC 退出登录。", "", typeof(PcLogoutRequest))
|
||||
.PcOnly();
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user