Package net.sf.jasperreports.engine.data

Class JRBeanArrayDataSource

java.lang.Object

net.sf.jasperreports.engine.data.JRAbstractBeanDataSource

net.sf.jasperreports.engine.data.JRBeanArrayDataSource

All Implemented Interfaces:

JRDataSource, JRRewindableDataSource

public class JRBeanArrayDataSource
extends JRAbstractBeanDataSource

A data source implementation that wraps an array of JavaBean objects.

It is common to access application data through object persistence layers like EJB, Hibernate, or JDO. Such applications may need to generate reports using data they already have available as arrays or collections of in-memory JavaBean objects.

This JavaBean-compliant data source can be used when data comes in an array of JavaBean objects.

Author:

Teodor Danciu (teodord@users.sourceforge.net)

Nested Class Summary

Nested classes/interfaces inherited from class net.sf.jasperreports.engine.data.JRAbstractBeanDataSource

JRAbstractBeanDataSource.DefaultPropertyNameProvider, JRAbstractBeanDataSource.PropertyNameProvider

Field Summary

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

CURRENT_BEAN_MAPPING, EXCEPTION_MESSAGE_KEY_BEAN_FIELD_VALUE_NOT_RETRIEVED, PROPERTY_JAVABEAN_FIELD_PROPERTY, propertyNameProvider

Constructor Summary

Constructors

Constructor	Description
JRBeanArrayDataSource(Object[] beanArray)
JRBeanArrayDataSource(Object[] beanArray, boolean isUseFieldDescription)

Method Summary

Modifier and Type	Method	Description
JRBeanArrayDataSource	cloneDataSource()	Clones this data source by creating a new instance that reuses the same underlying bean array.
Object[]	getData()	Returns the underlying bean array used by this data source.
Object	getFieldValue(JRField field)	Gets the field value for the current position.
int	getRecordCount()	Returns the total number of records/beans that this data source contains.
void	moveFirst()	Moves back to the first element in the data source.
boolean	next()	Tries to position the cursor on the next element in the data source.

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

getBeanProperty, getFieldValue, getPropertyName, isCurrentBeanMapping

Methods inherited from class java.lang.Object

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

Constructor Details

JRBeanArrayDataSource

public JRBeanArrayDataSource(Object[] beanArray)

JRBeanArrayDataSource

public JRBeanArrayDataSource(Object[] beanArray,
 boolean isUseFieldDescription)

Method Details

next

public boolean next()

Description copied from interface: JRDataSource

Tries to position the cursor on the next element in the data source.

Returns:

true if there is a next record, false otherwise

getFieldValue

public Object getFieldValue(JRField field)
                     throws JRException

Description copied from interface: JRDataSource

Gets the field value for the current position.

Returns:

an object containing the field value. The object type must be the field object type.

Throws:

JRException

moveFirst

public void moveFirst()

Description copied from interface: JRRewindableDataSource

Moves back to the first element in the data source.

getData

public Object[] getData()

Returns the underlying bean array used by this data source.

Returns:

the underlying bean array

getRecordCount

public int getRecordCount()

Returns the total number of records/beans that this data source contains.

Returns:

the total number of records of this data source

cloneDataSource

public JRBeanArrayDataSource cloneDataSource()

Clones this data source by creating a new instance that reuses the same underlying bean array.

Returns:

a clone of this data source