JXLS教程

一．JXLS简介

在很多涉及到某种报表功能的Java程序中都需要生成Excel表格。目前通过Java来操作.xls文件最完整的类库是Apache POI类库，但是当需要创建多种自定义的复杂Excel报表的时候就会出现问题，这些Excel报表一般都带有多种格式和可扩展功能，在这种情况下，你就不得不写一大堆Java代码来创建报表的规则集（workbook），规则集一般包含所有要求的格式,公式,其他特定的设置和正确的Java对象集的数据出口。这些代码一般都是难以调试，任务也常常变得容易出错并且耗时。

另外一个问题是有很多Excel组件都没有提供的API。幸运的是POI API读取Excel文件，可以保持它原有的格式，然后根据需要进行修改。很明显，用一些Excel编辑工具来创建所有格式正确的报告模板然后指定真实的数据应该放置的地方，会容易很多。JXLS是实现这种方法并且只用几行代码就能创建极其复杂的Excel报表。你只需要用特定的标记来创建一个带有所有要求的格式,公式,宏等规则的.xls模板文件来指定数据放置的位置然后再写几行代码来调用JXLS引擎来传递.xls模板和导出的数据作为参数。

除了生成Excel报表功能，JXLS还提供了jxls-reader模块，jxls-reader模块会很有用，如果你需要解析一个预定义格式的Excel文件并在其中插入数据的话。jxls-reader允许你用一个简单的XML文件描述解析规则，读取Excel文件和你的各种JAVA对象（population of yourJava objects）的所有其他工作都会自动完成。

二．JXLS安装

为了使用JXLS引擎，你必须把jxls-core.jar添加到项目的classpath，如果计划使用JXLS来读取.xls文件，那么你必须还要把jxls-reader.jar加入到项目的classpath中。

如果你用Maven来构建你的应用程序，你可以在你的pom.xml文件中配置指定要求的JXLS模块的依赖，让它们可以从Maven仓库下载。

下面的Apache类库也要求添加到项目的classpath中

●POI 3.6 or higher

●Commons BeanUtils

●Commons Collections

●Commons JEXL

●Commons Logging

●Commons Digester

注意：当前JXLS版本可能无法正常地与较早的POI库版本工作，因此，如果你必须要使用较早版本的POI(prior3.2)使用较老版本的JXLS就行了

三．JXLS参考

1.简介

这部分描述在.xls模板文件的中的对象属性访问语法，如果想让JXLS引擎进行正确的处理.xls模板文件就必须使用规定的语法。

接下来的部分假设我们有两个相互依赖的JAVA beans，类型分别为Department和Employee，在代码中像这样被传递到XLSTransformer中：

Departmentdepartment;

...//initialization

Map beans =new HashMap();

beans.put("department",department);

XLSTransformertransformer = new XLSTransformer(); 
transformer.transformXLS(xlsTemplateFileName,beans, outputFileName);

属性访问

2.1．基本属性访问

使用下面的语句来访问Excel单元格中简单的bean属性：

${department.name}

在上面这个语句中，JXLS引擎会通过关键字department在当前bean映射下搜索这个bean,然后会尝试获取这个bean的name属性的值并把它放到相应的Excel单元格中。

同理，我们可以访问更加复杂的属性，例如，要输出这个department中的属性chief中的name属性的值，我们可以用：

${department.chief.name}

访问任何深度的对象属性都是可以的。例如

${bean.bean1.bean2.bean3.bean4.bean5.bean6.bean7.bean8.bean9.beanX.property1}

2.2多个属性在一个单元格中

在一个单元格，我们可以连接几个属性。例如：

Employee:${employee.name} - ${employee.age} years

这样，我们得到的输出是：

Employee: John -35 years

其中${employee.name}的值是John,同理${employee.age}的值是35.

3.使用标签

JXLS允许在模板中使用预定义的XML标签来控制XLS转换行为。

3.1 jx:forEach标签

标签的典型用法如下：



       ${department.name}| ${department.chief}

jx标签可以相互嵌套使用

如果你把jx:forEach标签的开始标签和结束标签放在同一行的话，JXLS会在同一行上重复在jx:forEach标签的开始标签和结束标签之间的Excel单元格。

目前，如果你想要用jx:forEach标签重复Excel的行，那么你必须把jx:forEach标签的开始标签和结束标签放在不同的行，把要重复的行包含在中间，jx:forEach标签所在行的所有单元格都会被忽略。

以下是一个实例的截图：

图1模板

图.2生成的Excel报表

3.1.2 forEach标签的数据分组

jx:forEach标签可以通过一个底层bean的属性对数据集合的分组，这可以通过jx:forEach标签的groupBy and groupOrder属性完成，groupBy用于指定一个属性进行分组，groupOrder用于指定各个分组排列顺序。例如：


     Age: ${group.item.age}
       
             ${employee.name} |${employee.payment} |${employee.bonus}

在这个例子中，我们把employees按age属性分组，当遇到groupBy属性的时候，JXLS内部执行分组并且放置名为group的新的bean到上下文中，这个新的bean是很简单-它包含两个属性：item属性和items属性，item属性是分组中当前处理的bean；items属性

