kkFileViewOfficeEdit 支持哪些文件格式?Office/PDF/图片/压缩包/文本全场景预览清单
文件在线预览与在线编辑是办公系统、OA、网盘类产品的刚需,而选择 kkFileViewOfficeEdit 之前,大家最关心的往往是:它到底支持哪些文件格式? 本文基于项目源码,为你整理一份完整的 kkFileViewOfficeEdit 文件格式支持清单,覆盖 Office 文档、PDF、图片、压缩包、纯文本与多媒体六大场景,帮你快速判断它能否满足你的业务需求。
一图看懂:kkFileViewOfficeEdit 支持的文件格式总览
kkFileViewOfficeEdit 是一个基于 Spring Boot 的文件在线预览及 OFFICE(Word/Excel/PPT)在线编辑工具。它不依赖人工配置,而是根据文件后缀名自动分类,把文件路由到对应的预览处理器,整个判定逻辑都集中在 FileUtils.java 的 typeFromUrl() 方法中,类型枚举定义在 FileType.java,共划分出 7 大类型:
| 文件类型 | 常见格式 | 处理方式 |
|---|---|---|
| 🗂️ Office 文档 | doc、docx、xls、xlsx、ppt、pptx | 转换 PDF 后预览,支持在线编辑 |
| 借助 PDF.js 直接预览 | ||
| 🖼️ 图片 | jpg、jpeg、png、gif、bmp、ico、RAW | 网页直接展示,支持缩放、旋转、翻转 |
| 📦 压缩包 | zip、rar、jar、tar、gzip、7z | 解压为目录树,在线逐层浏览 |
| 📝 纯文本 | txt、md、java、js、css、sql、html、xml、properties 等 | 文本页直接展示 |
| 🎬 多媒体 | mp3、mp4、flv、rmvb | HTML5 播放器在线播放 |
| ❓ 其他 | 未识别的后缀 | 友好提示,可引导下载 |
Office 文档格式:Word/Excel/PPT 全支持
作为项目的核心亮点,kkFileViewOfficeEdit 对微软 Office 三大件做到了全覆盖:
- Word 文字文档:doc、docx
- Excel 电子表格:xls、xlsx
- PowerPoint 演示文稿:ppt、pptx
预览时,服务端通过内置的 OpenOffice 把 Office 文件转换为 PDF 再渲染到浏览器,兼容性极佳;更强大的是,这三类文档还支持在线编辑,编辑保存后通过回调地址把新文件回传,非常适合 OA 审批、合同流转等场景。相关实现可参考 OfficeFilePreviewImpl.java 与 OfficeToPdf.java。
PDF 格式:免转换直接预览
PDF 是办公场景中最常见的"最终交付"格式,kkFileViewOfficeEdit 对 PDF 做了特殊处理——无需任何转换,直接交给内置的 PDF.js 渲染,打开速度快、清晰度高,支持翻页、缩放、打印等操作。此外,项目还能把 OpenOffice 支持的其他格式统一导出为 PDF,这一系列的格式注册与导出属性配置,都可以在 ControlDocumentFormatRegistry.java 中看到。
图片格式:jpg/png/gif 等即时预览
支持 jpg、jpeg、png、gif、bmp、ico 等常见图片格式的在线预览,浏览器直接展示,无需下载。项目还贴心地内置了缩放、旋转、镜像翻转等交互能力,浏览产品图、设计稿、截图都非常顺手。图片类文件的清单定义在 FileUtils.java 的 listPictureTypes() 方法中。
压缩包格式:zip/rar 等目录树在线浏览
这一能力非常实用:zip、rar、jar、tar、gzip、7z 等压缩包会被自动解压并生成层级目录树,你可以像在资源管理器里一样逐层浏览包内文件;如果压缩包里包含图片,还会自动提取为图片预览列表。解压与目录树构建逻辑可参考 ZipReader.java,预览入口在 CompressFilePreviewImpl.java。
文本格式:代码文件也能直接看
对于 txt、md、java、php、py、js、css、sql、html、xml、properties 等所有纯文本文件,kkFileViewOfficeEdit 会直接以文本页展示,无需任何转换。文本类型支持列表可在 application-dev.properties 中通过 simText 配置项自由扩展,默认已包含常用代码与配置文件后缀,日常阅读日志、代码、配置非常方便。
多媒体格式:音视频在线播放
除了文档类,项目还内置了 mp3、mp4、flv、rmvb 等多媒体格式的在线播放支持,同样在 application-dev.properties 中通过 media 配置项维护,方便在网盘、教学、素材管理等场景中直接预览音视频内容。
如何使用:预览与编辑只需一个 URL
确认格式支持后,接入方式也极其简单——启动服务(默认端口 8012)后,只需拼一个 URL 即可:
- 在线预览:
http://IP:端口/onlinePreview?url=你的文件地址 - 在线编辑:
http://IP:端口/onlineEdit?url=你的文件地址&callBack=回调地址
其中 URL 参数需要进行 encode 编码,编辑保存成功后会回调你指定的地址并传回新文件的下载路径,具体接口定义可查看 OnlinePreviewController.java 和 OnlineEditController.java。
总结:一套服务覆盖办公全场景
总的来说,kkFileViewOfficeEdit 的文件格式支持面非常广:Office 三件套既能预览又能在线编辑,PDF 免转换直出,图片、压缩包、文本、音视频各有专属处理方案,且类型清单均可通过配置文件按需扩展。无论你是想搭建内部文档预览服务,还是为业务系统补充在线编辑能力,这份格式清单都能帮你快速评估它是否合适。如果你还需要判断某个冷门后缀,直接看 FileUtils.java 中的分类方法即可一目了然。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



