Struts2对JXLS支持及JXLS的应用

JXLS使用(一)——Simple Sheet

         JXLS是一个简单易用的一个用于生成和读入Excel的工具,有兴趣的朋友可以到Jxls的官网上面下载最新版本的Jxls,目前Jxls最新的版本是0.9.5,下载的Zip包里面有一个Doc和Example,不过,官网所提供的东西太过简单,如果,需要详细了解Jxls的功能和使用方法的话,可以仔细研究其源代码。

         将Jxls源代码导入到Eclipse的环境中就可以查看和分析其源代码了,导入Eclipse的方法是:
         1)将下载的压缩包里面的Src目录下面的jxls-core和jxls-reader两个文件夹拷贝到一个目录下面(也可以不用拷贝)
         2)在DOS下面进入jxls-core目录下面,输入命令:mvn -eclipse:eclipse。jxls-reader的生成方式也是一样的
         3)打开Eclipse,将生成的两个项目导入
         使用jxls的时候其实就使用两个类就够了:XLSTransformer和Util,至少在我目前的使用过程中只使用到这么两个类。

         jxls的使用方法:
         1)将jxls的jar文件放到我们的程序目录下面,如果,使用Maven的话,直接在Project的pom.xml里面配置依赖就可以了
         2)根据需要生成的Excel文件或者Report的格式,设置一个jxls的Template文件,Template其实就是一个特殊的一些Excel文件,里面包含了一些jxls的Tag标签。
               jxls的Tag其实有点想jstl标签库的使用方式,在取出一个对象的值的时候可以利用下面这样的Tag来将值输出:${object1.property1};如果需要将一个Map输出到Excel的时候定义方式如下:${map.get('property1')};
           3)声明一个XLSTransformer对象,生成方式就是使用new操作符
                XLSTransformer transformer = new XLSTransformer();
          4)得到Template的FIle:
                 String xlsTemplateFileName = this.getClass().getClassLoader().getResource("template.xls");
          5)利用XLSTransformer的类的方法生成Excel文件
                 String xlsFileName = "c:"+File.separator+"resule.xls";
                 Map beans = new HashMap();
                 beans.put("newBeans1","new beans1");
                 beans.put("newBeans2","new beans2");
                 transformer.transformXLS(xlsTemplateFileName , beans, xlsFileName);

                  XLSTransformer类的transformXLS方法的定义如下:
                 public void transformXLS(String srcFilePath, Map beanParams, String destFilePath) throws ParsePropertyException, IOException其中:
                 srcFilePath:是Template文件的全文件名(包含路径)
                  beanParams:需要传入Excel里面的一个Map,jxls根据Template里面的定义和Map里面的对象对Template进行解析,将Map里面的对象值填入到Excel文件中
                 destFilePath:需要生成的Excel文件的全文件名(包含路径)

注:jxls虽然提供了Example,但是,都过于简单,如果想详细了解jxls,可以仔细研究jxls-core,其实没有必要查看其全部代码,如果只是想了解其具体操作,可以详细查看类XLSTransformerTest,即XLSTransformer的测试代码。
                 

jxls使用(二)——Multiple Sheets

      jxls在生成Excel文件时,提供一个批量生成Excel Sheet的功能,即可以一次生成一个包含多个Sheet的Excel文件。但是,jxls在处理这类操作的时候会出现性能问题,当一次形成的Excel的Sheet数量超过500个的时候就会出现很严重的性能问题,运算到最后,系统会提示OutOfMemeroyError,这种问题的出现是由于jxls的实现方式决定的。

        如果,仔细查看jxls的源代码就会发现,无论是处理单个Sheet还是处理多个Sheet的时候,在XLSTransformer类的Transform处理的时候都是在内存中对Sheet进行处理,然后,在生成WorkBook。假如,需要一次形成的Sheet为500以上的时候,势必会出现严重的性能问题。

        针对以上的问题,如果我们的应用需要形成500Sheet以上的Excel时,我们可以采用人为干预的方式,即在进行处理前对Beans的个数进行限制,最好将Beans的个数限制在200个以内,即每次只生成包含200个Sheet的WorkBook,在WorkBook形成以后,再对WorkBook进行合并,然后,将合并的WorkBook输出形成Excel文件,这样处理的时候,对一个Excel的总的Sheet也需要进行控制,否则在运算的过程中也会出现OutOfMemeroyError,最好控制在3000个以内,如果,超过3000个建议形成多个Excel文件,下面我通过一个具体的企业应用来说明怎么来进行操作。

        我这个应用是Payslip导出的一个应用,具体要求是:
        按照Division和Costcenter来组织Payslip卡片,每个Costcenter下面的员工组织到一个Excel文件里面

        在具体实现的过程发现有一个Costcenter下面的员工数量超过了3000,开始是想是否能够一次将这个Costcenter下面的Payslip全部形成,结果遭到了可耻的失败。经过不断的测试以后,得到了以上的两个临界点的数字。下面说明一下我的具体实现:
        1)从数据库按照Costcenter取出Payslip,得到一个payslipList对象。具体就是组装出取数据的SQL Script,利用JDBCTemplate取出数据。
        2)形成Costcenter对应的Excel文件的名称,如果,得到的List的size大于3000,则每3000个记录形成一个Excel文件
        3)将得到的List按照200进行分块处理,每200处理一次
        4)利用jxls提供的方法transformMultipleSheetsList()对数据进行处理,得到一个HSSFWorkbook对象
        5)合并得到的HSSFWorkbook,输出形成Excel文件
