Struct DocBuilder 

pub struct DocBuilder { /* private fields */ }

构建完整 DOCX 文档的 Fluent 构建器。

通过门面 EasyDoc::document() 方法创建。

对应 Java: com.alibaba.excel.write.ExcelBuilderImpl

示例

EasyDoc::document("report.docx")
    .title("Report")
    .add_heading("Section 1", HeadingLevel::H1)
    .add_paragraph(Paragraph::new().add_text("Content..."))
    .add_table(Table::from_data(&rows))
    .build()?
    .save()?;

Implementations

impl DocBuilder

pub fn new(path: impl Into<PathBuf>) -> Self

Creates a new document builder targeting the given output path.

pub fn title(self, title: impl Into<String>) -> Self

Sets the document title.

pub fn author(self, author: impl Into<String>) -> Self

Sets the document author.

pub fn add_heading(self, text: impl Into<String>, level: HeadingLevel) -> Self

Adds a heading paragraph.

pub fn add_paragraph(self, paragraph: Paragraph) -> Self

Adds a paragraph.

pub fn add_table(self, table: Table) -> Self

Adds a table.

pub fn add_image(self, image: DocImage) -> Self

Adds an image.

pub fn add_page_break(self) -> Self

Adds a page break.

pub fn build(self) -> Result<DocWriteExecutor>

Finalises the builder and returns a DocWriteExecutor ready to save.

Errors

Returns an error if the document cannot be assembled.

pub fn save(self) -> Result<()>

Builds and immediately saves the document to disk.

Errors

Returns an error if the document cannot be written.

pub fn save_to_writer<W: Write + Seek>(self, writer: W) -> Result<()>

Builds and writes the document to a generic writer implementing Write + Seek.

Corresponds to Hutool’s Word07Writer.flush(OutputStream) pattern. Useful for writing to memory buffers, HTTP responses, etc.

Errors

Returns an I/O or ZIP error.

pub fn save_to_bytes(self) -> Result<Vec<u8>>

Builds and returns the document as a Vec<u8>.

Useful for in-memory generation without touching the filesystem.

Errors

Returns a ZIP error if packaging fails.