官方给的 JXLS 读取 excel 文件的例子

官方给的 JXLS 读取 excel 文件的例子

本文示例代码下载地址
        jXLS 提供 jxls-reader 模块用来读取 XLS 文件并且用读来的表格数据填充 Java bean。
        使用 jXLS 来解析 cxcel 文件并使用读来的数据填充 Java 对象我们首先要创建一个 XLSReader 对象。要创建这个对象，最简单的方法就是使用一个 XML 配置文件。在本文的示例代码中，我们使用具有部门信息数据的 departmentdata.xls 文件来展示这一方法。
        我们使用 XML 文件在电子表单元格和 Java 对象之间进行映射。映射文件的结构比较简单。以示例代码中 departmentdata.xls 文件的 Sheet1 为例，我们看一下 XML 文件是如何进行映射的：

                    <?xml version="1.0" encoding="ISO-8859-1"?>
                    <workbook>
                        <worksheet name="Sheet1">
                            <section startRow="0" endRow="6">
                                <mapping cell="B1">department.name</mapping>
                                <mapping cell="A4">department.chief.name</mapping>
                                <mapping cell="B4">department.chief.age</mapping>
                                <mapping cell="D4">department.chief.payment</mapping>
                                <mapping row="3" col="4">department.chief.bonus</mapping>
                            </section>
                            <loop startRow="7" endRow="7" items="department.staff" var="employee" varType="net.sf.jxls.reader.sample.Employee">
                                <section startRow="7" endRow="7">
                                    <mapping row="7" col="0">employee.name</mapping>
                                    <mapping row="7" col="1">employee.age</mapping>
                                    <mapping row="7" col="3">employee.payment</mapping>
                                    <mapping row="7" col="4">employee.bonus</mapping>
                                </section>
                                <loopbreakcondition>
                                    <rowcheck offset="0">
                                        <cellcheck offset="0">Employee Payment Totals:</cellcheck>
                                    </rowcheck>
                                </loopbreakcondition>
                            </loop>
                        </worksheet>
                    </workbook>

        可以看到，XML 文件的根元素是 workbook，workbook 可以包含子元素 worksheet。worksheet 标签应该使用 name 属性来指出它所描述的 excel 表格（在我们的例子中是 Sheet1）。
        worksheet 元素可以包含任意数量的 section 和 loop 子元素。
        section 元素代表了一个简单的电子表格单元格块。这个单元格块的首行和最后一行使用 startRow 和 endRow 属性来定义。
        在 jXLS 当前版本中，我们就是通过定义一系列的 section 来解析整个的 excel sheet 文件。这意味着即使我们不打算读取 sheet 的起始行，我们也要定义一个空的 section，这样，这些行才会在我们的 XML 文件中被反映出来。这些没用的行将被忽略掉。
        使用 mapping 标签将 XLS 文件的单元格映射到 Java bean 的属性中：

                        <mapping cell="B1">department.name</mapping>

        另外一个做法是使用单元格的行号和列号（基于 0,即起始 为 0）来定义要映射的单元格：

                   <mapping row="3" col="4">department.chief.bonus</mapping>

        以上定义了 E4 单元格，并把它映射到 department.chief.bonus 属性。
        loop 元素用来定义一些循环（重复）的行，它应该包含 startRow 和 endRow 属性来定义这些重复块的开始行和结束行。类似于 JSTL 标签，items 属性代表了包含这些重复行的容器，var 属性用来指示遍历时的容器的某一项，varType 属性定义了 var 属性所代表的 Java 类全名：

                    <loop startRow="7" endRow="7" items="department.staff" var="employee" varType="net.sf.jxls.reader.sample.Employee">

        loop 元素可以包含任意数量的 section 和 loop 元素。loop 元素必须包含 loopbreakcondition 来定义循环的跳出终止。在我们的示例中以 loop 块的下一行的第一个单元格的 Employee Payment Totals: 作为跳出判断：

                    <loopbreakcondition>
                        <rowcheck offset="0">
                            <cellcheck offset="0">Employee Payment Totals:</cellcheck>
                        </rowcheck>
                    </loopbreakcondition>

        以上就是我们在创建 XML 映射文件时所有要注意的事项。下边是一个简单的提取 XLS 文件数据到 Java bean 的示例代码：

                    InputStream inputXML = new BufferedInputStream(getClass().getResourceAsStream(xmlConfig));
                    XLSReader mainReader = ReaderBuilder.buildFromXML( inputXML );
                    InputStream inputXLS = new BufferedInputStream(getClass().getResourceAsStream(dataXLS));
                    Department department = new Department();
                    Department hrDepartment = new Department();
                    List departments = new ArrayList();
                    Map beans = new HashMap();
                    beans.put("department", department);
                    beans.put("hrDepartment", hrDepartment);
                    beans.put("departments", departments);
                    XLSReadStatus readStatus = mainReader.read( inputXLS, beans);

原文链接：http://jxls.sourceforge.net/reference/reader.html。