跳到正文

Fast.DynamicApplication ​

逐成员 API、参数与返回参考

参考源码版本 3.5.42;目标 net8.0、net9.0、net10.0;依赖 Fast.Runtime 与 Fast.UnifyResult。将被发现的应用服务映射为 MVC API。

从旧版升级且使用平台标志时,见 Runtime H5 迁移说明。本包的版本对齐记录见依赖链变更。

bash
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() 表示正常宿主启动;本次文档维护不会执行它。

csharp
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 有效包元数据,按要求不运行测试,也未执行还原、构建、打包或消费端运行验证。