具体代码如下:

public void exportPayslip(String costcenterCode) throws IOException{   
       List payslipList = payslipDao.getPaylipByCostcenter(String costcenterCode);   
       String xlsFileName;   
  
      if (payslipList.size() <= 3000){   
            xlsFileName = "c:"+File.separator+costcenterCode+".xls";   
            transformXLSFile(payslipList ,xlsFileName );   
       } else {   
           for (int i =0;i<(int)Math.ceil((double)payslipList.size()/3000;i++)){   
                 xlsFileName = "c:"+File.separator+costcenterCode+"_"+new Integer(i+1).toString()+".xls";   
                int k = ((i+1)*3000 < payslipList.size()) ? (i+1)*3000 : resultList.size();   
                 List resultList = payslipList.subList(i*3000,k);   
                 transformXLSFile(resultList ,xlsFileName );   
            }   
       }   
}   
  
private void transformXLSFile(List resultList,String fileName){   
      XLSTransformer transformer = new XLSTransformer();   
      HSSFWorkBook resultWorkBook = null;   
  
     for (int i = 0;i<(int)Math.ceil((double)resultList.size()/200;i++)){   
            List payslipMaps = new ArrayList();   
            List sheetNames = new ArrayList();   
  
            InputStream xlsTemplateIO = new BufferedInputStream(getClass().getResourceAsStream("payslip.xls"));   
  
           int k = ((i+1)*200 < resultList.size()) ? (i+1)*200 : resultList.size();   
  
            payslipMaps = resultList.subList(i*200,k);   
  
           for (int j=0;j
                 Map payslip = (Map)resultList.get(i);   
                 String sheetName = paysli.get("EMPLOYEE_ID");   
  
                 sheetNames.add(sheetName);   
            }   
              
            HSSFWorkbook workBook = transformer.transformMultipleSheetsList(xlsTemplateIO , payslipMaps , sheetNames, "map", new HashMap(), 0);   
  
           if (i == 0){   
                  resultWorkBook = workBook;   
            } else {   
                 for (int h = 0;h < workBook.getNumberOfSheets();h++){   
  
                       HSSFSheet newSheet = resultWorkBook.createSheet( (String) sheetNames.get(i) );   
                       HSSFSheet hssfSheet = workBook.getSheetAt(h);   
                       Util.copySheets(newSheet, hssfSheet);   
                       Util.copyPageSetup(newSheet, hssfSheet);   
                       Util.copyPrintSetup(newSheet, hssfSheet);   
                  }   
            }   
  
            saveWorkbook(resultWorkbook, fileName);   
            xlsTemplateIO.close();   
      }   
}   
  
private void saveWorkbook(HSSFWorkbook resultWorkbook, String fileName) throws IOException{   
       OutputStream os = new BufferedOutputStream(new FileOutputStream(fileName));   
       resultWorkbook.write(os);   
       os.flush();   
       os.close();   
}  


         以上代码有部分代码需要被放在try/catch语句里面,确保Stream能够被关闭,否则,会影响程序的运行性能。代码只代表个人的一种实现方式。

        以上代码有一个地方需要说明,就是jxls的transformMultipleSheetsList()方法,该方法的声明如下:

java 代码
  1. public HSSFWorkbook transformMultipleSheetsList(InputStream is, List objects, List newSheetNames, String beanName, Map beanParams, int startSheetNum) throws ParsePropertyException {  

         该方法里面的参数说明如下:
        1)is:即Template文件的一个输入流
        2)newSheetNames:即形成Excel文件的时候Sheet的Name
        3)objects:即我们传入的对应每个Sheet的一个Java对象,这里传入的List的元素为一个Map对象
        4)beanName:这个参数在jxls对我们传入的List进行解析的时候使用,而且,该参数还对应Template文件中的Tag,例如,beanName为map,那么在Template文件中取值的公式应该定义成${map.get("property1")};如果beanName为payslip,公式应该定义成${payslip.get("property1")}
        5)beanParams:这个参数在使用的时候我的代码没有使用到,这个参数是在如果传入的objects还与其他的对象关联的时候使用的,该参数是一个HashMap类型的参数,如果不使用的话,直接传入new HashMap()即可
        6)startSheetNo:传入0即可,即SheetNo从0开始

        以上代码的原理与操作Simple Sheet的时候差别不大,主要是Template的文件的取值公式和调用的方法有所改变而已。关键是在大数据量操作的时候注意对处理的数据进行分块处理即可,否则,系统运行性能将很难保证。以上代码,在我实际的使用过程中速度还是比较理想的,16000条数据的导出时间是15分钟左右。


猜你喜欢

转载自blog.csdn.net/yuliqi0429/article/details/41907645