Aster文档
搜索 Aster 文档
ESC
产品
版本

输入关键词开始搜索。

    文档目录

    ASTER BOOT / 01

    Aster Boot 产品概览

    aster-boot 的模块、类型化 Provider、协议中立管线和适配器边界。

    aster-boot 是模块化 Rust 异步服务框架。当前版本为 0.2.0。模块组织应用,Provider 提供依赖,Controller 暴露路由,协议中立管线处理请求。

    Boot 不是 Axum 包装器。请求、响应、路由和执行上下文属于 Boot 核心。Axum 是默认 HTTP 适配器。

    架构图Boot 的协议中立应用边界模块和 Provider 组成应用,Controller 与消息处理器进入协议中立管线,再由 HTTP 或消息适配器连接外部协议。
    Boot 的协议中立应用边界模块和 Provider 提供应用结构。Controller、Gateway 和消息模式进入统一管线。HTTP 与消息适配器负责协议连接。Module + 类型化 ProviderController / Gateway / MessagePattern协议中立管线Guard / Interceptor / Pipe / FilterAxum HTTP 与 WebSocket 适配器MessageTransport进程内或可选网络后端

    核心合同

    Boot 的应用组成
    对象职责边界
    Module组织导入、Provider、Controller、Gateway 和生命周期通过可见性规则组合功能边界
    Provider按类型或名称提供依赖支持 singleton、request 和 transient 作用域
    Controller / Gateway声明 HTTP、WebSocket 和消息处理器协议细节交由适配器处理
    Execution Pipeline执行 middleware、guard、interceptor、pipe 和 filter重试不会回滚外部副作用
    Adapter / Transport连接 HTTP、WebSocket 和消息后端外部服务仍需独立部署与验证

    属性宏在编译期生成普通 Boot 定义。动态注册仍使用显式 Builder API,不依赖运行时 decorator 元数据。

    Feature 边界

    默认 feature 是 axum、macros 和 shutdown-hooks。其他集成按需启用。

    常用可选 Feature
    领域Feature说明
    配置与安全config、auth、security、sessionACL、认证、安全策略和会话抽象
    数据与任务database、cache、queue、queue-postgres后端抽象与 PostgreSQL 持久队列
    事件与调度events、cqrs、schedule事件、命令查询和定时任务
    协议tcp、redis、nats、mqtt、rabbitmq、kafka、grpc 对应 feature共享 MessageTransport 合同
    HTTP 辅助openapi-schemas、file-upload、static、compressionSchema、上传、静态文件和压缩

    Feature 只暴露对应集成。Database、Cache、Session 和 Queue 抽象不代表所有生产后端都已交付。

    文档入口

    实现依据