Package org.zkoss.pivot.util

Class Exports

java.lang.Object

org.zkoss.pivot.util.Exports

public class Exports
extends Object

Utility class for PivotTable Exporter

Author:

vincentjian, Neil Lee

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_FORMAT	Default file format for exporting to excel.
static final String	XLS
static final String	XLSX
static final String	XLSX_STATIC

Constructor Summary

Constructors

Constructor	Description
Exports()

Method Summary

Modifier and Type	Method	Description
static void	exportCSV(OutputStream out, PivotExportContext context)	Export Pivottable to CSV format, with comma as separator
static void	exportCSV(OutputStream out, PivotExportContext context, String separator)	Export Pivottable to CSV format.
static void	exportExcel(OutputStream out, io.keikai.model.SBook book, PivotExportContext context)	Export Pivottable to excel format.
static void	exportExcel(OutputStream out, io.keikai.model.SBook book, PivotExportContext context, CellStyleConfigurator styleConfig)	Export Pivottable to excel format.
static void	exportExcel(OutputStream out, String fileFormat, PivotExportContext context)	Export Pivottable to excel format.
static void	exportExcel(OutputStream out, String fileFormat, PivotExportContext context, CellStyleConfigurator styleConfig)	Export Pivottable to excel format.
static void	exportExcel(OutputStream out, PivotExportContext context)	Export Pivottable to default Excel 2007 format
static PivotExportContext	getExportContext(PivotModel model, PivotRenderer renderer, String dataFieldOrient, boolean open, String[] titles)	Return a context for exporting Pivottable information
static PivotExportContext	getExportContext(PivotModel model, PivotRenderer renderer, String dataFieldOrient, boolean open, String[] titles, boolean useRendererForDataCells)
static PivotExportContext	getExportContext(Pivottable table, boolean open, String[] titles)	Return a context for exporting Pivottable information
static PivotExportContext	getExportContext(Pivottable table, boolean open, String[] titles, boolean useRendererForDataCells)
static PivotExportContext	getExportContext(Pivottable table, boolean open, String[] titles, boolean useRendererForDataCells, PivotExportSheetConfig sheetConfig)	Return a context for exporting Pivottable information

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

XLSX

public static final String XLSX

See Also:

• Constant Field Values

XLSX_STATIC

public static final String XLSX_STATIC

See Also:

• Constant Field Values

XLS

public static final String XLS

See Also:

• Constant Field Values

DEFAULT_FORMAT

public static final String DEFAULT_FORMAT

Default file format for exporting to excel. Use library property org.zkoss.pivot.export.format to specify different default.

Constructor Details

Exports

public Exports()

Method Details

exportExcel

public static void exportExcel(OutputStream out,
 PivotExportContext context)
                        throws IOException

Export Pivottable to default Excel 2007 format

Parameters:

out - the output stream to write to

context - the export context created from Pivottable or model

Throws:

IOException

Since:

2.2.0

exportExcel

public static void exportExcel(OutputStream out,
 String fileFormat,
 PivotExportContext context)
                        throws IOException

Export Pivottable to excel format. Note:

1. "xlsx" format creates a sheet with native Pivot Table (also contains a sheet with source data)
2. "xlsx.static" format creates a sheet with Pivottable data.
3. "xls" format creates a sheet with Pivottable data.

Parameters:

out - the output stream to write to

fileFormat - "xls", "xlsx", or "xlsx.static" supported.

context - the export context created from Pivottable or model

Throws:

IOException

exportExcel

public static void exportExcel(OutputStream out,
 io.keikai.model.SBook book,
 PivotExportContext context)
                        throws IOException

Export Pivottable to excel format.

Note the xlsx book create sheet with native Pivot Table (also contains a sheet with source data),
the book imported from an xls file create sheet with Pivottable data. Call SBook.destroy() once done with the book.

Parameters:

out - the output stream to write to, if null the book is only filled