代表这个分组中所有bean的集合。

正如你看到的，在这个例子中我们首先使用下列语句显示一些关于当前分组age属性的信息

Age:${group.item.age}

之后，我们使用内部标签来实现迭代并显示所有分组中的记录


    ${employee.name}| ${employee.payment} | ${employee.bonus}

默认情况下，如果没有groupOrder属性组的顺序将被按“原先”的顺序保留，以便这些分组的排列顺序跟原先的集合中一样，如果你需要按升序或是降序排列排列这些分组，那么你可以将groupOrder属性相应地设置为ASC或DESC

在使用groupBy属性的情况下，jx:forEach标签的var属性将被忽略

3.1.3forEach标签的筛选功能

你可以用jx:forEach标签的‘select’属性来选择把哪些记录包含在循环中，例如，如果我们想只包含工资高于 2000元的员工，我们可以使用下面的语句：


    ${employee.name}| ${employee.payment} | ${employee.bonus}

3.14 forEach标签的varStatus 属性

jx:forEach标签支持varStatus属性，varStatus属性用来定义一个循环状态的名字，在每一次迭代中，循环状态对象会被传递到bean上下文。循环状态对象是LoopStatus类的一个实例，LoopStatus类有一个单一（静态）的'index'属性用来确定当前记录在集合中的索引值（索引值从0开始）。


      ${status.index}|${employee.name}|${employee.payment}|${employee.bonus}

3.2 jx:if标签

典型的标签的用法如下：


    Chief Name: ${department.chief.name}

jx:if标签可以基于某些条件来排除某些行或是某些列，如果你把jx:if标签的开始标签和结束标签放在同一行的话，JXLS会根据test的条件来处理或删除包含在标签提内的列；如果你把jx:if标签的开始标签和结束标签放在不同行的话，JXLS会根据test的条件来处理或删除包含在标签提内的行。

3.3 jx:outline标签

标签可以将特定的行组成一组。例如：

图3模板 ![Uploading 4_255623.png . . .]

图.4 产生的Excel文件（折叠）

图.5 产生的Excel文件（展开）

标记有一个可选的布尔类型的属性“detail”声明结果初始化的状态-它们应该展开显示还是折叠显示，默认值是false即分组的行会被折叠显示（隐藏）

3.4 jx:out标签

标签的用法如下：

Connection conn =...// get database connection in some way Map beans = newHashMap(); ReportManager rm =new ReportManagerImpl( conn, beans ); beans.put("rm",rm); InputStream is =new BufferedInputStream(new FileInputStream("reportTemplate.xls")); XLSTransformertransformer = new XLSTransformer(); HSSFWorkbookresultWorkbook = transformer.transformXLS(is, beans);

try { Class.forName("oracle.jdbc.driver.OracleDriver"); conn=DriverManager.getConnection(url,"gaps32", "gaps32"); Map beans = new HashMap(); ReportManager rm = new ReportManagerImpl( conn, beans ); beans.put("rm", rm); XLSTransformer transformer = new XLSTransformer(); transformer.transformXLS(report, beans,reportDest ); conn.close(); } catch (ClassNotFoundException e1) { e1.printStackTrace(); } catch (SQLException e2){ e2.printStackTrace(); }//. . .

Statement stmt = conn.createStatement(); String query = "SELECT * FROM SAI"; rs = stmt.executeQuery(query); Map beans = newHashMap(); RowSetDynaClass rsc = new RowSetDynaClass(rs,false); beans.put("employee", rsc.getRows()); XLSTransformer transformer = new XLSTransformer(); transformer.transformXLS(report, beans,reportDest ); conn.close();//…

Class.forName("oracle.jdbc.driver.OracleDriver"); conn=DriverManager.getConnection(url,"gaps32", "gaps32"); Statement stmt=conn.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE,ResultSet.CONCUR_READ_ONLY); String query = "SELECT NAME, AGE, PAYMENT, BONUS, IDFROM SAI"; rs = stmt.executeQuery(query); Map beans = newHashMap(); ResultSetCollection rsc = new ResultSetCollection(rs,false); beans.put( "employee", rsc ); XLSTransformer transformer = new XLSTransformer(); transformer.transformXLS(report, beans,reportDest );

List staff = newArrayList(); staff.add(new Employee("Derek", 35, 3000, 0.30)); staff.add(new Employee("Elsa", 28, 1500, 0.15)); staff.add(new Employee("Oleg", 32, 2300, 0.25)); staff.add(new Employee("Neil", 34, 2500, 0.00)); staff.add(new Employee("Maria", 34, 1700, 0.15)); staff.add(new Employee("John", 35, 2800, 0.20)); staff.add(new Employee("Leonid", 29, 1700, 0.20)); Map beans = newHashMap(); beans.put("employee", staff); XLSTransformer transformer =new XLSTransformer(); transformer.markAsFixedSizeCollection("employee"); transformer.transformXLS(templateFileName, beans,destFileName);

JXLS教程

一．JXLS简介

二．JXLS安装

三．JXLS参考

你可能感兴趣的:(JXLS教程)