Chapter 7. ExportTag

7.1. 引言

eXtremeTable具有导出不同格式文件的功能，导出的数据为过滤和排序后的所有结果集，分页不会影响返回的结果集。换句话说，如果表数据分多页显示，那么所有页的数据都将被导出。导出的格式为Microsoft Excel (OpenOffice Calc)、PDF和CSV。

使用ExportXlsTag导出Microsoft Excel (OpenOffice Calc)：

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

使用ExportPdfTag导出PDF。所有要做的就是指定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>

使用ExportCsvTag导出CSV。当使用CSV导出是默认的分隔符为‘,’(comma)。你可以使用 delimiter属性来指定为其他的符号。下面为指定‘|’（pipe）为CSV分隔符的示例：

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

你可以通过指定view属性来导出其他文件格式。eXtremeTable视图实现View接口并是可插接的。参阅View章了解更多信息。

7.2. 扩展属性

大多数标签包含一系列的固定属性，这样那些已经实现的功能能够被使用。然而，eXtremeTable具有一种更具弹性的架构，你可以添加自己的标签属性实现更多的定制工作。此外，eXtremeTable提供了非常清晰的钩子（hooks）允许你得到那些定制的标签属性来做一些你需要的工作。

通过addExtendedAttributes()方法将扩展属性包含到eXtremeTable里：

public void addExtendedAttributes(Export export);

如果方法被覆盖ExportTag将调用它。你需要做的就是扩展ExportTag，覆盖addExtendedAttributes()方法，然后添加自己的属性到导出对象中。

一个定制的ExportCsvTag示例如下:

public class ExportCsvTag extends ExportTag {
  private String delimiter;

  public String getDelimiter() {
        return delimiter;
  }

  public void setDelimiter(String delimiter) {
        this.delimiter = delimiter;
  }

  public void addExtendedAttributes(Export export) {
      String view = export.getView();
      if (StringUtils.isBlank(view)) {
          export.setView(TableConstants.VIEW_CSV);
          export.setImageName(TableConstants.VIEW_CSV);
      }
      export.addAttribute(CsvView.DELIMITER, getDelimiter());
  }
}

现在你添加了属性值到Export对象，下面是CsvView实现的一部分：

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

另外，你也可以定制自己的标签和自己的TLD文件。你不需要修改extremecomponents.tld文件。你能象使用eXtremeTable里的标签一样使用自己的标签，除了使用你自己标签的参照。假如你的标签参照为mycompany 并且标签为customExport，你可以像下面一样使用他们：

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

Chapter 7. ExportTag