夜雨聆风揭开文档在线编辑和预览的神秘面纱
文档的在线编辑和预览一直认为不是什么难事，但是真正实现起来却发现没那么容易，我把这件事想简单了。原本可行性的技术方案随着技术的发展都不能再使用了，或者已经过时了，导致了原本已经实现的功能，现在都无法用了，不得不去寻找新的方案，然而新的方案不是不好使就是收费。可能收费是个大趋势，这个免费的时代真的要结束了。曾经想过要把从事软件开发以来，一些技术经验、走过的弯路、踩过的坑、做过的技术积累都分享出来，给初学者、需要的人一些帮助，自己也做一些总结，温故而知新。大部分情况下我只提供一个思路，或者说是一个方向，具体如何实现还需要自己去问AI或者百度，也可以加我微信交流。
先说一下这些年遇到过的对文档的需求，所谓文档无非就是word、excel、pdf这三大类，很多年前在项目中就遇到过合同模板的需求，用表单数据填充合同模板，再后来遇到过在线预览word、excel文档，以及后来遇到在线编辑的需求。其实在线编辑的需求很多年前遇到过，只是没找到合适的解决方案。最早见过能在线编辑的系统，是在浏览器上安装word的activeX插件，现在大部分浏览器已经不允许安装这种插件了，就没有什么好的方案了。一般遇到这些需求就是首先想到肯定有技术方案，因为我们遇到的其他人可能早就实现了，拿来就用就行了，有免费的最好了（客户不太愿意多出这种费用），没免费的就用收费的，只要价格能接受就行。大部分公司没技术能力解决这些问题。我们只能寻找现成的方案，软件这个领域更需要站在巨人的肩膀上。
表单填充word模板
那么问题就来了，我们自己实现不了，就要寻找最合适的方案。前面说的这几个需求居然没有一个好实现的，表单数据填充文档模板，查百度或者问AI基本的答案都是word里做标签或者域，然后用文本查找替换。说起来容易做起来难，要实现这些功能就不只是简单的查找替换的问题，主要是要考虑复杂的情况，例如表格、图片，这就不是那么容易，再查找标签时经常失败，命名做了标签却找不到，这是非常普遍的问题。几经折腾，最后找到了一个比较好用的前端实现的方案，一个开源的vue组件docxtemplater，效果还可以，比较理想，基本的标签替换、表格、图片都没问题，很好使。具体做法是把vue的这个组件页面部署到项目里，其他页面通过参数方式传递数据调用这个页面，实现把数据填充到word模板里，然后再提供一个下载功能，这样基本能满足需求，这个方案是免费的。
其实最理想的应该是在后端实现，但是后端目前没有免费的方案。最近在研究一个后端方案，使用Aspose第三方的类库，测试阶段效果还可以，用法跟前端vue组件差不多，只是这个第三方类库不是免费的，价格还不便宜。等测试没问题后，在新需求的时候用后端来处理，以前前端处理的项目就不改了，改起来工作量比较大，不划算。
下面用几张效果图，来看一下实现效果，第一张是报价单word模板文件，包括基本标签和表格，第二张是生成后的在线预览（vue组件自带的功能，有些格式有点变形，在线预览效果不太理想），第三张图是下载后在本地word打开的效果（这个是比较好，不变形，用户可以修改打印）。
文档在线预览
再说这个文档在线预览功能，这个方案比较多，微软和360好像提供了一个免费的在线预览的网址，把word文档用他们的提供的网址就可以在浏览器打开。缺点是文档要经过他们的服务器，可能存在泄密的问题，现在也不管有没有秘密，反正把公司的业务信息传给第三方客户一般不太接受。这个方案不太合适，后来我们想了一个方案就把word文档转成pdf文件，然后预览的时候调用同名的pdf文件，pdf文件浏览器默认是可以在线打开的，算是临时解决了这个问题，但是不是很理想，每次要在后台转成pdf文件，会产生很多垃圾文件。在word转pdf的时候也遇到了困难，很难找到一个合适的方法。最开始我们找的方法是使用office的类库，然后调用类库来转换，但是这需要电脑要安装office系统，转换的时候还经常报错，可能是有并发问题，但基本上能说的过去。后来找到了一个比较完美的方案，还是要使用第三方的类库，例如Aspose（前面提过这个类库），这是目前来说公认的最好使的类库，它可以把word和excel转成pdf也可以转成html，特别是转成html几乎不变形，这是最合理的，html直接可以预览。docxtemplater也有在线预览的功能，但是转成html后几乎都要变形，有表格或者特殊格式的文档基本上没法看，失真很大，前面提过这个问题。目前我们的项目也从原来的方式转成了使用Aspose，这部分费用要想办法转嫁给客户，目前还没想到好办法。在线预览能做到什么程度，下面提供几张图片，看一下效果。
下图是一个word文档生成的在线预览的Html页面，几乎没有失真。
下图是一个多页的excel文档生成的在线预览的html页面，几乎没有失真。表内超链接也有效，这是比较强大的，我觉得这一点比较完美。
文档在线编辑
文档的在线编辑应该是最难实现的，目前推荐方案大部分是使用第三方的服务器，例如金山文档、腾讯文档，office 365等，不关注不知道，原来金山文档就是靠这个发家的，靠一个文档处理撑起了半边江山。他们应该是从底层研究openxml的。使用他们的服务器的方案，技术上来讲就是把文档传给他们的服务器，使用他们提供的网址打开文档，进行编辑。技术成本就是根据他们的api进行对接，他们是按年或者按次收费，总体下来成本并不低，就一个文档处理来说，没有特别强烈的需求（也就是客户愿意出费用），这个方案性价比不高。
性价比比较高的方案是搭建自己的office服务器，我们来扮演金山文档或者是腾讯文档的角色。在线编辑，多人同时编辑等功能一个也不少，世界上缺啥，就有人创造啥，onlyoffice就是为此而生的。
提到onlyoffice已经是大名鼎鼎了，只是没有关注，研究才发现，人家的技术已经相当成熟了。而且是开源免费（社区版），虽然厂家建议购买，但是不买也能用，这一点就很开明。首先你要好用，其次你要能让我用，不要把有真正需求的人拒之门外，真到了离不开的时候会掏钱的，价格也很公道。不像现在国内有些东西（具体我就不提那些东西了，反正是在信创领域），不得不用，还不免费，还不好用，还不便宜，怎么能推广呢。在软件这个圈内很多好东西都是从开源开始的，越做越好。开源是唯一的出路，大家共享成果，共用成果，才能共存。不要拿着政策福利，固步自封，早晚会被取代，没有开源的鞭策也走不远，我的打心眼里希望我们能做出好东西来。
不得不说，onlyoffice是个好东西。
用onlyoffice搭建自己的文档服务器，再也不用羡慕金山文档、腾讯文档了。
下面分享一下搭建onlyoffice服务器的过程，在搭建的过程中，由于我个人思想观念的不同，也走了很多弯路，几经折腾，也差点放弃（被各种非技术因素折腾的够呛）。
我的传统观念是Windows的一键安装，现在大部分软件安装是linux的观念，命令式在线安装，这个差别太大了，到现在还不太适应。我总是担心一旦不在线了，就无法安装了。但是现在都是这个模式了，无论是后台还是前台，似乎都要这样了，各种依赖式安装。以前有千年虫问题，现在这个依赖问题比千年虫问题还要严重，以后如果真没有网络了，所有系统估计都要瘫痪。现在宣扬软件功能设计的时候要解耦，在系统安装的时候又走向了高度耦合，不知道是进步还是退步？如果从另一个角度来说，依赖现有成熟资源，避免重复造轮子，这一点又是先进的，不要担心没有了网络，未来就是没有了网络什么都不能干了，所以未来的技术发展都是要建立在网络畅通的基础上，这个思维我要转变。
Onlyoffice服务器安装，AI推荐首选使用docker方式，这的确是最简单的方案，docker会把所有的依赖都给你打包好，不用担心依赖组件版本不一致的问题，也可以说是一键安装。
然而事实上，docker安装也并不是一帆风顺，最大的问题是找不到合适的docker镜像，很多好东西镜像都在国外，国内访问不了，或者速度很慢。从这一点上来说，非常阻碍发展。我们能不能做出自己的好东西，先不说这个，就获取资源的这个途径来说，就有很大的问题。只能自己去想办法，大部分工作是浪费在这些事情上，意志不坚定的估计就放弃了。还好有千问帮忙，总算找到了有效的镜像。
作为测试环境，在本地电脑使用的是docker安装。在生产环境我是用的传统的Windows方式安装，我要熟悉一下每个组件的依赖过程。
搭建成功onlyoffice服务器，在线编辑就成功了一半了，剩下的工作就是集成到项目中了。可以根据自己的设想自由发挥了。为了多个项目使用在线编辑，搭建一个独立的文档服务器，为其他项目提供接口，这样将来如果购买onlyoffice的话，多个项目的客户可以共同来分担这部分费用。
国内能做文档在线编辑的估计没几家，金山、腾讯、阿里都有能力研究openxml，他们可以做原生的开发，其他估计都没有这个能力，大部分都应该是使用的onlyoffice。
再说回到为啥要使用在线编辑？本地编辑不是更好，更方便吗？我分析了一下客户的需求，客户想解决的问题并不是文档编辑方式的问题，而是要确保文档版本一致的问题，只有放在一个地方，才能保证文档是一个版本，版本一致，本地不留，这是最重要的一点。
最后，还是上几张在线编辑的效果图，如下图：
总结，要填充word模板，转成pdf或者html最好用的是Aspose，要实现在线编辑最好用的是onlyoffice，别无其他。大家一起努力吧，为在这个环境里生存，有好东西大家一起分享。
