Skip to main content

Crate wordval_web

Crate wordval_web 

Source
Expand description

§wordval-web

Wordval Web 层:路由、中间件、提取器、响应、会话认证、多租户。

§主要模块

  • app — 应用构建器 App
  • router — 路由注册与分发
  • middleware — 认证、权限、会话等中间件
  • idempotency — #[idempotent] 宏运行时支撑(需启用 cache feature)
  • 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§

ApiError
API 错误(对外暴露的统一错误类型)
PageData
分页数据结构
Res
统一 API 响应结构

Statics§

ROUTES
路由注册分布式切片——#[get]、#[post] 等宏注解的处理器在此汇集

Type Aliases§

ResResult
API 响应结果类型