Skip to main content

qualia_core_db/domains/geospatial/adapters/
wms_adapter.rs

1use crate::domains::geospatial::adapters::AdapterHttpRequest;
2use crate::net::disclosure::NetworkDisclosureRegistry;
3
4pub enum OgcServiceType {
5    Wms,
6    Wfs,
7    Wcs,
8    Wmts,
9}
10
11/// Adapter for OGC Web Services (WMS, WFS, WCS, WMTS).
12pub struct WmsAdapter {
13    pub id: &'static str,
14    pub endpoint: String,
15    pub service_type: OgcServiceType,
16}
17
18impl WmsAdapter {
19    /// Creates a WMS/WFS adapter for `endpoint` of `service_type`.
20    pub fn new(id: &'static str, endpoint: &str, service_type: OgcServiceType) -> Self {
21        Self {
22            id,
23            endpoint: endpoint.to_string(),
24            service_type,
25        }
26    }
27}
28
29impl WmsAdapter {
30    /// Stable adapter identifier.
31    pub fn adapter_id(&self) -> &'static str {
32        self.id
33    }
34
35    /// Builds an OGC fetch request for a region.
36    pub fn build_fetch_request(
37        &self,
38        bbox: (f64, f64, f64, f64),
39        time_range: (u64, u64),
40        registry: &NetworkDisclosureRegistry,
41    ) -> Result<AdapterHttpRequest, String> {
42        if !registry.check_egress_consent(self.adapter_id(), &self.endpoint) {
43            return Err(format!(
44                "Consent denied or unregistered for endpoint {} by adapter {}",
45                self.endpoint,
46                self.adapter_id()
47            ));
48        }
49
50        let (service, request) = match self.service_type {
51            OgcServiceType::Wms => ("WMS", "GetMap"),
52            OgcServiceType::Wfs => ("WFS", "GetFeature"),
53            OgcServiceType::Wcs => ("WCS", "GetCoverage"),
54            OgcServiceType::Wmts => ("WMTS", "GetTile"),
55        };
56
57        let mut url = format!(
58            "{}?SERVICE={}&REQUEST={}&BBOX={},{},{},{}",
59            self.endpoint, service, request, bbox.0, bbox.1, bbox.2, bbox.3
60        );
61
62        if time_range.1 > 0 {
63            let iso_time = super::format_iso8601_range(time_range);
64            url.push_str(&format!("&TIME={}", iso_time));
65        }
66
67        Ok(AdapterHttpRequest::get(url, "OGC"))
68    }
69
70    /// Fetches map/feature data for the region.
71    pub fn fetch_region(
72        &self,
73        bbox: (f64, f64, f64, f64),
74        time_range: (u64, u64),
75        registry: &NetworkDisclosureRegistry,
76    ) -> Result<(), String> {
77        let request = self.build_fetch_request(bbox, time_range, registry)?;
78        super::execute_http_request_status(&request)?;
79        // Parsing response data is deferred.
80        Ok(())
81    }
82}
83
84#[cfg(test)]
85mod tests {
86    use super::*;
87
88    #[test]
89    fn test_wms_adapter_egress() {
90        let adapter = WmsAdapter::new(
91            "wms_adapter",
92            "https://wms.example.com/geoserver/wms",
93            OgcServiceType::Wms,
94        );
95        let registry = NetworkDisclosureRegistry::new();
96
97        let res1 = adapter.fetch_region((-1.0, 51.0, 0.0, 52.0), (0, 0), &registry);
98        assert!(res1.is_err());
99
100        let mut registry = registry;
101        registry.register_egress(
102            adapter.adapter_id(),
103            "https://wms.example.com/geoserver/wms",
104            "Fetch raster map tiles via WMS GetMap",
105            "User enables base map layer",
106        );
107
108        let res2 = adapter.fetch_region((-1.0, 51.0, 0.0, 52.0), (0, 0), &registry);
109        if let Err(e) = res2 {
110            assert!(
111                !e.contains("Consent denied"),
112                "Failed on consent when it should have been granted: {}",
113                e
114            );
115        }
116    }
117}