wdpe 0.4.2

WebDynpro Parse Engine
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

use crate::body::Body;
use crate::element::sub::SubElement;
use crate::element::sub::definition::SubElementDefinition;
use crate::element::{Element, definition::ElementDefinition};
use crate::error::{ElementError, WebDynproError};
use scraper::Html;

/// DOM에서 엘리먼트를 파싱하기 위한 파서
pub struct ElementParser(Html);

// This is safe since `ElementParser` is immutable.
unsafe impl Send for ElementParser {}

unsafe impl Sync for ElementParser {}

impl<'s> ElementParser {
    /// [`Body`]로부터 새로운 파서를 만듭니다.
    pub fn new(body: &Body) -> Self {
        let document = Html::parse_document(body.raw_body());
        Self(document)
    }

    /// [`ElementDefinition`]을 구현하는 값에서 알맞는 [`Element`]를 만듭니다.
    pub fn element_from_def<T: ElementDefinition<'s>>(
        &'s self,
        definition: &T,
    ) -> Result<T::Element, WebDynproError> {
        let selector = definition.selector()?;
        let element_ref = self
            .0
            .select(&selector)
            .next()
            .ok_or(ElementError::InvalidId(definition.id().to_string()))?;
        Element::from_ref(definition, element_ref)
    }

    /// [`SubElementDefinition`]을 구현하는 값에서 알맞는 [`SubElement`]를 만듭니다.
    pub fn subelement_from_def<T: SubElementDefinition<'s>>(
        &'s self,
        definition: &T,
    ) -> Result<T::SubElement, WebDynproError> {
        let selector = definition.selector()?;
        let element_ref = self
            .0
            .select(&selector)
            .next()
            .ok_or(ElementError::InvalidId(definition.id().to_string()))?;
        SubElement::from_ref(definition, element_ref)
    }

    /// 파서 내의 [`Html`]을 반환합니다.
    pub fn document(&'s self) -> &'s Html {
        &self.0
    }
}