spreadJS开发实战：如何通过Vue+SpringBoot实现在线文档数据填报、协同编辑-控件新闻-慧都网

spreadJS开发实战：如何通过Vue+SpringBoot实现在线文档数据填报、协同编辑

翻译|使用教程|编辑：鲍佳佳|2020-10-12 11:57:16.020|阅读 501 次

概述：在线文档，顾名思义就是通过在线的方式对文档进行操作，实现如数据填报、数据计算、可视化、在线导入导出 Excel 文件、自定义系统外观、工具栏、在网页内满足单人或多人编辑并将文件上传至服务端保存的功能。

SpreadJS 是一款基于 HTML5 的纯前端电子表格控件，兼容 450 种以上的 Excel 公式，凭借其 “高性能、跨平台、与 Excel 高度兼容”的产品特性，备受以华为、苏宁易购、天弘基金等为代表的企业用户青睐。SpreadJS 为用户带来亲切的 Excel 使用体验的同时，满足 Web Excel 组件开发、表格文档协同编辑、数据填报、Excel 类报表设计等业务场景，极大降低了企业研发成本和项目交付风险。更多详情信息文章教程点击这里>>

点击下载SpreadJS最新试用版

在线文档，顾名思义就是通过在线的方式对文档进行操作，实现如数据填报、数据计算、可视化、在线导入导出 Excel 文件、自定义系统外观、工具栏、在网页内满足单人或多人编辑并将文件上传至服务端保存的功能。

国内外常见的在线文档，包括：微软Office Online、Google文档、石墨文档、腾讯文档、飞书、语雀等。

通过对比这些软件产品，可以将它们的主要功能点，概括为三个层面：数据填报、协同编辑和类Excel的呈现方式。

数据填报：支持在线导入导出 Excel、大数据量填报、填报暂存、多 sheet 填报、多级上报
协同编辑：支持多人协作、实时编辑、数据同步、多级上报、历史查询
类Excel的呈现方式：提供类Excel的操作模式和使用体验，兼容Excel数据结构

可以说，只要满足了上述需求，就可以开发出一款优秀的在线文档。

而SpreadJS纯前端表格控件，恰好满足。

下面，我们就通过Spring Boot + Vue.js的前后分离开发技术，演示如何借助 SpreadJS 搭建一款简单的在线文档系统。

在线文档系统示例

该系统集成了SpreadJS表格控件，目前已经实现了在线读取、编辑Excel 文档的功能，文末提供了示例代码下载，大家可以按照 Readme文档中的步骤运行。

PS：欢迎大家前往SpreadJS 产品官网，了解并学习这款纯前端表格组件，以实现更多在线文档的功能。

如下是系统运行截图。

进入页面（File List的展示文件均为服务器上的文件）：

单击 Excel文件，右侧会显示该文件的详细信息：

双击文件夹：

点击某个 Excel文件，打开编辑文件的弹框：

在线对Excel文件进行修改、删除：

技术栈

后端：SpringBoot
前端：SpreadJS、Vue、ElementUI、Typescript

关键步骤

1、实现该系统的相关依赖包都写在package.json里，执行命令 npm install 即可安装，主要有：

"@grapecity/spread-sheets": "^13.0.5",
"@grapecity/spread-sheets-resources-zh": "^13.0.5",
"@grapecity/spread-sheets-vue": "^13.0.5",
"@grapecity/spread-sheets-pdf": "^13.0.5",
"@grapecity/spread-sheets-print": "^13.0.5",
"@grapecity/spread-sheets-charts": "^13.0.5",
"@grapecity/spread-sheets-shapes": "^13.0.5",

2、在SpreadJS.vue文件中引入 SpreadJS 相关安装包：

import "@grapecity/spread-sheets-vue";
import * as GC from "@grapecity/spread-sheets";
import  "@grapecity/spread-sheets-charts";
import  "@grapecity/spread-sheets-shapes";

3、在App.vue文件中引入 SpreadJS 的样式文件、中文资源文件：

import '@grapecity/spread-sheets-resources-zh'
import '@grapecity/spread-sheets/styles/gc.spread.sheets.excel2016colorful.css'

4、 List.vue文件中是主要的页面逻辑，双击文件时弹出弹框，弹框中引入了自定义的组件：

 <MySpreadJS :mySpread=
"mySpread" :filePath="filePath" @done="childDone" :closeSpread='closeSpread'>
</MySpreadJS>

5、 mySpread变量中是从后台返回的文件流，传给MySpreadJS组件，子组件接收到数据后，调用excelIO.open方法打开Excel 文件流，

spreadInitHandle: function(spread) {
    this.spread = spread;
    let self = this;
    let excelIO = new ExcelIO.IO();
    excelIO.open(
    this.spreadblob as Blob,
    function(json) {
        let workbookObj = json;
        self.spread.fromJSON(workbookObj);
    },
    function(e) {
        alert(e.errorMessage);
    });
},

6、在线编辑Excel文件，并保存。借助excelIO.save方法可以将修改后的文件流传给后台，实现文件的修改功能：

excelIO.save(
    curjson,
    function(fileblob) {
        let formData = new FormData();
        formData.append("filePath", self.filePath);
        formData.append("type", "update");
        formData.append("excelFile", fileblob);
        httpUtils.post("/filemanager/savefile", formData).then(response => {
        self.$message({
            type: "success",
            message: "保存成功!"
        });
        self.$emit("done");
        });},
    function(e) {
        //process error
        console.log(e);
    }
);

后台接口介绍

获取某路径下的文件集合：getfolder