jxls是一个轻量级的java库,用于基于模板的excel报表生成。
jxls作为一个开源工具,提供了一种高效且易于维护的方式来处理复杂的excel导出需求。它允许用户通过在excel模板中放置特定的标记或注释来定义数据的输出格式和布局,从而避免了编写大量重复且易出错的代码。
标注:简单的excel格式,用简单的poi,easyexcel等工具都能导出。但是针对复杂的excel,有固定的样式、合并单元格、动态列等各类要求,导致excel 导出需要花很大一部分精力去写代码。jxls在很大程度上解决了以上问题。
以下是jxls的一些主要特点:
- 简单性: jxls的设计哲学是简单和直观,使得即使是初学者也能快速上手并使用它来创建复杂的excel报表。
- 灵活性: 通过在excel模板中使用类似jsp的标签,jxls提供了极高的灵活性,可以轻松地生成各种格式的报表。
- 轻量级: 与其他java excel库相比,jxls更加轻量,不会给项目增加太多的负担。
- 功能强大: jxls特别适合于处理包含固定样式、合并单元格和动态列等复杂要求的excel导出任务。
- 易于维护: 使用jxls可以减少因手动编码导致的维护成本和出错概率,提高项目的可维护性。
添加jar
很高兴在编写文章时发现jxls的大版本升级了,所使用的jdk版本也来到了17。
对于原先的jxls2.x版本的使用者来说,新的构建器 api 取代了 jxlshelper
。transformerfactory
和 createtransformer()
方法也已被删除。
context 现在包含创建报表所需的所有信息。但数据以map<string, object>
的形式传递给 jxlstemplatefiller
。
<dependency> <groupid>org.jxls</groupid> <artifactid>jxls-poi</artifactid> <version>3.0.0</version> </dependency>
xlsarea 区域
area是jxls中的一个主要概念,它本质上代表了一个矩形区域,这个区域包含了需要进行数据转换的单元格。每个area可以包含一组转换命令和一组嵌套的子区域,这些子区域也是area,它们有自己的命令和子区域。
如下命令表示需要处理的区域为从a1至k列第4行:
jx:area(lastcell="k4")
创建报表
因为大版本的升级,我们不再使用如下方式:
context context = new context(); context.putvar("list", list); jxlshelper.getinstance().setevaluateformulas(evaluateformulas).processtemplate(inputstream, outputstream, context);
而是:
map<string, object> data = new hashmap<>(); data.put("employees", employees); jxlspoitemplatefillerbuilder.newinstance() .withtemplate("template.xlsx") .build() .fill(data, new file("report.xlsx"));
循环
循环是用的最多的标签,用于循环输出各列数据:
jx:each(items="weeks" var="week" lastcell="b4")
示例:
public class employee { private string name; private date birthdate; private bigdecimal payment; private bigdecimal bonus; // getters/setters ... public employee(string name, date birthdate, double payment, double bonus) { this(name, birthdate, new bigdecimal(payment), new bigdecimal(bonus)); } public string getsalarygroup() { return payment.doublevalue() > 2000d ? "high" : "normal"; } } list<employee> employees = new arraylist<>(); simpledateformat dateformat = new simpledateformat("yyyy-mmm-dd", locale.us); employees.add(new employee("elsa", dateformat.parse("1970-jul-10"), 1500, 0.15)); employees.add(new employee("oleg", dateformat.parse("1973-apr-30"), 2300, 0.25)); employees.add(new employee("john", dateformat.parse("1970-jul-10"), 3500, 0.10)); employees.add(new employee("neil", dateformat.parse("1975-oct-05"), 2500, 0.00)); employees.add(new employee("maria", dateformat.parse("1978-jan-07"), 1700, 0.15)); employees.add(new employee("john", dateformat.parse("1969-may-30"), 2800, 0.20)); employees.add(new employee("oleg", dateformat.parse("1988-apr-30"), 1500, 0.15)); employees.add(new employee("maria", dateformat.parse("1970-jul-10"), 3000, 0.10)); employees.add(new employee("john", dateformat.parse("1973-apr-30"), 1000, 0.05)); return employees;
将模版编辑为如下:
根据输出报表查看结果。
1.multisheet 多sheet页
jx:each(items="employees" var="e" multisheet="sheetnames" lastcell="b4")
输出:
2.方向向右
默认值为 direction=“down”
,将创建行。将使用 direction=“right”
创建列。
您也可以为特殊情况设置自己的 cellrefgenerator
,但在此不再进一步描述。
jx:each(items="e.departments" var="d" lastcell="d2" direction="right")
3.索引
有时我们需要显示循环的索引。使用属性 varindex
指定将保存从 0 开始的迭代索引的变量名称。
jx:each(items="employees" var="e" varindex="index" lastcell="c2")
显示:
4.过滤
只有选择条件为 true 的项才会成为输出的一部分。
jx:each(items="employees" var="e" select="e.payment > 2000" lastcell="c2")
5. 分组和分组排序
在属性中指定 var name + “.” + 属性名称
以对项目进行分组。还必须在属性中指定 asc、desc此时将在组内部进行排序。
比如employee
类中有salarygroup
(工资)方法来指定该人是否大于2000元。
示例代码:
jx:each(items="employees" var="g" groupby="g.salarygroup" grouporder="asc" lastcell="c3")
示例图:
判断
jx:if
命令根据条件表达式显示/隐藏单元格。这就像 java 中的 if
或 if,else
。
jx:if(condition="e.payment<2000" lastcell="c2" areas=["a2:c2","a3:c3"])
condition:
如果表达式结果为真,则显示区域,否则隐藏区域; 如果表达式结果不为 true,则显示其他区域,否则隐藏其他区域。
动态行列
jx:grid
命令可用于生成具有标题区域和数据行区域的动态 网格。
jx:grid(headers="headers" data="items" areas=["a3:a3","a4:a4"] formatcells="bigdecimal:c1,date:d1" lastcell="a4")
合并单元格
jx:mergecells(cols="" rows="" mincols="" minrows="" lastcell="c2")
- cols: 组合列数
- rows: 合并的行数
- mincols: 要合并的最小列数
- minrows: 要合并的最小行数
- lastcell: 合并单元格范围。
图片
使用此命令将图像添加到工作表中。
jx:image(src="image" lastcell="a2")
- src: 返回包含图像数据的
byte[]
数组的表达式 - imagetype: 可以包含以下值:
png
(默认值)、jpeg
(非 jpg)、emf
、wmf
、pict
、dib
。 - scalex和scaley: 缩放参数(可选)
- lastcell: 区域结束
excel 公式**处理
参数化公式允许在公式中使用变量,必须将其括在$[ ]
符号中,比如我们需要把数据输出的同时进行计算,比如我们数据中的比率值是1(excel上最终需要显示为1%)。我们可以修改代码为$[${item.taxrate}/100]
,其中${item.taxrate}
表示我们自己的迭代变量,同时改变单元格样式为百分比,此时输出的值才会是1%
到此这篇关于java使用jxls导出excel详解的文章就介绍到这了,更多相关java jxls导出excel内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论