Fast.NET.Core
参考源码版本 3.5.47;目标 net8.0、net9.0、net10.0;依赖 Fast.Runtime。负责 Web 应用初始化、JSON 配置扫描、CORS、压缩、请求缓冲、静态文件 MIME 类型映射和运行环境辅助。
从旧版升级且使用平台标志时,见 Runtime H5 迁移说明。本包的版本对齐记录见依赖链变更。
Fast.NET 入门示例使用 3.5.42 验证。
dotnet add package Fast.NET.Core初始化与管道
using Fast.NET.Core;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);
builder.Initialize();
builder.Services.AddControllers();
builder.AddCorsAccessor();
builder.Services.AddGzipCompression();
var app = builder.Build();
app.UseGzipCompression();
app.EnableBuffering();
app.MapControllers();
app.MapGet("/environment", () => new { builder.Environment.EnvironmentName });
app.Run();Initialize() 返回原 WebApplicationBuilder,输出启动横幅,保存环境与配置,注册 HTTP 上下文访问、内存缓存、编码支持及启动过滤器。它不是无副作用的纯配置方法。当前横幅读取程序集版本;不要依赖旧手册中关于信息版本、标签颜色的描述作为 API 合同。
这是 Microsoft.NET.Sdk.Web 项目的 Program.cs,使用本页支持的 .NET 8/9/10。/environment 展示配置后的宿主环境,不应向公网暴露更多配置。app.Run() 是应用入口,文档维护不会执行;请求缓冲和压缩需通过真实 HTTP 请求验证,不能仅凭注册成功认定生效。
配置扫描包含执行目录,以及 AppConfig、AppSettings、JsonConfig、Config、Settings 和 ConfigurationScanDirectories 指定目录。扫描按文件名前缀与环境后缀过滤;额外 publicJsonPath 使用逗号分隔的绝对文件路径。消费项目不需要复制 SDK 源码。
静态文件 MIME 类型映射
从 3.5.44 起,UseStaticFiles(IConfiguration configuration, string section = "StaticFileSettings") 可从配置读取文件扩展名与 MIME 类型的映射,并返回原 IApplicationBuilder,便于链式调用。
在 appsettings.json 中配置:
{
"StaticFileSettings": {
".txt": "text/plain; charset=utf-8",
".custom": "application/octet-stream"
}
}在 Web 项目的 Program.cs 中启用:
using Fast.NET.Core;
using Microsoft.AspNetCore.Builder;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.UseStaticFiles(builder.Configuration);
app.Run();键必须包含扩展名前导点,值为 MIME 类型。配置中的条目补充或覆盖 FileExtensionContentTypeProvider 的默认映射,未配置的扩展名保留默认映射;配置节缺失或没有条目时仍启用静态文件中间件并使用默认映射。
自定义配置节可通过 app.UseStaticFiles(builder.Configuration, "Files:MimeTypes") 指定。此重载仅配置内容类型映射,文件提供程序、请求路径及其他选项沿用 ASP.NET Core 默认值;示例文件放在默认 Web 根目录 wwwroot 下。实现见 静态文件扩展。
CORS 公开合同
builder.AddCorsAccessor() 使用构建器配置;服务集合重载接受 IConfiguration 与 section = "CorsAccessorSettings",另有回调重载。启动过滤器负责启用 CORS。
配置节点重载会执行 LoadPostConfigure();回调重载当前只创建选项并调用回调,不补齐默认值。回调中若需要下表默认配置,须显式 options.PostConfigure() 后再覆盖字段,不能假定两种重载初始化完全相同。
CorsAccessorSettingsOptions | 后配置默认值 / 语义 |
|---|---|
PolicyName | App.Cors.Policy |
WithOrigins | 空数组;未指定时不限制为一个固定来源 |
WithHeaders、WithMethods | 未指定时允许所有请求头/方法 |
WithExposedHeaders | Content-Disposition |
AllowCredentials | true |
FixedClientToken | true,补充令牌响应头暴露 |
SignalRSupport | false |
SetPreflightMaxAge | 无默认值;配置预检缓存时间 |
实际部署应显式限定来源。Initialize() 对转发头配置启用 XForwardedFor/XForwardedProto 并清空已知代理集合;应用必须按部署网络显式配置可信代理边界,不能把远端传入的地址直接当作可信身份。
其他公开入口
| API / 类型 | 行为与边界 |
|---|---|
AddGzipCompression() / UseGzipCompression() | 分别注册与启用响应压缩,二者不是互相替代 |
EnableBuffering() | 添加请求缓冲中间件;重复读取请求体仍需按流位置管理 |
UseMapHub() | 根据 Hub 元信息映射端点;需要宿主具备 SignalR 服务 |
HttpContext.GetRequestMethod() | 无上下文时返回 HttpRequestMethodEnum.Unknown |
FastContext | 共享配置、宿主环境与服务访问入口,不保证后台线程有请求上下文 |
RemoteRequestUtil | Get/Post/Put/Delete 及异步、泛型重载;响应内容与响应头以元组返回;SendAsync 校验地址与超时,外部请求异常传播 |
ShellUtil.Bash/Cmd | 启动真实子进程;timeout 为 0 时不设置有限等待,非零退出及超时可抛异常;不可将不可信输入直接拼成命令 |
MachineUtil、AssemblyUtil、JsonUtils | 机器/程序集/JSON 辅助;文件与平台访问需按具体方法判断 |
DiskInfo、DaySentenceInfo | 磁盘与远程每日句子数据对象;后者不代表离线数据服务 |
来源与验证
依据 初始化实现 与 CORS 选项。初始化与 CORS 示例沿用此前的静态核对记录;本次静态文件示例已使用当前 Core/Runtime 的 Release 程序集在 .NET 8、9、10 编译通过。未运行宿主、HTTP 请求、远程服务或 shell。
后台服务解析边界
后台调用方显式创建作用域并传入 provider;FastContext.GetService / GetRequiredService 不再为非单例创建隐式作用域。HTTP 管线只处理所属请求资源,不再释放全局后台对象集合。应用停止时才清理显式登记的应用级对象。
本次认证状态修复:保留最终 HTTP 401/403,不因新 Token 响应头改码;响应开始后不再改状态或重复写正文。
2026-11-02 依赖链变更
2026-11-02 依赖链同步:本包从 3.5.46 递增至 3.5.47,依赖更新为 Fast.Runtime 3.5.37。本模块自身实现与公开声明未变。Runtime 新增移动端 H5,并将 Android 及后续位依次后移;数字协议和掩码须迁移,消费端须重新编译并同步前端枚举,见 Runtime H5 迁移说明。
2026-10-24 版本与依赖
2026-10-24 将本包从 3.5.42 递增至 3.5.43,依赖更新至 Fast.Runtime 3.5.34。本模块自身实现和公开声明未改。
使用 AppEnvironmentEnum 的消费端需按 Runtime 鸿蒙迁移说明迁移数值并重新编译。本轮只核对源码与 MSBuild 有效包元数据,按要求不运行测试,也未执行还原、构建、打包或消费端运行验证。
2026-10-30 静态文件映射
Fast.NET.Core 从 3.5.43 递增至 3.5.44,新增从配置补充或覆盖静态文件 MIME 类型映射的 UseStaticFiles 重载,并完善其 XML 注释。默认配置节为 StaticFileSettings;Fast.Runtime 3.5.34 依赖保持不变。
新增静态文件示例已使用本次构建的 Core/Runtime 程序集在 net8.0、net9.0、net10.0 编译通过,未启动宿主或执行 HTTP 请求。现有入门示例仍固定引用 Fast.NET.Core 3.5.42,不用于验证该新增入口;本次构建、打包和文档检查结果记录在版本核对元数据中。
