syncfusion-java-word

Word（DOCX）文档处理

概述

使用 Syncfusion Word Library 创建、编辑和转换 Word（.docx、.html）文件。 此技能支持一种操作模式——为用户的项目生成 Java 代码。

核心功能

• 创建和编辑： 文档（.docx、.rtf、.txt、.xml、.html）、段落、标题、样式、列表、表格、形状、图像、超链接、书签、水印、页眉/页脚、表单字段、内容控件。
• 高级功能： 邮件合并（DataTable、JSON、XML、自定义对象）、修订跟踪、批注、数学公式（LaTeX）、比较/拆分/合并文档。
• 转换： HTML ↔ DOCX、RTF ↔ DOCX、文本 ↔ DOCX、XML ↔ DOCX
• 安全性： 密码加密/解密、带可编辑区域的文档保护、宏管理

前提条件

• Java SE 8.0（1.8）或更高版本。
• Syncfusion 许可证：https://www.syncfusion.com/products/communitylicense

快速入门示例

示例 1：生成代码（模式 1）

用户：“请演示如何创建带表格的 Word 文档”

结果： 显示 Java 代码片段（不创建文件）

工作流：

步骤 1 — 建议添加 docio jars 作为引用

• Java 应用程序需要引用以下 jar 文件。
• syncfusion®-docio
• syncfusion®-javahelper
• 安装 file formats controls 后即可获取依赖 jar 文件。可在安装目录中找到所需的 jar 文件。
• 位置：{ProgramFilesFolder}\Syncfusion\Essential Studio\ {Platform}\ {version}\JarFiles
• 示例：C:\Program Files (x86)\Syncfusion\Essential Studio\FileFormats\18.3.0.35\JarFiles

步骤 2 — 仅使用参考文件生成代码

请勿编造、猜测或建议参考文件中未明确列出的任何 API、方法、类或包。

• 阅读与所请求功能相关的 references/*.md 文件
• 严格依据这些文件中的 API 和代码片段编写 Java 代码

---

代码参考

所有模板和代码片段都在 references/ 文件夹中：

文件	内容
document-structure.md	创建/加载文档、添加节、页面设置、保存到文件或流、支持的格式
styles-and-formats.md	段落、标题、项目符号列表和编号列表
paragraph-and-styles.md	添加段落、段落格式设置、样式（内置/自定义）、文本格式设置、制表位、分隔符、符号、文本框
tables.md	创建表格、单元格格式设置、合并单元格
bookmarks.md	创建书签、导航、检索、插入、替换、删除内容
shapes.md	添加形状、设置格式、旋转、组合、取消组合形状
mail-merge.md	简单字段合并、与区域（组）合并、嵌套合并、DataTable、动态对象、业务对象、DataView、XML、JSON、图像合并字段、合并事件（MergeField、MergeImageField、BeforeClearField、BeforeClearGroupField）、字段映射、检索合并字段名称、删除空段落、清除字段选项
form-fields.md	添加复选框、下拉列表、文本输入字段，修改属性
macros.md	加载/保存启用宏的文档（DOTM、DOCM）、检查是否包含宏、删除宏、在转换过程中保留宏
mathematical-equation.md	创建公式（分数、根式、矩阵、N 元数组等）、修改现有公式、LaTeX 支持、公式格式设置
split-word-documents.md	按节、标题、书签、占位文本拆分文档
merge-word-documents.md	在新页面或同一页面合并文档、保留导入的列表样式
compare-word-documents.md	比较两个 Word 文档、设置作者和日期、比较选项、忽略格式更改
html-conversions.md	将 HTML 转换为 DOCX、将 DOCX 转换为 HTML、XHTML 验证、自定义图像（导入/导出）、CSS 选择器、导出选项、导出页眉/页脚
rtf-conversions.md	将 RTF 转换为 DOCX、将 DOCX 转换为 RTF、保留格式和内容
markdown-conversion.md	将 Markdown 转换为 DOCX、将 DOCX 转换为 Markdown、自定义图像、支持 CommonMark 和 GitHub 风格语法
text-conversions.md	将 Text 转换为 DOCX、将 DOCX 转换为 Text、提取纯文本、保留文本内容
xml-conversions.md	将 Word 转换为 XML（WordML）、将 XML 转换为 Word、Word Processing XML 格式（2007+）
encryption.md	使用密码加密、打开加密文档、移除加密、保护文档免于编辑、可编辑区域
watermark.md	文本和图片水印、水印布局、缩放、冲淡效果、移除水印
find-and-replace.md	Find/FindAll/FindNext、Replace（字符串/正则表达式）、ReplaceSingleLine 和 FindItem* API
footnotes-and-endnotes.md	添加脚注和尾注、设置位置（页面底部/节末）、编号格式、分隔符、修改内容、移除注释
track-changes.md	启用/禁用修订、接受/拒绝更改、按审阅者筛选、修订信息
comments.md	添加/修改/移除批注、在指定文本上插入批注、访问父批注、检索带批注的项目
content-controls.md	块级和内联内容控件、类型（富文本、纯文本、复选框、日期、下拉列表、图片）、属性、保护、填写表单、XML 映射
header-footer.md	添加/移除页眉和页脚、使用字段（日期、时间）添加页码、奇偶页设置、首页不同、边框、图像、链接到前一节
hyperlinks.md	网页超链接、电子邮件超链接、文件超链接、书签超链接、图像超链接、修改超链接

---

规则

• 切勿使用 Python 库（例如 python-docx）