easyofd_reader/
seal_ofd_reader.rs

1//! 印章 OFD 解析器（废弃）。
2//!
3//! 对应 Java: org.ofdrw.reader.SealOFDReader
4//!
5//! 已废弃：Java 原始类标记为 `@Deprecated`，建议使用 `DLOFDReader`。
6//! Rust 版提供轻量门面，委托给 `OfdReaderFacade`。
7
8use std::io::{Read, Seek};
9
10use easyofd_core::{OfdPage, OfdResult};
11
12#[allow(deprecated)]
13use crate::model::OfdPageVo;
14use crate::ofd_reader_facade::OfdReaderFacade;
15use crate::read_options::ReadOptions;
16
17/// 印章 OFD 解析器。
18///
19/// 对应 Java: `org.ofdrw.reader.SealOFDReader`
20///
21/// **废弃**：Java 原始类标记为 `@Deprecated`，建议使用 [`OfdReaderFacade`]。
22///
23/// 专门用于解析包含印章的 OFD 文档。
24#[derive(Debug)]
25#[deprecated(since = "1.0.0", note = "使用 OfdReaderFacade 替代")]
26pub struct SealOfdReader {
27    /// 内部门面。
28    facade: OfdReaderFacade,
29}
30
31#[allow(deprecated)]
32impl SealOfdReader {
33    /// 从文件路径打开 OFD 文档。
34    ///
35    /// 对应 Java: `SealOFDReader(Path ofdFile)`
36    pub fn open(path: impl AsRef<std::path::Path>) -> OfdResult<Self> {
37        Ok(Self {
38            facade: OfdReaderFacade::open(path)?,
39        })
40    }
41
42    /// 从字节数组解析 OFD 文档。
43    ///
44    /// 对应 Java: `SealOFDReader(InputStream inputStream)`
45    pub fn from_bytes(data: &[u8]) -> OfdResult<Self> {
46        Ok(Self {
47            facade: OfdReaderFacade::from_bytes(data)?,
48        })
49    }
50
51    /// 从 `Read + Seek` 输入创建。
52    pub fn from_seek<R: Read + Seek>(source: R, options: ReadOptions) -> OfdResult<Self> {
53        Ok(Self {
54            facade: OfdReaderFacade::from_seek(source, options)?,
55        })
56    }
57
58    /// 获取内部门面引用。
59    #[must_use]
60    pub fn facade(&self) -> &OfdReaderFacade {
61        &self.facade
62    }
63
64    /// 获取文档页数。
65    #[must_use]
66    pub fn page_count(&self) -> usize {
67        self.facade.page_count()
68    }
69
70    /// 获取所有页面。
71    #[must_use]
72    pub fn pages(&self) -> &[OfdPage] {
73        self.facade.pages()
74    }
75
76    /// 获取 OFD 页面视图对象列表。
77    ///
78    /// 对应 Java: `SealOFDReader.getOFDPageVO()`
79    #[must_use]
80    pub fn get_ofd_page_vo(&self) -> Vec<OfdPageVo> {
81        self.facade
82            .pages()
83            .iter()
84            .enumerate()
85            .map(|(i, page)| {
86                let page_path = page
87                    .base_path
88                    .clone()
89                    .unwrap_or_else(|| format!("Pages/Page_{i}/Content.xml"));
90                OfdPageVo::new(page_path, None)
91            })
92            .collect()
93    }
94
95    /// 提取所有文本。
96    #[must_use]
97    pub fn extract_all_text(&self) -> String {
98        self.facade.extract_all_text()
99    }
100}
101
102#[cfg(test)]
103mod tests {
104    #[allow(deprecated)]
105    use super::*;
106    use easyofd_core::TextObject;
107    use easyofd_writer::OfdWriter;
108
109    fn build_test_ofd() -> Vec<u8> {
110        let mut writer = OfdWriter::new();
111        let mut page = OfdPage::new(210.0, 297.0);
112        page.add_text(TextObject::new(10.0, 20.0, "Seal Test"));
113        writer.add_page(page);
114        writer.build().unwrap()
115    }
116
117    #[test]
118    #[allow(deprecated)]
119    fn test_seal_ofd_reader_from_bytes() {
120        let bytes = build_test_ofd();
121        let reader = SealOfdReader::from_bytes(&bytes).unwrap();
122        assert_eq!(reader.page_count(), 1);
123    }
124
125    #[test]
126    #[allow(deprecated)]
127    fn test_seal_ofd_reader_get_ofd_page_vo() {
128        let bytes = build_test_ofd();
129        let reader = SealOfdReader::from_bytes(&bytes).unwrap();
130        let vos = reader.get_ofd_page_vo();
131        assert_eq!(vos.len(), 1);
132    }
133
134    #[test]
135    #[allow(deprecated)]
136    fn test_seal_ofd_reader_extract_text() {
137        let bytes = build_test_ofd();
138        let reader = SealOfdReader::from_bytes(&bytes).unwrap();
139        let text = reader.extract_all_text();
140        assert!(text.contains("Seal Test"));
141    }
142}
easyofd_reader/seal_ofd_reader.rs

easyofd_reader/
seal_ofd_reader.rs
