跳到正文

Fast.NET.Core ​

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

参考源码版本 3.5.47;目标 net8.0、net9.0、net10.0;依赖 Fast.Runtime。负责 Web 应用初始化、JSON 配置扫描、CORS、压缩、请求缓冲、静态文件 MIME 类型映射和运行环境辅助。

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

Fast.NET 入门示例使用 3.5.42 验证。

bash
dotnet add package Fast.NET.Core

初始化与管道 ​

csharp
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 中配置:

json
{
	"StaticFileSettings": {
		".txt": "text/plain; charset=utf-8",
		".custom": "application/octet-stream"
	}
}

在 Web 项目的 Program.cs 中启用:

csharp
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后配置默认值 / 语义
PolicyNameApp.Cors.Policy
WithOrigins空数组;未指定时不限制为一个固定来源
WithHeaders、WithMethods未指定时允许所有请求头/方法
WithExposedHeadersContent-Disposition
AllowCredentialstrue
FixedClientTokentrue,补充令牌响应头暴露
SignalRSupportfalse
SetPreflightMaxAge无默认值;配置预检缓存时间

实际部署应显式限定来源。Initialize() 对转发头配置启用 XForwardedFor/XForwardedProto 并清空已知代理集合;应用必须按部署网络显式配置可信代理边界,不能把远端传入的地址直接当作可信身份。

其他公开入口 ​

API / 类型行为与边界
AddGzipCompression() / UseGzipCompression()分别注册与启用响应压缩,二者不是互相替代
EnableBuffering()添加请求缓冲中间件;重复读取请求体仍需按流位置管理
UseMapHub()根据 Hub 元信息映射端点;需要宿主具备 SignalR 服务
HttpContext.GetRequestMethod()无上下文时返回 HttpRequestMethodEnum.Unknown
FastContext共享配置、宿主环境与服务访问入口,不保证后台线程有请求上下文
RemoteRequestUtilGet/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,不用于验证该新增入口;本次构建、打包和文档检查结果记录在版本核对元数据中。