eXtremeTable--Export

Export

导出

 

Introduction

介绍

 

eXtremeTable本身有一个能力, 就是可以导出table内容为多种格式. 当导出时, 在过滤和排序后,  你将会得到完整的结果集.  分页不会影响返回的结果记录. 换句话说, 如果table内容显示在多页时, 所有页面的所有结果记录都会被导出. 导出的格式包括 Excel, PDF 和CSV.

 

为了导出 Microsoft Excel (OpenOffice Calc), 需要使用ExportXls Tag.

 <ec:table
   items="presidents" 
   action="${pageContext.request.contextPath}/presidents.run" 
   />
   <ec:exportXls
     fileName="presidents.xls" 
     tooltip="Export Excel"/>
   ...
 </ec:table>

默认的XlsView使用的是UTF-16编码. 如果你需要使用unicode, 那么可以使用编码特性. 可以使用的编码有UTF和UNICODE.

 

为了导出PDF, 可以使用ExportPdfTag. 你需要定义是fileName特性和一些其他类型的特性.

 <ec:table
   items="presidents"
   action="${pageContext.request.contextPath}/presidents.run" 
   />
   <ec:exportPdf 
     fileName="presidents.pdf" 
     tooltip="Export PDF" 
     headerColor="blue" 
     headerBackgroundColor="red" 
     headerTitle="Presidents"/>
   ...
 </ec:table>

为了导出CSV, 可以使用ExportCsvTag. 当使用CSV导出是, 默认的分隔符是逗号. 如果你想要用其他符号来分割的话, 那么可以使用delimiter特性. 在这个例子中, 我使用竖杠(pipe)来分割.

 <ec:table
   items="presidents" 
   action="${pageContext.request.contextPath}/presidents.run"    />
   <ec:exportCsv 
     fileName="presidents.txt" 
     tooltip="Export CSV" 
     delimiter="|"/>
   ...
 </ec:table>

如果你想要构建其他的输出格式, 你可以用view特性. 在eXtremeTable中views实现了接口View, 是可插拔式的. 可以参考 [[Views|View]] 这一章节获取更多的信息.

 

Interceptor

拦截器

 

拦截器的特征就是被用来在运行时改变属性值的. 这就能够改变基于数据的导出行为了, 关于更多的拦截器相关可以参考  interceptor tutorial.

 

Extended Attributes

扩展特性

 

大部分tags被开发的方式是, 在一个tag上拥有一些固定的特性. 那些特性然后被使用, 一些固定集合的功能能够被调用. 然而, eXtremeTable有着更多的灵活性. eXtremeTable给你一种方式来增加你自己tag的特性, 以至于你能做更多定制化的工作. 不止如此, 在eXtremeTable中有着更清晰的hooks, 从而允许你获取到那些自定义的tag特性, 然后再编辑它们. 下面将会是一个典型的自定义的View.

 

hook为了能包括eXtremeTable中的特性, 可以通过addExportAttributes()方法.

public void addExportAttributes(TableModel model, Export export) {
}

ExportTag调用这个方法, 如果其方法被重写了. 那也就意味着你需要扩展ExportTag, 重写addExportAttributes()方法, 然后增加你自己的特性到Export对象中.

 

这个就是ExportCsvTag的示例代码:

public class ExportCsvTag extends ExportTag {
  private String delimiter;
  
  public String getDelimiter() {
        return delimiter;
  }

  public void setDelimiter(String delimiter) {
        this.delimiter = delimiter;
  }
  
  public void addExportAttributes(TableModel model, Export export) {
        export.addAttribute(CsvView.DELIMITER, TagUtils.evaluateExpressionAsString("delimiter", delimiter, this, pageContext));
    }
}

 

既然你增加了特性, 你可以从Export中来获取他们. 这里是CsvView实现的一部分代码:

 public class CsvView implements View {
   public void body(TableModel model, Column column) {
     Export export = model.getExportHandler().getCurrentExport();
     String delimiter = export.getAttributeAsString(DELIMITER);
   }
 }

另外一件事我想要确保你明白的是, 你能够创建你自己的tag, 拥有你自己的TLD文件. 你不需要去修改extremecomponents.tld文件. 还可以你使用你自定义的tag, 就如同在eXtremeTable中你使用其他的tag一样, 除非你引用你自己的tag.  例如, 如果你的tag引用是mycompany, tag被称为customExport, 你可以编辑成下面这样:

 <ec:table 
     items="presidents" 
     action="${pageContext.request.contextPath}/public/demo/presidents.jsp" 
     title="Presidents"
     >
   <mycompany:customExport fileName="presidents.txt" delimiter="|"/>
   ...
 </ec:table>

 

 

original text: https://code.google.com/p/extremetable/wiki/Export