Fast.DynamicApplication
参考源码版本 3.5.42;目标 net8.0、net9.0、net10.0;依赖 Fast.Runtime 与 Fast.UnifyResult。将被发现的应用服务映射为 MVC API。
从旧版升级且使用平台标志时,见 Runtime H5 迁移说明。本包的版本对齐记录见依赖链变更。
dotnet add package Fast.DynamicApplication注册和最小应用服务
公开入口为 AddDynamicApplication(this IServiceCollection services, string routePrefix = null),返回原服务集合。必须先调用 AddControllers() 或 AddControllersWithViews();缺少 ApplicationPartManager 时立即抛 InvalidOperationException。
以下为消费端 Program.cs,使用 Microsoft.NET.Sdk.Web,目标选择本页列出的 .NET 8、9 或 10,并安装上方指定包。app.Run() 表示正常宿主启动;本次文档维护不会执行它。
using Fast.DynamicApplication;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.AspNetCore.Builder;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
builder.Services.AddDynamicApplication("api");
var app = builder.Build();
app.MapControllers();
app.Run();
[Route("api/sample")]
public sealed class SampleService : IDynamicApplication
{
[HttpGet("message")]
public string Message() => "hello";
}宿主另行 MapControllers();本例显式固定 route,避免消费者依赖类名/方法名推导。动态发现取决于框架程序集扫描范围,不等于任意加载的 DLL 都暴露 API。
描述与路由合同
| 类型 / 成员 | 语义 |
|---|---|
IDynamicApplication | 动态 API 服务标记 |
DynamicApplicationContext.RoutePrefix | 注册时设置的全局前缀,公开读取、内部设置 |
ApiDescriptionSettingsAttribute() | 描述设置,Order 默认 0 |
ApiDescriptionSettingsAttribute(bool enabled) | 设置 IgnoreApi = !enabled,影响 API Explorer;不能作为授权控制 |
ApiDescriptionSettingsAttribute(params string[] groups) | 设置 Groups,并使用 ## 连接分组名 |
Name、Module、Version | 参与名称、模块、版本约定 |
Groups、Order、Description | 文档分组、顺序、描述;Description 支持 HTML,内容来源需要受控 |
现有显式 Route/HTTP 特性优先参与路由配置。没有显式绑定来源的基础类型参数会被设置为 FromQuery;复杂对象和特殊绑定参数分别处理,不应推断所有参数都进入路径。对外稳定接口建议显式表达 HTTP 方法与绑定来源。
边界
此模块处理 MVC 控制器发现,不替代认证、权限、业务事务或 OpenAPI 文件生成。返回非泛型 Task/ValueTask 与同步值均需由 MVC 管道处理,具体 JSON 协议由序列化及统一结果模块决定。注册顺序错误是明确异常,不需要通过复制 ApplicationPartManager 绕开。
来源与验证
依据 注册实现、路由约定。本轮未编译或启动 API 宿主,示例路由尚未执行验证。
2026-11-02 依赖链变更
2026-11-02 依赖链同步:本包从 3.5.41 递增至 3.5.42,依赖更新为 Fast.Runtime 3.5.37,并对齐 Fast.UnifyResult 3.5.41。本模块自身实现与公开声明未变。Runtime 新增移动端 H5,并将 Android 及后续位依次后移;数字协议和掩码须迁移,消费端须重新编译并同步前端枚举,见 Runtime H5 迁移说明。
2026-10-24 版本与依赖
2026-10-24 将本包从 3.5.38 递增至 3.5.39,依赖更新至 Fast.Runtime 3.5.34 / Fast.UnifyResult 3.5.38。本模块自身实现和公开声明未改。
使用 AppEnvironmentEnum 的消费端需按 Runtime 鸿蒙迁移说明迁移数值并重新编译。本轮只核对源码与 MSBuild 有效包元数据,按要求不运行测试,也未执行还原、构建、打包或消费端运行验证。
