Java event handlers for a data set element
BIRT fires five events for the DataSet element. A Java class to handle these events must implement the IDataSetEventHandler interface or extend the DataSetAdapter class. All DataSet event handler methods receive an IReportContext object. Additionally, all DataSet event handler methods except the afterClose( ) method receive an IDataSetInstance object. The onFetch( ) method receives a third object, an IDataSetRow object. Table 38‑3 lists the methods that you can implement for a DataSet element.
Table 38‑3 Data set event handler methods
Method
Description
beforeOpen( IDataSetInstance dataSet, IReportContext reportContext )
Called immediately before opening the data set. This event handler is often used to change the query text for a data set.
afterOpen( IDataSetInstance dataSet, IReportContext reportContext )
Called immediately after opening the data set.
onFetch( IDataSetInstance dataSet, IDataSetRow row, IReportContext reportContext )
Called upon fetching each row from the data source.
beforeClose( IDataSetInstance dataSet, IReportContext reportContext )
Called immediately before closing the data set.
afterClose( IReportContext reportContext )
Called immediately after closing the data set.