文件转PDF组件★

概述

HOS基础平台为用户提供了广泛而全面的文档转PDF支持，涵盖了日常工作中最为常见的文件格式，包括但不限于Word、Wps、Excel、PowerPoint（PPT）等文件。

导入依赖

文件转PDF支持纯文本文件、图片文件、PDF 文件、office 文件及媒体文件的预览,根据项目需要选择对应的依赖包自行引入。
需要引入 hos-framework-preview-office-starter 依赖

    <dependency>
        <groupId>com.mediway.hos</groupId>
        <artifactId>hos-framework-preview-office-starter</artifactId>
    </dependency>

office 文件转PDF需要借助第三方服务 openoffice/libreoffice。 如果是服务端，则需要在服务器安装 openoffice/libreoffice；可参考Linux 下安装 LibreOffice (opens new window)
如果本地开发需要自行安装，可以参考Windows 下安装 LibreOffice (opens new window)

## 配置及使用

```yaml
hos:
  ##### 基础配置
  server-url: #默认使用http://localhost:8080
  preview:
    ##### 使用office需配置
    office:
      home: #openoffice或LibreOffice  home路径(示例：D:/devtools/LibreOfficePortable/App/libreoffice)
  libreOffice:
    isOpen: true # 是否开启文件转换pdf功能，默认false

请求方式

url：http://{应用系统前端ip和端口}/api/openApi/file/manage/convert-to-pdf
method：POST  
Content-Type: multipart/form-data;charset=UTF-8

body入参

参数	类型	是否可选	描述
file	文件	必选	需要上传的文件
fileName	String	可选	文件名称
outputFilePath	String	可选	生成PDF文件路径

响应结果

{
	"code": "200",
	"msg": "操作成功",
	"data": {
		"id": "f53d5c3951f9abc9990499fac2ca5d26",
		"fileName": "打印培训教案.pdf",
		"md5": "d41d8cd98f00b204e9800998ecf8427e",
		"fileUrl": "/openApi/file/manage/downloadById/f53d5c3951f9abc9990499fac2ca5d26",
		"fileSize": "444.8KB",
		"path": "/openApi/file/manage/downloadById/f53d5c3951f9abc9990499fac2ca5d26"
	},
	"success": true
}