官方JXLS 读取 excel 文件例子

ゞ浴缸里的玫瑰 2022-04-12 07:10 544阅读 0赞

[http://blog.csdn.net/defonds/article/details/6733579][http_blog.csdn.net_defonds_article_details_6733579]

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

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

1.  **<?****xml**version="1.0"encoding="ISO-8859-1"**?>**
2.  **<****workbook****>**
3.  **<****worksheet**name="Sheet1"**>**
4.  **<****section**startRow="0"endRow="6"**>**
5.  **<****mapping**cell="B1"**>**department.name**</****mapping****>**
6.  **<****mapping**cell="A4"**>**department.chief.name**</****mapping****>**
7.  **<****mapping**cell="B4"**>**department.chief.age**</****mapping****>**
8.  **<****mapping**cell="D4"**>**department.chief.payment**</****mapping****>**
9.  **<****mapping**row="3"col="4"**>**department.chief.bonus**</****mapping****>**
10. **</****section****>**
11. **<****loop**startRow="7"endRow="7"items="department.staff"var="employee"varType="net.sf.jxls.reader.sample.Employee"**>**
12. **<****section**startRow="7"endRow="7"**>**
13. **<****mapping**row="7"col="0"**>**employee.name**</****mapping****>**
14. **<****mapping**row="7"col="1"**>**employee.age**</****mapping****>**
15. **<****mapping**row="7"col="3"**>**employee.payment**</****mapping****>**
16. **<****mapping**row="7"col="4"**>**employee.bonus**</****mapping****>**
17. **</****section****>**
18. **<****loopbreakcondition****>**
19. **<****rowcheck**offset="0"**>**
20. **<****cellcheck**offset="0"**>**Employee Payment Totals:**</****cellcheck****>**
21. **</****rowcheck****>**
22. **</****loopbreakcondition****>**
23. **</****loop****>**
24. **</****worksheet****>**
25. **</****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 的属性中：

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

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

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

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

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

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

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

1.  **<****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: 作为跳出判断：

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

1.  **<****loopbreakcondition****>**
2.  **<****rowcheck**offset="0"**>**
3.  **<****cellcheck**offset="0"**>**Employee Payment Totals:**</****cellcheck****>**
4.  **</****rowcheck****>**
5.  **</****loopbreakcondition****>**

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

[view plain][http_blog.csdn.net_defonds_article_details_6733579] [print][http_blog.csdn.net_defonds_article_details_6733579] [?][http_blog.csdn.net_defonds_article_details_6733579]

1.  InputStream inputXML = **new** BufferedInputStream(getClass().getResourceAsStream(xmlConfig)); 
2.  XLSReader mainReader = ReaderBuilder.buildFromXML( inputXML ); 
3.  InputStream inputXLS = **new** BufferedInputStream(getClass().getResourceAsStream(dataXLS)); 
4.  Department department = **new** Department(); 
5.  Department hrDepartment = **new** Department(); 
6.  List departments = **new** ArrayList(); 
7.  Map beans = **new** HashMap(); 
8.  beans.put("department", department); 
9.  beans.put("hrDepartment", hrDepartment); 
10. beans.put("departments", departments); 
11. XLSReadStatus readStatus = mainReader.read( inputXLS, beans);

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

[http_blog.csdn.net_defonds_article_details_6733579]: http://blog.csdn.net/defonds/article/details/6733579
[http_jxls.sourceforge.net_reference_reader.html]: http://jxls.sourceforge.net/reference/reader.html