组件总览
当前文档对应 Aegis 3.0.0。组件文档只公开 public 与成熟 specialized 组件,supporting/internal_only 组件继续保留在开发指南里。
公开组件总数:39,按能力域分为 7 组。
应用与基础设施
业务服务契约、配置管理、上下文传递、跨域、日志、接口文档、容错策略、自定义组件
Aegis.Services
业务服务契约与自动装配,含 PagedResult、ServiceResult
配置Aegis.Configuration
统一配置读取,支持按节点强类型绑定
配置中心扩展Aegis.Configuration.ConfigCenter
对接配置中心,支持运行时动态刷新
上下文Aegis.Context
请求级 ActionContext 与全局 AppContext 上下文传递
基础设施Aegis.Core.Infrastructure
宿主启动、中间件管线、统一响应类型与异常处理
跨域支持Aegis.Core.Cors
CORS 策略配置,支持指定允许的源和方法
日志Aegis.Core.Logs
基于 NLog 的结构化日志组件
Swagger 文档扩展Aegis.Extensions.Swagger
集成 Swagger/OpenAPI,自动生成接口文档与调试界面
Polly 容错扩展Aegis.Extensions.Polly
重试、熔断、超时、降级等弹性策略
自定义组件注入Aegis.Component
通过 Component.deps.json 声明式启用和装配自定义组件
认证与鉴权
Bearer Token 认证管线、授权策略、SSO/JWT/ESS 多方案、分布式会话
Aegis.Core.Authentication
认证管线、Token 中间件与 CurrentUser 上下文基座
基础授权Aegis.Core.Authorization
角色与策略授权框架,可扩展权限校验逻辑
SSO 认证Aegis.Authorization.SSO
对接统一单点登录,Token 校验与用户信息同步
ESS 认证鉴权Aegis.Authorization.ESS
ESS 平台认证鉴权一体化方案,含角色与菜单权限
JWT 认证Aegis.Authorization.Jwt
基于 JWT 的签发、校验与刷新 Token 实现
Redis 用户会话Aegis.Authorization.RedisUserManager
分布式会话存储,支持多实例共享登录状态
数据与状态
多级缓存、分布式 ID 生成、FreeSql ORM 数据访问
Aegis.Caching.Redis
Redis 数据源、Lua 脚本管理与多级缓存底座
ID 生成器Aegis.IdGenerator
雪花算法 ID 生成,支持多容器扩展
Redis ID 生成提供程序Aegis.IdGenerator.Provider.Redis
基于 Redis 的 WorkerId 分配,适配多实例部署
FreeSql 数据访问Aegis.Core.FreeSql
FreeSql ORM 集成,含仓储注册、工作单元与多数据源
通信与集成
声明式 HTTP 客户端、实时双向通信、进程内/分布式事件总线、RocketMQ
Aegis.Net.Broker
声明式 HTTP 客户端,接口契约即调用,自动序列化
实时通信Aegis.Net.SignalR
SignalR Hub 封装,支持服务端推送与客户端订阅
事件总线Aegis.EventBus
基于 Channel 的进程内事件发布/订阅,解耦业务模块
Redis 事件总线容器扩展Aegis.EventBus.Container.Redis
基于 Redis Pub/Sub 的跨实例事件广播
RocketMQ 客户端Aegis.RocketMQ.Client
RocketMQ 消息生产与消费封装,支持顺序和延迟消息
调度与可观测
延迟任务调度、Prometheus 指标采集、OpenTelemetry 分布式追踪、结构化日志
Aegis.Jobs
基于时间轮的延迟任务调度框架,含状态机与持久化
Postgres 任务存储扩展Aegis.Jobs.Postgres
PostgreSQL 存储后端,任务状态持久化到 PgSQL
SqlServer 任务存储扩展Aegis.Jobs.SqlServer
SQL Server 存储后端,任务状态持久化到 MSSQL
Prometheus 指标监控Aegis.Prometheus
暴露 /metrics 端点,集成 Prometheus 指标采集
OpenTelemetry 链路追踪Aegis.Trace.OpenTelemetry
分布式链路追踪,对接 Jaeger/Zipkin 等后端
UMeta 结构化日志Aegis.UMeta.Logging
结构化日志输出,支持集中采集与检索
文档与文件
文档格式转换、模板渲染、在线编辑、多后端文件管理
Aegis.Documents
文档处理统一入口,聚合转换、编辑与渲染能力
LibreOffice 文档转换Aegis.Documents.Conversion.LibreOffice
调用 LibreOffice 进行 Word/Excel/PPT 转 PDF 等格式转换
OFD 文档转换Aegis.Documents.Conversion.Ofd
OFD 版式文档转 PDF 或图片
Playwright 文档转换Aegis.Documents.Conversion.Playwright
基于 Playwright 的 HTML/PDF 渲染转换
OpenXml 文档编辑Aegis.Documents.Editing.OpenXml
基于 OpenXml SDK 的 Word/Excel 模板填充与编辑
Razor 文档渲染Aegis.Documents.Rendering.Razor
Razor 模板引擎渲染,动态生成 HTML 或 PDF
文件管理Aegis.FileManager
文件上传下载统一抽象,可对接多种存储后端
NAS 文件存储Aegis.FileManager.Nas
NAS/本地磁盘文件存储实现
S3 文件存储Aegis.FileManager.S3
S3 协议兼容对象存储,支持 MinIO/Ceph 等
安全与工具
操作审计日志、数据加密解密、通用状态机