Sparkdo.AspNetCore 1.0.3

Sparkdo.AspNetCore

Sparkdo ASP.NET Core 集成库，提供与 ASP.NET Core 框架深度集成的功能实现。

功能特性

• ASP.NET Core 模块化集成：通过 Sparkdo 模块系统自动注册相关服务
• 审计日志：自动记录 HTTP 请求的审计信息
• 异常处理：统一处理 Web 请求中的异常并返回标准化错误响应
• 安全头：自动添加安全相关的 HTTP 响应头
• 工作单元：与 ASP.NET Core 请求生命周期集成的工作单元实现
• 虚拟文件系统：支持 Web 内容文件的虚拟文件系统实现
• 客户端信息：自动获取 Web 请求的客户端相关信息
• 请求本地化：支持基于请求的本地化功能
• 时区处理：自动处理请求时区信息
• 依赖注入：ASP.NET Core 作用域内的服务提供程序访问器

安装

<PackageReference Include="Sparkdo.AspNetCore" Version="x.x.x" />

核心组件

模块配置

• SparkdoAspNetCoreModule: ASP.NET Core 集成模块，负责注册所有相关服务

中间件

• SparkdoAuditingMiddleware: 审计日志中间件，记录 HTTP 请求的审计信息
• SparkdoExceptionHandlingMiddleware: 异常处理中间件，统一处理请求异常
• SparkdoSecurityHeadersMiddleware: 安全头中间件，添加安全相关的 HTTP 响应头
• SparkdoUnitOfWorkMiddleware: 工作单元中间件，管理请求生命周期内的工作单元
• SparkdoCorrelationIdMiddleware: 关联 ID 中间件，用于分布式追踪
• SparkdoRequestLocalizationMiddleware: 请求本地化中间件
• SparkdoTimeZoneMiddleware: 时区处理中间件

服务实现

• HttpContextClientScopeServiceProviderAccessor: HTTP 上下文客户端作用域服务提供程序访问器
• DefaultHttpExceptionStatusCodeFinder: HTTP 异常状态码查找器
• DefaultSparkdoAuthorizationExceptionHandler: Sparkdo 授权异常处理器
• AspNetCoreSecurityLogManager: ASP.NET Core 安全日志管理器
• HttpContextCancellationTokenProvider: HTTP 上下文取消令牌提供程序
• AspNetCoreUnitOfWorkTransactionBehaviorProvider: ASP.NET Core 工作单元事务行为提供程序
• SparkdoWebContentFileProvider: Sparkdo Web 内容文件提供程序
• HttpContextWebClientInfoProvider: HTTP 上下文 Web 客户端信息提供程序

扩展性

该库提供了 ASP.NET Core 相关的完整实现，可以通过以下方式扩展：

1. 自定义中间件来添加特定功能
2. 实现自定义的服务接口来替换默认实现
3. 通过配置选项来调整行为
4. 继承和重写默认实现来定制功能

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。