wordval-web 1.0.13

Wordval web layer: router, middleware, extractors, responses, session-based authentication
Documentation
//! Template engine abstraction — 运行时模板用 Tera

use parking_lot::RwLock;
use std::sync::Arc;
use wordval_core::Result;

/// 模板引擎(封装 Tera,启动时一次性加载模板目录)
#[derive(Clone)]
pub struct TemplateEngine {
    tera: Arc<RwLock<tera::Tera>>,
}

impl TemplateEngine {
    /// 创建空引擎(不加载任何模板,仅支持 `render_str`)
    pub fn new() -> Self {
        Self {
            tera: Arc::new(RwLock::new(tera::Tera::default())),
        }
    }

    /// 加载模板目录,模板通过文件名引用(如 "index.html", "dashboard.html")
    pub fn from_dir(dir: &str) -> Result<Self> {
        let glob = format!("{}/**/*", dir.trim_end_matches('/'));
        let tera = tera::Tera::new(&glob)
            .map_err(|e| wordval_core::Error::Template(format!("模板加载失败 {}: {}", dir, e)))?;
        Ok(Self {
            tera: Arc::new(RwLock::new(tera)),
        })
    }

    /// 渲染指定模板
    pub fn render<C: serde::Serialize>(&self, name: &str, ctx: &C) -> Result<String> {
        let ctx = tera::Context::from_serialize(ctx)
            .map_err(|e| wordval_core::Error::Template(format!("模板上下文序列化失败: {}", e)))?;
        self.tera
            .read()
            .render(name, &ctx)
            .map_err(|e| wordval_core::Error::Template(format!("模板渲染失败: {}", e)))
    }

    /// 从字符串渲染(每次创建独立 Tera 实例,避免并发冲突)
    pub fn render_str<C: serde::Serialize>(&self, source: &str, ctx: &C) -> Result<String> {
        let ctx = tera::Context::from_serialize(ctx)
            .map_err(|e| wordval_core::Error::Template(format!("模板上下文序列化失败: {}", e)))?;
        let mut t = tera::Tera::default();
        t.add_raw_template("__tpl__", source)
            .map_err(|e| wordval_core::Error::Template(format!("模板编译失败: {}", e)))?;
        t.render("__tpl__", &ctx)
            .map_err(|e| wordval_core::Error::Template(format!("模板渲染失败: {}", e)))
    }
}

impl Default for TemplateEngine {
    fn default() -> Self {
        Self::new()
    }
}