book - the book, if null will use DEFAULT_FORMAT.

context - the export context created from Pivottable or model

Throws:

IOException

Since:

2.2.0

exportExcel

public static void exportExcel(OutputStream out,
 String fileFormat,
 PivotExportContext context,
 CellStyleConfigurator styleConfig)
                        throws IOException

Export Pivottable to excel format.

1. "xlsx" format creates a sheet with native Pivot Table (also contains a sheet with source data)
2. "xlsx.static" format creates a sheet with Pivottable data.
3. "xls" format creates a sheet with Pivottable data.

Parameters:

out - the output stream to write to

fileFormat - "xls", "xlsx", or "xlsx.static" supported.

context - the export context created from Pivottable or model

styleConfig - configurator for excel cell style

Throws:

IOException

exportExcel

public static void exportExcel(OutputStream out,
 io.keikai.model.SBook book,
 PivotExportContext context,
 CellStyleConfigurator styleConfig)
                        throws IOException

Export Pivottable to excel format.

Note the xlsx book create sheet with native Pivot Table (also contains a sheet with source data),
the book imported from an xls file create sheet with Pivottable data. Call SBook.destroy() once done with the book.

Parameters:

out - the output stream to write to, if null the book is only filled

book - the book, if null will use DEFAULT_FORMAT.

context - the export context created from Pivottable or model

styleConfig - configurator for excel cell style

Throws:

IOException

Since:

2.2.0

exportCSV

public static void exportCSV(OutputStream out,
 PivotExportContext context)
                      throws IOException

Export Pivottable to CSV format, with comma as separator

Parameters:

out - the output stream to write to

context - the export context created from Pivottable or model

Throws:

IOException

exportCSV

public static void exportCSV(OutputStream out,
 PivotExportContext context,
 String separator)
                      throws IOException

Export Pivottable to CSV format.

Parameters:

out - the output stream to write to

context - the export context created from Pivottable or model

separator - the separator for marking cell boundary in CSV file

Throws:

IOException

getExportContext

public static PivotExportContext getExportContext(Pivottable table,
 boolean open,
 String[] titles)

Return a context for exporting Pivottable information

Parameters:

table - the Pivottable instance

open - export as if all the header nodes were open (the model is not affected)

titles - title text for data, column, row title cells, respectively. i.e. titles[0] will be rendered to the data title cell, titles[1] to the column title cell, and titles[2] to the row title cell.

getExportContext

public static PivotExportContext getExportContext(Pivottable table,
 boolean open,
 String[] titles,
 boolean useRendererForDataCells)

getExportContext

public static PivotExportContext getExportContext(Pivottable table,
 boolean open,
 String[] titles,
 boolean useRendererForDataCells,
 PivotExportSheetConfig sheetConfig)

Return a context for exporting Pivottable information

Parameters:

table - the Pivottable instance

open - export as if all the header nodes were open (the model is not affected)

titles - see getExportContext(Pivottable, boolean, String[])

useRendererForDataCells -

sheetConfig - a PivotExportSheetConfig defining sheet names/order/visiblity

Since:

2.4.0

getExportContext

public static PivotExportContext getExportContext(PivotModel model,
 PivotRenderer renderer,
 String dataFieldOrient,
 boolean open,
 String[] titles)

Return a context for exporting Pivottable information

Parameters:

model - the PivotModel

renderer - the PivotRenderer

dataFieldOrient - to arrange data fields on column or row, if there are multiple data fields. Accepted values are "column" and "row".

open - export as if all the header nodes were open (the model is not affected)

titles - title text for data, column, row title cells, respectively. i.e. titles[0] will be rendered to the data title cell, titles[1] to the column title cell, and titles[2] to the row title cell.

getExportContext

public static PivotExportContext getExportContext(PivotModel model,
 PivotRenderer renderer,
 String dataFieldOrient,
 boolean open,
 String[] titles,
 boolean useRendererForDataCells)