JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

时间:2020-12-26 13:57:34

注:本文代码建立于前面写的代码。不过不看也不要紧。

  前面的文章把JXLS 2.4.0 的基本使用写了一遍,现在讲讲一些更进一步的使用方法。我只写一些我用到过的方法,更多的高级使用方法请参考官网。

  http://jxls.sourceforge.net/

一、Map的应用

  从一开始,官方dome使用的model中的引用对象一直都是一个javaBean对象。后来我发现其实可以直接往model中放一个map,然后也是直接用“点”的方式在excel中取出数据。

  下面用第四篇文章——多sheet的源码做演示,我们先修改main方法,加入一个HashMapMap:

public static void main(String[] args) throws Exception {
// 模板位置,输出流
String templatePath = "E:/template5_2.xls";
OutputStream os = new FileOutputStream("E:/out5_2.xls"); List<Student> list = generateData(); // 模拟数据库获取数据
//List<Page> page = DataByPage.byPage(list); // 把获取的数据进行分页转换
List<Page> page = individual(list); // 一页一个人 // 定义一个Map
Map<String, String> tableInfo = new HashMap<String, String>();
tableInfo.put("className", "六年三班2");
tableInfo.put("teacherComment", "已核实2");
tableInfo.put("directorComment", "已核实2"); Map<String, Object> model = new HashMap<String, Object>();
model.put("pages", page);
model.put("sheetNames", getSheetName(page));
model.put("tableInfo", tableInfo);
//model.put("className", "六年三班");
//model.put("teacherComment", "已核实");
//model.put("directorComment", "已核实"); JxlsUtils.exportExcel(templatePath, os, model);
os.close();
// 删除多出来的sheet
DelSheet.deleteSheet("E:/out5_2.xls", "template");
System.out.println("完成");
}

  把原来的model中put的多注释掉,然后把定义的Map tableInfo 放入model中。

  我们看看模板中怎么取:

JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

  直接取新加入的map的键名,再“点上”tableInfo的键名。

JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

  就这样轻松的取出来了。Map也是可以直接放进model中的,有时候Map用起来更加灵活,这就要自行选择了。

二、使用工具

  工具的使用先看JxlsUtils类。

public class JxlsUtils{
public static void exportExcel(InputStream is, OutputStream os, Map<String, Object> model) throws IOException{
Context context = PoiTransformer.createInitialContext();
if (model != null) {
for (String key : model.keySet()) {
context.putVar(key, model.get(key));
}
}
JxlsHelper jxlsHelper = JxlsHelper.getInstance();
Transformer transformer = jxlsHelper.createTransformer(is, os);
//获得配置
JexlExpressionEvaluator evaluator = (JexlExpressionEvaluator)transformer.getTransformationConfig().getExpressionEvaluator();
//设置静默模式,不报警告
evaluator.getJexlEngine().setSilent(true);
//函数强制,自定义功能
Map<String, Object> funcs = new HashMap<String, Object>();
funcs.put("utils", new JxlsUtils()); //添加自定义功能
evaluator.getJexlEngine().setFunctions(funcs);
//必须要这个,否者表格函数统计会错乱
jxlsHelper.setUseFastFormulaProcessor(false).processTemplate(context, transformer);
}
public static void exportExcel(File xls, File out, Map<String, Object> model) throws FileNotFoundException, IOException {
exportExcel(new FileInputStream(xls), new FileOutputStream(out), model);
}
public static void exportExcel(String templatePath, OutputStream os, Map<String, Object> model) throws Exception {
File template = getTemplate(templatePath);
if(template != null){
exportExcel(new FileInputStream(template), os, model);
} else {
throw new Exception("Excel 模板未找到。");
}
}
//获取jxls模版文件
public static File getTemplate(String path){
File template = new File(path);
if(template.exists()){
return template;
}
return null;
}
// 日期格式化
public String dateFmt(Date date, String fmt) {
if (date == null) {
return "";
}
try {
SimpleDateFormat dateFmt = new SimpleDateFormat(fmt);
return dateFmt.format(date);
} catch (Exception e) {
e.printStackTrace();
}
return "";
}
// if判断
public Object ifelse(boolean b, Object o1, Object o2) {
return b ? o1 : o2;
}
}

  我们看到有一行:funcs.put("utils", new JxlsUtils());    //添加自定义功能

