zhangzhen1979 / JIMU-ConvertPreview

格式转换:用于将常见的文件、图片转换为Pdf、Ofd、Jpg文件。支持对文件加图片水印、文字水印。预览:可以对以上格式在线预览,支持预览水印等。
Apache License 2.0
41 stars 24 forks source link

Convert-Preview 文件格式转换及预览服务

本服务支持:

将常见的文档类文件转换为Pdf、Ofd文件,也可转换为Jpg格式图片;支持对文档类文件的在线预览。

将常见的视频文件转换为MP4、音频文件转换为MP3;支持对音视频文件转换后进行在线播放;支持对视频文件加入水印、截取指定时间的画面等功能。

支持通过path、url方式获取源文件;

支持对文件加图片水印、文字水印;

支持path、ftp、url方式回写文件。


特性

依赖

快速启动

  1. 获取jar包:联系档案项目组或使用mvn clean package -Dmaven.test.skip=true编译。

  2. 获取license文件:联系档案项目组获取, 试用则不需要,可免费试用7天。

  3. 修改配置application.yml

    1. 接收的输入文件存储的临时文件夹:convert.path.inPutTempPath:

    Windows: D:/work/input/

    Linux: /work/input/

    1. 默认的本地输出文件路径: convert.path.outPutPath:

    Windows: D:/work/output/

    Linux: /work/output/

    1. 如需支持失败重试功能,需配置 RabbitMQ 相关参数
  4. 确认文件目录结构

│  application.yml               配置文件
│  convertpreview-{版本号}.jar    运行jar
│  {项目名}.license               license文件,文件名不重要
│  utils                         工具程序文件夹
│  watermark                     水印、归档章文件夹
  1. 以管理员身份运行

    Windows: javaw -jar convertpreview-{版本号}.jar

    Linux: nohup java -jar convertpreview-{版本号}.jar &

  2. 浏览器访问 http://{ip}:{端口} , 返回 启动成功 标识项目启动正常

常见问题

  1. 项目日志在哪里?

    运行目录下log文件夹内

  2. 项目启动失败,日志中有The Tomcat connector configured to listen on port 8080 failed to start. The port may already be in use or the connector may be misconfigured.的报错

    端口被占用,修改application.ymlserver.port, 改为其他端口


详细说明

配置说明

配置说明


转换接口使用说明

本服务提供REST接口供外部系统调用,提供了直接转换接口和通过MQ异步转换的接口。

文件格式转换接口说明

文件格式转换接口说明

生成文件后返回Base64字符串

生成文件后返回Base64字符串

生成文件后返回文件流

生成文件后返回文件流


预览接口使用说明

预览接口(页面)说明

预览接口(页面)说明

PDF脱敏(涂抹)说明

PDF脱敏(涂抹)说明