ZK框架学习（二）——ZK Spreadsheet

最新推荐文章于 2020-02-18 23:43:15 发布

原创最新推荐文章于 2020-02-18 23:43:15 发布 · 3.5k 阅读

2 ·

CC 4.0 BY-SA版权

java 专栏收录该内容

16 篇文章

订阅专栏

ZK SpreadSheet（ZSS）是一款专为Java Web应用程序设计的Ajax组件，用于处理Excel文件。本文将介绍其基本概念，通过体验Demo工程了解使用方式，并剖析代码结构，特别是pom.xml中添加的依赖以及Excel加载过程。同时，文章揭示了ZK Spreadsheet的运行原理，包括客户端UI、服务端组件和公式计算引擎的数据模型。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

ZK SpreadSheet简介

ZK SpreadSheet,简称ZSS。它是唯一可嵌入的Java Web应用程序的Ajax组件。它是ZK框架的一个组件，专门用于处理excel文件，加载、生成、编辑、下载等。
https://www.zkoss.org/product/zkspreadsheet

代码剖析

体验

下载Demo工程https://github.com/zzyymaggie/ZK_HelloWorld，按照readme运行和查看结果。

代码结构

解释一下该项目的代码结构。这里可以参考 ZK框架学习（一）的代码剖析。zss只是zk的一个组件，运行框架是一样的。这里只解释差异的部分。
1. pom.xml 增加zss的依赖

        <dependency>
            <groupId>org.zkoss.zss</groupId>
            <artifactId>zss</artifactId>
            <version>${zss.version}</version>
        </dependency>
        <!-- [Optional] Using ZK Spreadsheet EE -->
        <dependency>
            <groupId>org.zkoss.zss</groupId>
            <artifactId>zssex</artifactId>
            <version>${zss.version}</version>
        </dependency>

2.excel加载
2.1 编写zul

<?page title="My First ZK Spreadsheet application" contentType="text/html;charset=UTF-8"?>
<zk>
    <window title="My First ZK Spreadsheet Application" 
    apply="org.sophia.spreadsheet.MyComposer"
        border="normal" height="100%" width="100%">
        <spreadsheet id="ss" height="100%" width="100%"
        maxVisibleRows="150" maxVisibleColumns="40" showContextMenu="false"
         showToolbar="false" showSheetbar="true" showFormulabar="false"/>
    </window>
</zk>
excel文件可以由Compsoer加载，也可以直接在spreadsheet标签中，配置src属性加载。

2.2 编写Composer

public void doAfterCompose(Component comp) throws Exception {
        super.doAfterCompose(comp);  //wire variables and event listeners
        //access components after calling super.doAfterCompose()
        //import and load the template excel file "/WEB-INF/books/startzss.xlsx"
        Importer importer = Importers.getImporter();
        Book book = importer.imports(getFile(), "sample");
        ss.setBook(book);
    }


    private File getFile() {
        //get a file 
        return new File(WebApps.getCurrent().getRealPath("/WEB-INF/books/startzss.xlsx"));
    }