Expand description
§wordval-web
Wordval Web 层:路由、中间件、提取器、响应、会话认证、多租户。
§主要模块
app— 应用构建器Approuter— 路由注册与分发middleware— 认证、权限、会话等中间件idempotency—#[idempotent]宏运行时支撑(需启用cachefeature)extract— 请求提取器(当前用户、租户、文件等)resources— 全局资源管理(配置、数据库、缓存)tenant— 多租户支持
§快速开始
ⓘ
use wordval_web::{App, WordvalRouter};
let app = App::new()
.route("GET", "/api/hello", || "Hello, World!");Re-exports§
pub use app::App;pub use audit::AuditConfig;pub use audit::AuditRecord;pub use audit::AuditResult;pub use audit::AuditSink;pub use audit::AuditWriter;pub use extract::ClientContext;pub use extract::CurrentUser;pub use extract::FileSender;pub use extract::OptionalUser;pub use extract::RequestedTenantId;pub use extract::TenantId;pub use extract::ValidatedJson;pub use middleware::AuthLayer;pub use middleware::RequireRoleLayer;pub use middleware::RequestStart;pub use tenant::current_tenant_id;pub use tenant::require_tenant_id;pub use tenant::resolve_tenant;pub use tenant::tenant_context_layer;pub use tenant::with_tenant;pub use router::RouteEntry;pub use router::RouteGuard;pub use router::WordvalRouter;pub use crate::resources::cfg;pub use crate::resources::config;pub use crate::resources::set_config;pub use crate::resources::try_config;pub use crate::resources::audit_write;pub use crate::resources::audit_writer;pub use crate::resources::set_audit_writer;pub use crate::resources::shutdown_audit_writer;pub use crate::resources::try_audit_writer;pub use crate::resources::download_path;pub use crate::resources::set_download_path;pub use crate::resources::set_upload_path;pub use crate::resources::try_download_path;pub use crate::resources::try_upload_path;pub use crate::resources::upload_path;
Modules§
- app
- App 构建器——框架唯一入口,配置驱动,一行启动
- audit
- 批量审计写入器:高并发操作审计的落盘管道。
- chain
- 中间件链装配:优先级注册表
- extract
- 请求提取器:ValidatedJson、CurrentUser、OptionalUser、ClientContext、TenantId、RequestedTenantId、FileSender
- middleware
- Wordval 请求中间件模块
- policy
- 路由策略表
- resources
- 全局资源注册表
- router
- sse
- SSE(Server-Sent Events)响应辅助
- tenant
- 请求级租户上下文(task-local + extensions 双通道)
Structs§
Statics§
- ROUTES
- 路由注册分布式切片——
#[get]、#[post]等宏注解的处理器在此汇集
Type Aliases§
- ResResult
- API 响应结果类型