CentOS 上使用 LibreOffice 编程接口概览
在 CentOS 上，LibreOffice 提供以 UNO（Universal Network Objects） 为核心的编程接口，支持 Python、Java、C++、LibreOffice Basic、JavaScript 等语言进行文档自动化与二次开发。UNO 是跨语言、跨平台的组件模型，典型用于文档的创建、编辑、转换与批量处理等场景。
接口与语言选择
- UNO 核心模型：以“服务-接口”分离为特点，常用服务包括 com.sun.star.frame.Desktop（加载与调度文档）、文本、表格、演示等服务接口。
- Python UNO：通过 PyUNO 绑定直接调用 UNO 接口，适合脚本化与批处理。
- Java UNO：使用 UNO Runtime 与 JAR（如 unoil.jar、jurt.jar 等），适合企业集成与大型应用。
- C++ UNO：基于 LibreOffice SDK 的 C++ 组件开发，适合性能与深度集成场景。
- 内置脚本：LibreOffice Basic、JavaScript（办公环境内脚本），适合快速原型与宏。
- 典型用途：文档格式转换（如 ODT/ DOCX/PDF）、模板填充、批量生成报表、内容批注与修订等。
环境准备与安装
- 安装 LibreOffice（示例）：
- 使用包管理器安装：sudo yum install libreoffice（版本以仓库为准）。
- 安装开发包（用于 Java/C++ 等开发）：
- sudo yum install libreoffice-sdk libreoffice-java（提供 UNO 运行时与开发所需库/头文件）。
- 安装 Python 绑定：
- 常见方式为系统包 libreoffice-python 或随 LibreOffice/SDK 提供的 PyUNO 组件；不同发行版与版本包名可能不同。
- 验证安装：
- 命令行执行 soffice --version 或 libreoffice --version 查看版本信息。
Python UNO 快速上手示例
- 启动 LibreOffice 监听（后台无界面）：
- 命令：libreoffice --headless --accept=“socket,host=localhost,port=2002;urp;” --nofirststartwizard &
- 转换文档为 PDF（Python 3）：
- 代码示例：
- import uno
- from com.sun.star.beans import PropertyValue
- local_ctx = uno.getComponentContext()
- resolver = local_ctx.ServiceManager.createInstanceWithContext(“com.sun.star.bridge.UnoUrlResolver”, local_ctx)
- ctx = resolver.resolve(“uno:socket,host=localhost,port=2002;urp;StarOffice.ComponentContext”)
- desktop = ctx.ServiceManager.createInstanceWithContext(“com.sun.star.frame.Desktop”, ctx)
- url = “file:///path/to/input.docx”
- doc = desktop.loadComponentFromURL(url, “_blank”, 0, ())
- props = (PropertyValue(Name=“Overwrite”, Value=True),)
- doc.storeToURL(“file:///path/to/output.pdf”, props)
- doc.dispose()
- 运行脚本：
- 命令：python3 convert_to_pdf.py
- 提示：文件路径需使用 file:// URL 格式；如为旧版本或自定义安装路径，可能需要在运行前设置 PYTHONPATH 指向 LibreOffice 的 program 目录。
Java UNO 快速上手示例
- 依赖准备：
- 安装 libreoffice-java，并将 LibreOffice 安装目录 program/classes 下的 JAR（如 unoil.jar、jurt.jar 等）加入项目构建路径（或 CLASSPATH）。
- 连接方式：
- 方式一：先启动 LibreOffice 监听（同上），Java 端通过 UnoUrlResolver 连接到 uno:socket,host=localhost,port=2002;urp;StarOffice.ComponentContext。
- 方式二：使用 com.sun.star.comp.helper.Bootstrap 在代码中引导并连接到 LibreOffice 运行时。
- 基本流程：
- 获取 XComponentContext → 获取 XMultiComponentFactory → 创建 Desktop → 调用 loadComponentFromURL 打开文档 → 通过接口操作文档模型 → 使用 storeToURL 导出（如 PDF）。
- 注意：JAR 版本需与已安装的 LibreOffice 主版本匹配，避免 NoClassDefFoundError/UnsatisfiedLinkError。
实践建议与常见问题
- 并发与稳定性：每个监听端口仅能容纳一个 LibreOffice 实例；并发建议启动多个实例并分配不同端口，或使用队列串行化处理。
- 无头与性能：批处理建议使用 –headless；首次启动较慢属正常，可预热进程池复用。
- 路径与编码：文件路径使用 file:// URL；处理中文路径或内容时注意系统 locale 与编码一致性。
- 版本匹配：LibreOffice、SDK、Python 绑定/JAR 版本需一致；跨小版本常出现接口或序列化不兼容。
- 调试工具：可使用 MRI 插件 浏览 UNO 对象模型、属性与方法，快速定位接口与属性名。
- 替代与补充：简单转换可直接用命令行 libreoffice --headless --convert-to pdf file.docx；如需处理 ODF 内容结构，可结合 ODF Toolkit。
