• Stars
    star
    272
  • Rank 150,743 (Top 3 %)
  • Language
    Java
  • License
    MIT License
  • Created over 7 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

office online preview and editor

wopihost

GitHub release GitHub license

English

项目介绍

基于 wopi 协议开发的 WopiHost , 支持 word, excel,ppt, pdf(仅支持预览)等文档的预览和编辑。

运行环境

需要安装 Office online 2016 才可以使用,基于jdk 1.8,spring boot开发。

使用方法

在 application.properties 中配置文档的存储路径

file.path=E:\\

接口访问地址

http://[owas.domain]/hosting/discovery
打开上面的URL, 可以看到结果如下的XML文件,上面有对应的文件类型的请求路径。
请求路径

word文档预览 http://[owas.domain]/wv/wordviewerframe.aspx?WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.docx word view

word文档编辑
http://[owas.domain]/we/wordeditorframe.aspx?WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.docx word edit

excel预览
http://[owas.domain]/x/_layouts/xlviewerinternal.aspx?ui=zh-CN&rs=zh-CN&WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.xlsx

excel编辑
http://[owas.domain]/x/_layouts/xlviewerinternal.aspx?edit=1&WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.xlsx

ppt预览 http://[owas.domain]/p/PowerPointFrame.aspx?PowerPointView=ReadingView&WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.pptx

ppt编辑
http://[owas.domain]/p/PowerPointFrame.aspx?PowerPointView=EditView&WOPISrc=http://[WopiHost.IP]:8080/wopi/files/test.pptx

备注:[owas.domain] 是 Office online 2016 的地址,[WopiHost.IP]是 WopiHost 服务的 IP 地址。 使用时替换成自己相应的服务地址。

常见问题

  • word 文档编辑支持 .docx 格式,不支持 .doc 。
  • pdf 仅支持预览,不支持编辑。
  • 如果 wopihost 的接口没有问题,但是不能预览或者编辑文档
    可能 wopi 和 Office Web Apps Server 之间的网络不能互通,也可能 Office Web Apps Server 配置有问题,建议检查配置或者重装后重试。
  • 不能打开中文名的文件,提示 Unable to Open the File
    将文件名使用 URLEncoder.encode 进行两次编码。例如:测试.xlsx, 编码为 %25E6%25B5%258B%25E8%25AF%2595.xlsx 即可正常预览、编辑。
  • 因为 office 的 BUG, 更新docx文件时 unlockAndRelock 和 putfile 请求中 header 中的锁不一致,因此在处理更新docx请求时,不去校验lock是否一致,否则无法保存docx更改。

License

MIT License