一、开源项目简介

CastleDocpreview 多文件在线预览

文件在线预览模块（多格式转 PDF 文件）

文件格式转换将多格式转换为pdf格式，转换为图片格式在进行预览展示。支持word 转 pdf、word 转图片等。

二、开源协议

使用MIT开源协议

三、界面展示

四、功能概述

已经实现功能如下：

• 多格式转换为 PDF 格式

• OFFICE 转换为 PNG 格式

• 在线预览文件

• 手机预览查看文件

现已支持格式如下

• 图片预览：.gif、bmp、jpeg、jpg、png、ico、svg

• 文档预览：.doc、docx、xls、xlsx、ppt、pptx

• PDF 文件：pdf、PDF 文件压缩

• 文本文件：txt

• 音频文件：mp3、ogg、wav

• 视频文件：mp4、webm、mkv

说明：本项目是将一些常见的技术做了整合，帮助那些需要在线预览文件或正在寻找 office 转 pdf 文件预览的同学。

五、技术选型

运行方式

【必须】程序运行所在环境安装 LibreOffice，PDF 转换基于 LibreOffice 完成(OpenOffice 也一样可用)

1. 直接复制源码里的文件搬家至你自己的代码中

2. 将此 Demo 打包成为一个 jar 引入到自己的项目中

本地启动后访问页面地址为：http://localhost:8301/index（还需修改参数配置或搭配Nginx使用）

主要技术

现在市面上主要的做文档转换的几个技术

名称	用途
Libreoffice	office转pdf
PDFBox	pdf转图片
PDF2SVG	pdf转svg
Calibre	epub、mobi等电子书转为pdf
MuPDF	PDF和XPS解析和渲染引擎，可用于将PDF转为svg、png等图片
SVGO	压缩svg图片大小
GZIP压缩	对svg文件压缩

什么是同步转换和异步转换

同步转换

即用户上传文档提交接口瞬间，系统会立即进行转换。

优点：用户一直在loading等待，转换完成可见数据。

缺点：同步转换容易造成页面卡顿，转换时间超长的情况下，系统接口会超时。

异步转换

即用户上传文档提交接口瞬间，系统不会立即进行转换，而是将文档放入转换队列，由后台的转换进程进行转换。

优点：大量文件可同时进行转换，不会造成卡顿。

缺点：无法实时的查看数据。

来源：CastleDocpreview 官方文档