org.apache.poi.ss.util
Class SheetBuilder

java.lang.Object
  extended by org.apache.poi.ss.util.SheetBuilder

public class SheetBuilder
extends java.lang.Object

Class SheetBuilder provides an easy way of building workbook sheets from 2D array of Objects. It can be used in test cases to improve code readability or in Swing applications with tables.

Author:
Roman Kashitsyn

Constructor Summary
SheetBuilder(Workbook workbook, java.lang.Object[][] cells)
           
 
Method Summary
 Sheet build()
          Builds sheet from parent workbook and 2D array with cell values.
 boolean getCreateEmptyCells()
          Returns true if null array elements should be treated as empty cells.
 SheetBuilder setCreateEmptyCells(boolean shouldCreateEmptyCells)
          Specifies if null array elements should be treated as empty cells.
 SheetBuilder setSheetName(java.lang.String sheetName)
          Specifies name of the sheet to build.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SheetBuilder

public SheetBuilder(Workbook workbook,
                    java.lang.Object[][] cells)
Method Detail

getCreateEmptyCells

public boolean getCreateEmptyCells()
Returns true if null array elements should be treated as empty cells.

Returns:
true if null objects should be treated as empty cells and false otherwise

setCreateEmptyCells

public SheetBuilder setCreateEmptyCells(boolean shouldCreateEmptyCells)
Specifies if null array elements should be treated as empty cells.

Parameters:
shouldCreateEmptyCells - true if null array elements should be treated as empty cells
Returns:
this

setSheetName

public SheetBuilder setSheetName(java.lang.String sheetName)
Specifies name of the sheet to build. If not specified, default name (provided by workbook) will be used instead.

Parameters:
sheetName - sheet name to use
Returns:
this

build

public Sheet build()
Builds sheet from parent workbook and 2D array with cell values. Creates rows anyway (even if row contains only null cells), creates cells if either corresponding array value is not null or createEmptyCells property is true. The conversion is performed in the following way:

Returns:
newly created sheet


Copyright 2012 The Apache Software Foundation or its licensors, as applicable.