onvif-server 0.1.0

A spec-compliant ONVIF Profile S device server library 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

use soap_server::{WsdlError, WsdlLoader};

/// Serves bundled ONVIF WSDL and XSD files from bytes embedded at compile time.
///
/// Official ONVIF WSDLs use relative schemaLocation paths like
/// `"../../../ver10/schema/onvif.xsd"` — the filename component is extracted
/// via `rsplit('/')` so callers can use either the bare name or a relative path.
pub struct EmbeddedWsdlLoader;

impl WsdlLoader for EmbeddedWsdlLoader {
    fn load(&self, location: &str) -> Result<Vec<u8>, WsdlError> {
        // Strip any leading path — WSDLs use relative paths like "../common/onvif.xsd"
        let filename = location.rsplit('/').next().unwrap_or(location);
        match filename {
            "devicemgmt.wsdl" => Ok(include_bytes!("../wsdl/devicemgmt.wsdl").to_vec()),
            "media.wsdl" => Ok(include_bytes!("../wsdl/media.wsdl").to_vec()),
            "ptz.wsdl" => Ok(include_bytes!("../wsdl/ptz.wsdl").to_vec()),
            "imaging.wsdl" => Ok(include_bytes!("../wsdl/imaging.wsdl").to_vec()),
            // ONVIF events WSDL is named "event.wsdl" at source but stored as "events.wsdl"
            "events.wsdl" | "event.wsdl" => Ok(include_bytes!("../wsdl/events.wsdl").to_vec()),
            "onvif.xsd" => Ok(include_bytes!("../wsdl/onvif.xsd").to_vec()),
            "common.xsd" => Ok(include_bytes!("../wsdl/common.xsd").to_vec()),
            // W3C and OASIS external schemas imported by onvif.xsd.
            // Bundled as minimal stubs so ServerBuilder resolves the WSDL without network access.
            // URL → rsplit('/') → match key:
            //   https://www.w3.org/2005/05/xmlmime           → "xmlmime"
            //   https://www.w3.org/2003/05/soap-envelope     → "soap-envelope"
            //   http://docs.oasis-open.org/wsn/b-2.xsd       → "b-2.xsd"
            //   https://www.w3.org/2004/08/xop/include       → "include"
            "xmlmime" | "xmlmime.xsd" => Ok(include_bytes!("../wsdl/xmlmime.xsd").to_vec()),
            "soap-envelope" | "soap-envelope.xsd" => {
                Ok(include_bytes!("../wsdl/soap-envelope.xsd").to_vec())
            }
            "b-2.xsd" => Ok(include_bytes!("../wsdl/wsn-b2.xsd").to_vec()),
            // OASIS WS-BaseNotification and WS-ResourceFramework WSDLs imported by events.wsdl
            "bw-2.wsdl" => Ok(include_bytes!("../wsdl/wsn-bw2.wsdl").to_vec()),
            "rw-2.wsdl" => Ok(include_bytes!("../wsdl/wsrf-rw2.wsdl").to_vec()),
            // W3C WS-Addressing and OASIS WS-Notification topic XSDs imported by events.wsdl
            "ws-addr.xsd" => Ok(include_bytes!("../wsdl/ws-addr.xsd").to_vec()),
            "t-1.xsd" => Ok(include_bytes!("../wsdl/wsn-t1.xsd").to_vec()),
            "include" | "xop-include.xsd" => Ok(include_bytes!("../wsdl/xop-include.xsd").to_vec()),
            other => Err(WsdlError::MalformedXml(format!(
                "Unknown WSDL/XSD: {other}"
            ))),
        }
    }
}