//函数强制,自定义功能
Map<String, Object> funcs = new HashMap<String, Object>();
funcs.put("utils", new JxlsUtils()); //添加自定义功能
evaluator.getJexlEngine().setFunctions(funcs);

  这行代码的意思就是设置一个工具类JxlsUtils(),在excel中的引用为utils 。当你在excel中使用 utils 时就会调用JxlsUtils() 类(可以是其他的类)的对应方法。

  我们来看下模板怎么写:

JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

  在模板中,你可以这样调用工具类:

${utils:ifelse(page.currentPage == page.tolalPage,"最后一页","")}

  JXLS会自动找到utils这个键对应的值 new JxlsUtils() ,然后在JxlsUtils类中找对应的ifelse方法,然后根据方法接收的参数自动把你在excel写的参数传进去,再把方法的返回值显示在excel中。

  还记得我前面保存进Page中的当前页码和总页码这两个属性吗?现在就是使用使用他们了。用他们可以判断现在的sheet是不是最后一页,最后一页可以显示一些别的数据。一般说ifelse这个已经够用了,但是如果你有更加复杂的操作,你也可以自行定制自己需要的工具类。

三、JXLS 是支持模板多个sheet输出数据的

  这句话很奇怪,但是我一下子没想出别的表达。这个多sheet不是前面我们讲的分sheet,是说你模板有本身就已经有很多个sheet了,每个sheet显示的表都不一样,不用担心,你存放进model中的数据是可以跨sheet的。只要你想取出就能取出,这个我就不演示了。

四、页面边距bug

  这个bug一般人是真没有发现的,但是对我来说就是差点要了老命....我们公司项目导出的excel报表比较大,一张A3纸都只是勉勉强强够打印。所以平常边距要设定得很小,这个边距的bug就是你在模板中设定的页面边距并不会拷贝进你导出的文件的。

  你可能试验了一下说,没有啊,我的没问题啊。我说的不会拷贝仅是在分页分sheet导出时候出现的问题。我举个例子,你在模板中设定了页面边距,然后导出,JXLS会先把你的模板复制进导出的文件中,然后建立一个新的sheet,然后在根据模板的设定把内容拷贝进新sheet中,然后再建立新sheet不断循环。

  问题就出现在把模板拷进新sheet的过程中,如果你改变了模板的页面边距,再进行一个分sheet导出,不要用POi删除导出文件第一页空的模板sheet,你查看第一页的页边距你发现是已经修改过的页边距,而你查看后面其他sheet的页边距就会是excel默认的页边距了。

  不明白不要紧,你只要知道我已经解决了就好(新版本2.4.2我不知道作者有没有修复)。

JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

  问题就出现在这个PoiUtil的文件上,我们打开看看,看到copySheetProperties(Sheet src, Sheet dest)这个方法,这个方法就是拷贝sheet属性的。

public static void copySheetProperties(Sheet src, Sheet dest){
dest.setAutobreaks(src.getAutobreaks());
dest.setDisplayGridlines(src.isDisplayGridlines());
dest.setVerticallyCenter(src.getVerticallyCenter());
dest.setFitToPage(src.getFitToPage());
dest.setForceFormulaRecalculation(src.getForceFormulaRecalculation());
dest.setRowSumsRight(src.getRowSumsRight());
dest.setRowSumsBelow( src.getRowSumsBelow() );
//增加页边距保存
dest.setMargin(Sheet.TopMargin, src.getMargin(Sheet.TopMargin));
dest.setMargin(Sheet.LeftMargin, src.getMargin(Sheet.LeftMargin));
dest.setMargin(Sheet.RightMargin, src.getMargin(Sheet.RightMargin));
dest.setMargin(Sheet.BottomMargin, src.getMargin(Sheet.BottomMargin)); copyPrintSetup(src, dest);
}

  这个方法内少写了对sheet页边距的拷贝,加上就行。加上后怎么放回包里?你可以自行打包....你也可以在你的项目目录上建立一个与PoiUtil类一模一样的路径,然后在里面放上修改后的类。Java在找包时候会优先找你写的路径,这样就覆盖掉了包路径了。

JXLS 2.4.0系列教程(五)——更进一步的应用和页面边距bug修复

  在src的根目录上,和com同级。

  好了,这一篇文章就写到这里,写这篇文章时候我是懒的,我懒得再去做案例验证了,特别是最后的那个页边距的bug,我在当初我在网络上根本找不到和我一样的问题。我也是花了些功夫才找到这个原因的。本来我应该做下案例把这个bug讲清楚些,但是我写到这里我已经有些懒了.....说白了这个bug就是只有在分sheet导出时候才会出现的问题,能自己复现的就自己研究下,不能的,知道怎么解决了就行了。

  下载PoiUtil类: 点这里下载