Package net.sf.jasperreports.poi.data

Class AbstractPoiXlsDataSource

java.lang.Object

net.sf.jasperreports.engine.data.JRAbstractTextDataSource

net.sf.jasperreports.engine.data.AbstractXlsDataSource

net.sf.jasperreports.poi.data.AbstractPoiXlsDataSource

All Implemented Interfaces:

JRDataSource, JRRewindableDataSource

Direct Known Subclasses:

ExcelDataSource, JRXlsxDataSource, XlsDataSource

public abstract class AbstractPoiXlsDataSource
extends AbstractXlsDataSource

This data source implementation reads an XLSX or XLS stream.

The default naming convention is to name report fields COLUMN_x and map each column with the field found at index x in each row (these indices start with 0). To avoid this situation, users can either specify a collection of column names or set a flag to read the column names from the first row of the XLSX or XLS file.

Author:

Sanda Zaharia (shertage@users.sourceforge.net)

Field Summary

Fields inherited from class net.sf.jasperreports.engine.data.AbstractXlsDataSource

columnIndexMap, columnNames, dateFormat, EXCEPTION_MESSAGE_KEY_XLS_COLUMN_NAMES_MISMATCH_COLUMN_INDEXES, EXCEPTION_MESSAGE_KEY_XLS_FIELD_VALUE_NOT_RETRIEVED, EXCEPTION_MESSAGE_KEY_XLS_SHEET_INDEX_OUT_OF_RANGE, EXCEPTION_MESSAGE_KEY_XLS_SHEET_NOT_FOUND, INDEXED_COLUMN_PREFIX, numberFormat, PROPERTY_FIELD_COLUMN_INDEX, PROPERTY_FIELD_COLUMN_NAME, sheetSelection, useFirstRowAsHeader

Fields inherited from class net.sf.jasperreports.engine.data.JRAbstractTextDataSource

EXCEPTION_MESSAGE_KEY_CANNOT_CONVERT_FIELD_TYPE, EXCEPTION_MESSAGE_KEY_CANNOT_MODIFY_PROPERTIES_AFTER_START, EXCEPTION_MESSAGE_KEY_NODE_NOT_AVAILABLE, EXCEPTION_MESSAGE_KEY_NULL_DOCUMENT, EXCEPTION_MESSAGE_KEY_NULL_SELECT_EXPRESSION, EXCEPTION_MESSAGE_KEY_UNKNOWN_COLUMN_NAME, EXCEPTION_MESSAGE_KEY_UNKNOWN_NUMBER_TYPE

Constructor Summary

Constructors

Constructor	Description
AbstractPoiXlsDataSource(File file)	Creates a data source instance from an XLSX or XLS file.
AbstractPoiXlsDataSource(InputStream is)	Creates a data source instance from an XLSX or XLS data input stream.
AbstractPoiXlsDataSource(InputStream is, boolean closeInputStream)	Creates a data source instance from an XLSX or XLS data input stream.
AbstractPoiXlsDataSource(String location)
AbstractPoiXlsDataSource(JasperReportsContext jasperReportsContext, String location)	Creates a data source instance that reads XLSX or XLS data from a given location.
AbstractPoiXlsDataSource(RepositoryContext context, String location)
AbstractPoiXlsDataSource(org.apache.poi.ss.usermodel.Workbook workbook)	Creates a data source instance from a workbook.

Method Summary

Modifier and Type	Method	Description
protected void	checkReadStarted()
void	close()	Closes the reader.
String	getFieldFormatPattern(JRField jrField)
Object	getFieldValue(JRField jrField)
String	getStringFieldValue(JRField jrField)
protected abstract org.apache.poi.ss.usermodel.Workbook	loadWorkbook(InputStream is)
void	moveFirst()
boolean	next()

Methods inherited from class net.sf.jasperreports.engine.data.AbstractXlsDataSource

getColumnIndex, getColumnNames, getDateFormat, getNumberFormat, getSheetSelection, setColumnIndexes, setColumnNames, setColumnNames, setDateFormat, setNumberFormat, setSheetSelection, setUseFirstRowAsHeader

Methods inherited from class net.sf.jasperreports.engine.data.JRAbstractTextDataSource

convertNumber, convertStringValue, getConvertBean, getDatePattern, getLocale, getNumberPattern, getTextAttributes, getTimeZone, setDatePattern, setLocale, setLocale, setNumberPattern, setTextAttributes, setTextAttributes, setTimeZone, setTimeZone

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(org.apache.poi.ss.usermodel.Workbook workbook)

Creates a data source instance from a workbook.

Parameters:

workbook - the workbook

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(InputStream is)
                         throws JRException,
IOException

Creates a data source instance from an XLSX or XLS data input stream.

Parameters:

is - an input stream containing XLSX or XLS data

Throws:

JRException

IOException

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(InputStream is,
 boolean closeInputStream)
                         throws JRException,
IOException

Creates a data source instance from an XLSX or XLS data input stream.

Parameters:

is - an input stream containing XLSX or XLS data

Throws:

JRException

IOException

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(File file)
                         throws JRException,
IOException

Creates a data source instance from an XLSX or XLS file.

Parameters:

file - a file containing XLSX or XLS data

Throws:

JRException

IOException

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(JasperReportsContext jasperReportsContext,
 String location)
                         throws JRException,
IOException

Creates a data source instance that reads XLSX or XLS data from a given location.

Parameters:

jasperReportsContext - the JasperReportsContext

location - a String representing XLSX or XLS data source

Throws:

IOException

JRException

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(RepositoryContext context,
 String location)
                         throws JRException,
IOException

Throws:

JRException

IOException

AbstractPoiXlsDataSource

public AbstractPoiXlsDataSource(String location)
                         throws JRException,
IOException

Throws:

JRException

IOException

See Also:

• AbstractPoiXlsDataSource(JasperReportsContext, String)

Method Details

loadWorkbook

protected abstract org.apache.poi.ss.usermodel.Workbook loadWorkbook(InputStream is)
                                                              throws IOException

Throws:

IOException

next

public boolean next()
             throws JRException

Throws:

JRException

moveFirst

public void moveFirst()

getFieldValue

public Object getFieldValue(JRField jrField)
                     throws JRException

Throws:

JRException

close

public void close()

Closes the reader. Users of this data source should close it after usage.

Specified by:

close in class AbstractXlsDataSource

checkReadStarted

protected void checkReadStarted()

Specified by:

checkReadStarted in class AbstractXlsDataSource

getStringFieldValue

public String getStringFieldValue(JRField jrField)
                           throws JRException

Throws:

JRException

getFieldFormatPattern

public String getFieldFormatPattern(JRField jrField)
                             throws JRException

Throws:

JRException