de.ipcon.form.table

Class FTablePivotDataSource

java.lang.Object

com.jidesoft.pivot.TableModelPivotDataSource

de.ipcon.form.table.FTablePivotDataSource

All Implemented Interfaces:

com.jidesoft.pivot.PivotDataSource

public class FTablePivotDataSource
extends com.jidesoft.pivot.TableModelPivotDataSource

A concrete implementation of a table model pivot data source, specifically tailored for an FTableAtm.

This class retrieves data from an FTableAtm instance and presents it in a pivoted format. It is designed for efficient data access, particularly for large datasets, by using an internal caching mechanism and asynchronous prefetching of data for slow columns.

Constructor Summary

Constructors

Constructor and Description
FTablePivotDataSource(FTableAtm _atm) Constructs a new FTablePivotDataSource with the specified FTableAtm instance.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getFieldName(int idx) Returns the field name for a column at the specified index.
java.lang.Object	getValueAt(int row, int col) Retrieves the value at the specified row and column.
void	prefetch(int col) Prefetches data for a specific column asynchronously.
void	reset() Resets the internal state of the data source, particularly the column prefetching status.

Methods inherited from class com.jidesoft.pivot.TableModelPivotDataSource

addTableModelListener, applyFilters, applyFilters, clearFilters, getActualRowIndex, getFieldCount, getFieldTitle, getFieldType, getFilteredRowIndex, getPossibleValues, getRowCount, getTableModel, hasFilter, removeTableModelListener, setExcludeFilter, setFilter, setFilter, setTableModel, setValueAt

Methods inherited from class java.lang.Object

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

Constructor Detail

FTablePivotDataSource

public FTablePivotDataSource(FTableAtm _atm)

Constructs a new FTablePivotDataSource with the specified FTableAtm instance.

Parameters:

_atm - The FTableAtm to use as the data source.

Method Detail

reset

public void reset()

Resets the internal state of the data source, particularly the column prefetching status.

This method initializes the prefetchedColumns array. Columns that are not marked as "slow" are considered already prefetched, while others will be subject to future asynchronous prefetching.

getFieldName

public java.lang.String getFieldName(int idx)

Returns the field name for a column at the specified index.

This method retrieves the field name based on the column's display property. If the display property is ".", it falls back to the column's title. Otherwise, it uses the display property itself as the field name.

Specified by:

getFieldName in interface com.jidesoft.pivot.PivotDataSource

Overrides:

getFieldName in class com.jidesoft.pivot.TableModelPivotDataSource

Parameters:

idx - The index of the column.

Returns:

The field name as a String.

getValueAt

public java.lang.Object getValueAt(int row,
                                   int col)

Retrieves the value at the specified row and column.

This method first checks if the column's data has been prefetched. If not, it triggers a synchronous prefetch operation. It then retrieves the annotated value from the underlying FTableAtm and returns its raw value.

Specified by:

getValueAt in interface com.jidesoft.pivot.PivotDataSource

Overrides:

getValueAt in class com.jidesoft.pivot.TableModelPivotDataSource

Parameters:

row - The row index.

col - The column index.

Returns:

The raw value at the specified cell.

prefetch

public void prefetch(int col)

Prefetches data for a specific column asynchronously.

This method triggers an asynchronous prefetch operation for all rows in the specified column. It uses the SPU class to execute the prefetch task off the Event Dispatch Thread (EDT) and blocks until the operation is complete, ensuring that the data is ready before it is accessed.

Parameters:

col - The index of the column to prefetch.