使用 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 新功能介绍:文章 / 视频

相关推荐
鼠鼠我捏,要死了捏2 小时前
Java 虚拟线程在高并发微服务中的实战经验分享
java·microservices·virtualthreads
武子康3 小时前
Java-82 深入浅出 MySQL 内部架构:服务层、存储引擎与文件系统全覆盖
java·开发语言·数据库·学习·mysql·spring·微服务
Rancemy3 小时前
rabbitmq 03
java·分布式·rabbitmq
Dcs5 小时前
“SQL注入即服务”:一个10年历史系统的奇幻演变
java
秃了也弱了。5 小时前
reflections:Java非常好用的反射工具包
java·开发语言
Amagi.6 小时前
Java设计模式-代理模式
java·代理模式
Joker—H6 小时前
【Java】Reflection反射(代理模式)
java·开发语言·经验分享·代理模式·idea
阿里巴巴淘系技术团队官网博客6 小时前
面向互联网2C业务的分布式类Manus Java框架
java·开发语言·分布式
躲在云朵里`7 小时前
Java面试题(中等)
java
懂得节能嘛.7 小时前
【SpringAI实战】实现仿DeepSeek页面对话机器人(支持多模态上传)
java·spring