使用 ONLYOFFICE API 构建 Java 转换器,在 Word 和 PDF 之间进行转换

文章作者:ajun

随着文档处理需求的增加,格式转换成为了一个重要的需求点。由于PDF格式具有跨平台、不易被篡改的特性,将Word格式(.docx)转换为PDF格式(.pdf)的需求尤为强烈。ONLYOFFICE作为一个强大的办公套件,提供了这样的转换功能,使得用户可以轻松地在Word和PDF之间进行转换。

除此之外,ONLYOFFICE 还提供.xlsx、.pptx等等多种文件格式的转换,更多参考 Conversion API 文档

ONLYOFFICE 文档是什么

ONLYOFFICE 文档是一个功能强大的文档编辑器,支持处理文本文档、电子表格、演示文稿、可填写表单、PDF 和电子书,可多人在线协作,支持 AI 集成。它具有丰富的插件库,并且支持自行开发上传插件。

ONLYOFFICE 文档开发者版可以无缝地适应您的网络应用,支持多种流行的编程语言和开发框架,包括JavaScript、Python、Java、C# 等。为前端框架也提供现成的组件样本 (Angular, React, Vue 等)。

如何转换

使用功能转换
  1. 打开.docx格式文档: 在ONLYOFFICE中,打开您想要转换的.docx格式文档。
  2. 导出为PDF: 在ONLYOFFICE的顶部菜单中,选择"文件"->"导出为"->"PDF"。
  3. 选择保存位置: 您将被提示选择一个保存位置来保存转换后的PDF文件。
  4. 完成转换: 点击"保存"后,ONLYOFFICE将开始将您的.docx格式文档转换为PDF格式。转换完成后,您可以在之前选择的位置找到转换后的PDF文件。
使用API转换
  1. 提前安装 ONLYOFFICE 文档服务
  2. 调用 ONLYOFFICE 转换 API 接口 将.docx格式文档转换为.pdf。转换之后会返回一个pdf文档地址。
  3. 请求示例

**请求地址:**https://ONLYOFFICE文档服务地址/ConvertService.ashx

**请求方式:**POST请求

请求参数:

复制代码
{

    "async": false,      //是否异步转换

    "filetype": "docx",  //需要转换的文档格式 docx

    "key": "con_0121",   //转换的可以

    "outputtype": "pdf", //转换成的结果文档格式 pdf

    "title": "Example Document Title.docx", //文档的标题

    "url": " " // 需要转换的文档url地址

}

返回结果:

复制代码
<?xml version="1.0" encoding="utf-8"?>
<FileResult>
    <FileUrl>
        http://xx/cache/files/conv_con_0121_pdf/output.pdf/Example%20Document%20Title.pdf?md5=yaTSuivWKzKK6Zi6Nn7UwA&amp;expires=1705987451&amp;filename=Example%20Document%20Title.pdf
    </FileUrl>
    <Percent>
        100
    </Percent>
    <EndConvert>
        True
    </EndConvert>
</FileResult>

Java语言实现:

java 复制代码
OkHttpClient client = new OkHttpClient().newBuilder()
   .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"async\": false,\n    \"filetype\": \"docx\",\n    \"key\": \"Khirz6zTPdfd7\",\n    \"outputtype\": \"pdf\",\n    \"password\": \"123456\",\n    \"title\": \"Example Document Title.docx\",\n    \"url\": \"https://example.com/url-to-example-document.docx\"\n}");
Request request = new Request.Builder()
   .url("https://ONLYOFFICE文档服务地址/ConvertService.ashx")
   .method("POST", body)
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();

**.docx格式文档文件受密码保护,可以添加password字段定义该文件的密码。**

java 复制代码
{

    "async": false,      //是否异步转换

    "filetype": "docx",  //需要转换的文档格式 docx

    "key": "con_0121",   //转换的可以

    "outputtype": "pdf", //转换成的结果文档格式 pdf

    "password": "abcabc", //需要转换的文档密码

    "title": "Example Document Title.docx", //文档的标题

    "url": " " // 需要转换的文档url地址

}

若****ONLYOFFICE 文档服务开启了安全验证,可以添加token字段进行处理。

java 复制代码
{

    "async": false,      //是否异步转换

    "filetype": "docx",  //需要转换的文档格式 docx

    "key": "con_0121",   //转换的可以

    "outputtype": "pdf", //转换成的结果文档格式 pdf

    "password": "abcabc", //需要转换的文档密码

    "title": "Example Document Title.docx", //文档的标题

    "url": " " // 需要转换的文档url地址,

    "token": " " // 安全验证

}

相关链接

转换 API 文档

ONLYOFFICE 文档 8.0 新功能介绍:文章 / 视频

相关推荐
甄超锋11 分钟前
Java Maven更换国内源
java·开发语言·spring boot·spring·spring cloud·tomcat·maven
m0_7190841128 分钟前
sharding-jdbc读写分离配置
java
还是鼠鼠1 小时前
tlias智能学习辅助系统--Maven 高级-私服介绍与资源上传下载
java·spring boot·后端·spring·maven
Xiaokai丶2 小时前
Java 8 新特性深度剖析:核心要点与代码实战
java
灵魂猎手2 小时前
3. MyBatis Executor:SQL 执行的核心引擎
java·后端·源码
Galaxy在掘金2 小时前
从业8年,谈谈我认知的后端架构之路-1
java·架构
努力努力再努力wz2 小时前
【c++深入系列】:万字详解模版(下)
java·c++·redis
瓦特what?3 小时前
关于C++的#include的超超超详细讲解
java·开发语言·数据结构·c++·算法·信息可视化·数据挖掘
是乐谷4 小时前
阿里云杭州 AI 产品法务岗位信息分享(2025 年 8 月)
java·人工智能·阿里云·面试·职场和发展·机器人·云计算
Java水解4 小时前
Java中的四种引用类型详解:强引用、软引用、弱引用和虚引用
java·后端