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

use crate::util::Utf16String;
use crate::util::string_case_utils::to_lower_case_default;

use super::{ElementName, ElementNameError, ElementNameKind};

/// HTML 模式的大小写不敏感元素名称。
///
/// 对应 Java: `org.thymeleaf.engine.HTMLElementName`。
pub struct HTMLElementName {
    element_name: ElementName,
    complete_namespaced_element_name: Utf16String,
    complete_html5_element_name: Utf16String,
}

impl HTMLElementName {
    /// 对应 Java: `HTMLElementName#forName()`。
    pub(super) fn for_name(
        prefix: Option<Utf16String>,
        element_name: Option<Utf16String>,
    ) -> Result<Self, ElementNameError> {
        let normalized_element = element_name.filter(|value| !value.is_empty()).map_or_else(
            || Utf16String::from_utf16(Vec::new()),
            |value| to_lower_case_default(&value),
        );
        let normalized_prefix = prefix
            .as_ref()
            .filter(|value| !value.is_empty())
            .map(to_lower_case_default);
        let (namespaced, html5, complete_names) = if let Some(prefix) = normalized_prefix.as_ref() {
            let namespaced = join(prefix, b':', &normalized_element, None);
            let html5 = join(prefix, b'-', &normalized_element, None);
            (
                namespaced.clone(),
                html5.clone(),
                vec![Some(namespaced), Some(html5)],
            )
        } else {
            (
                normalized_element.clone(),
                normalized_element.clone(),
                vec![Some(normalized_element.clone())],
            )
        };
        let base = ElementName::new(
            ElementNameKind::Html,
            normalized_prefix,
            Some(normalized_element),
            complete_names,
        )?;
        Ok(Self {
            element_name: base,
            complete_namespaced_element_name: namespaced,
            complete_html5_element_name: html5,
        })
    }

    /// 返回基础 `ElementName` 视图。
    #[must_use]
    pub const fn as_element_name(&self) -> &ElementName {
        &self.element_name
    }

    /// 返回 `prefix:name` 形式的完整名称。
    #[must_use]
    pub const fn get_complete_namespaced_element_name(&self) -> &Utf16String {
        &self.complete_namespaced_element_name
    }

    /// 返回 `prefix-name` 形式的 HTML5 完整名称。
    #[must_use]
    pub const fn get_complete_html5_element_name(&self) -> &Utf16String {
        &self.complete_html5_element_name
    }
}

fn join(
    prefix: &Utf16String,
    separator: u8,
    name: &Utf16String,
    leading: Option<&str>,
) -> Utf16String {
    let mut result = leading.map_or_else(Vec::new, |value| value.encode_utf16().collect());
    result.extend_from_slice(prefix.as_utf16());
    result.push(u16::from(separator));
    result.extend_from_slice(name.as_utf16());
    Utf16String::from_utf16(result)
}