thymeleaf 0.1.0-beta.0

A framework-neutral Thymeleaf-compatible dynamic template engine for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use std::sync::Arc;

use crate::model::IModel;
use crate::processinginstruction::IProcessingInstructionStructureHandler;
use crate::util::{Utf16String, Validate, ValidateError};

/// 引擎内部 ProcessingInstruction 结构动作状态机。
///
/// 对应 Java:
/// `org.thymeleaf.engine.ProcessingInstructionStructureHandler`。
pub(crate) struct ProcessingInstructionStructureHandler {
    pub(crate) set_processing_instruction: bool,
    pub(crate) set_processing_instruction_target: Option<Utf16String>,
    pub(crate) set_processing_instruction_content: Option<Utf16String>,
    pub(crate) replace_with_model: bool,
    pub(crate) replace_with_model_value: Option<Arc<dyn IModel>>,
    pub(crate) replace_with_model_processable: bool,
    pub(crate) remove_processing_instruction: bool,
}

impl ProcessingInstructionStructureHandler {
    /// 创建无待执行动作的处理器。
    /// 对应 Java 语义：`ProcessingInstructionStructureHandler` 的 `new` 行为（Rust 侧辅助/私有路径）。
    pub(crate) fn new() -> Self {
        let mut handler = Self {
            set_processing_instruction: false,
            set_processing_instruction_target: None,
            set_processing_instruction_content: None,
            replace_with_model: false,
            replace_with_model_value: None,
            replace_with_model_processable: false,
            remove_processing_instruction: false,
        };
        handler.reset();
        handler
    }

    /// 设置 processing instruction 的 target 与 content。
    ///
    /// 对应 Java:
    /// `ProcessingInstructionStructureHandler#setProcessingInstruction(String, String)`。
    /// 方法先重置，再按 target、content 的顺序校验。
    pub(crate) fn set_processing_instruction_nullable(
        &mut self,
        target: Option<Utf16String>,
        content: Option<Utf16String>,
    ) -> Result<(), ValidateError> {
        self.reset();
        Validate::not_null(target.as_ref(), Some("Target cannot be null"))?;
        Validate::not_null(content.as_ref(), Some("Content cannot be null"))?;
        self.set_processing_instruction = true;
        self.set_processing_instruction_target = target;
        self.set_processing_instruction_content = content;
        Ok(())
    }

    /// 使用模型替换 processing instruction。对应 Java:
    /// `ProcessingInstructionStructureHandler#replaceWith(IModel, boolean)`。
    pub(crate) fn replace_with_nullable(
        &mut self,
        model: Option<Arc<dyn IModel>>,
        processable: bool,
    ) -> Result<(), ValidateError> {
        self.reset();
        Validate::not_null(model.as_deref(), Some("Model cannot be null"))?;
        self.replace_with_model = true;
        self.replace_with_model_value = model;
        self.replace_with_model_processable = processable;
        Ok(())
    }
}

impl IProcessingInstructionStructureHandler for ProcessingInstructionStructureHandler {
    fn reset(&mut self) {
        self.set_processing_instruction = false;
        self.set_processing_instruction_target = None;
        self.set_processing_instruction_content = None;
        self.replace_with_model = false;
        self.replace_with_model_value = None;
        self.replace_with_model_processable = false;
        self.remove_processing_instruction = false;
    }

    fn set_processing_instruction(&mut self, target: Utf16String, content: Utf16String) {
        self.set_processing_instruction_nullable(Some(target), Some(content))
            .expect("Rust non-null processing-instruction boundary must satisfy Java validation");
    }

    fn replace_with(&mut self, model: Arc<dyn IModel>, processable: bool) {
        self.replace_with_nullable(Some(model), processable)
            .expect("Rust non-null model boundary must satisfy Java validation");
    }

    fn remove_processing_instruction(&mut self) {
        self.reset();
        self.remove_processing_instruction = true;
    }
}