wordval-web 1.0.13

Wordval web layer: router, middleware, extractors, responses, session-based authentication
Documentation
//! # wordval-web
//!
//! Wordval Web 层:路由、中间件、提取器、响应、会话认证、多租户。
//!
//! ## 主要模块
//!
//! - [`app`] — 应用构建器 `App`
//! - [`router`] — 路由注册与分发
//! - [`middleware`] — 认证、权限、会话等中间件
//! - `idempotency` — `#[idempotent]` 宏运行时支撑(需启用 `cache` feature)
//! - [`extract`] — 请求提取器(当前用户、租户、文件等)
//! - [`resources`] — 全局资源管理(配置、数据库、缓存)
//! - [`tenant`] — 多租户支持
//!
//! ## 快速开始
//!
//! ```ignore
//! use wordval_web::{App, WordvalRouter};
//!
//! let app = App::new()
//!     .route("GET", "/api/hello", || "Hello, World!");
//! ```

pub mod app;
pub mod audit;
pub mod chain;
pub mod extract;
#[cfg(feature = "cache")]
pub mod idempotency;
pub mod middleware;
pub mod policy;
pub mod resources;
pub mod router;
pub mod sse;
pub mod tenant;

#[cfg(feature = "template")]
pub mod template_engine;

pub use app::App;
pub use audit::{AuditConfig, AuditRecord, AuditResult, AuditSink, AuditWriter};
pub use extract::{
    ClientContext, CurrentUser, FileSender, OptionalUser, RequestedTenantId, TenantId,
    ValidatedJson,
};
pub use middleware::{AuthLayer, RequireRoleLayer, RequestStart};
pub use tenant::{
    current_tenant_id, require_tenant_id, resolve_tenant, tenant_context_layer, with_tenant,
};
// 统一响应类型定义在 wordval-core(框架公共"语言"),此处仅转发保持既有路径
pub use router::{RouteEntry, RouteGuard, WordvalRouter};
pub use wordval_core::api::{ApiError, PageData, Res, ResResult};

#[cfg(feature = "cache")]
pub use crate::resources::{cache, set_cache, try_cache};
pub use crate::resources::{cfg, config, set_config, try_config};
pub use crate::resources::{
    audit_write, audit_writer, set_audit_writer, shutdown_audit_writer, try_audit_writer,
};
#[cfg(feature = "db")]
pub use crate::resources::{
    db, db_default, db_names, register_db, remove_db, set_db, set_dbs, try_db, try_using, DbHandle,
    DEFAULT_DB_NAME,
};
pub use crate::resources::{
    download_path, set_download_path, set_upload_path, try_download_path, try_upload_path,
    upload_path,
};
#[cfg(feature = "template")]
pub use crate::resources::{render_template, set_template, try_template};
#[cfg(feature = "template")]
pub use crate::template_engine::TemplateEngine;

/// 路由注册分布式切片——`#[get]`、`#[post]` 等宏注解的处理器在此汇集
///
/// 宏注解把路由与守卫策略(权限 / 免认证 / 审计)一并注册到 [`WordvalRouter`],
/// 启动时 `App` 从路由元数据派生中间件规则,不再需要单独的规则切片。
#[linkme::distributed_slice]
pub static ROUTES: [fn(&mut WordvalRouter)] = [..];