de.espirit.firstspirit.webedit.plugin.report

Interface ReportPluginProvider<T>

Type Parameters:

T - The type of handled objects.

public interface ReportPluginProvider<T>

Provides objects for display within a report plug-in's results list.

Providers must implement functionality to support incremental result lists in order to enable dynamic result loading during continuous scrolling operations:

• Whenever the report is first displayed or its filter parameters are changed by the user (requiring the generation of a completely new result list), a new object of this data provider class is instantiated; WebClient will then call start() first to allow for setup of local fields that will be used in subsequent calls of other methods, e.g. getNext() or isRunning().
• Between filter configuration changes, the current object instance of this class is persisted; WebClient will repeatedly call getNext() and isRunning() in order to obtain incremental batches of result objects and to check if any further results that haven't yet been returned in those incremental batches are available, respectively.

Since:

5.0.103

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closure method; called if the report provider is no longer needed.
List<T>	getNext(int count) Returns an incremental result set of objects, potentially using start()'s parameter input as a filter configuration to limit the result set to match certain criteria.
int	getTotal() Returns the total number of results that are available for display in the report's results list (based on the current filter parameters) or -1 if the object-providing process is still running.
boolean	isRunning() Return the running state of this object.
void	start(ParameterMap parameter) Initialization; called before any other methods.

Method Detail

start

void start(ParameterMap parameter)

Initialization; called before any other methods. Typically used to start the object-providing process when the report is first displayed and when the filter configuration is changed.

Parameters:

parameter - Report parameter values (see WebeditReportPlugin).

Since:

5.0.103

getNext

List<T> getNext(int count)

Returns an incremental result set of objects, potentially using start()'s parameter input as a filter configuration to limit the result set to match certain criteria. The list should not contain more than the specified count of entries and not include duplicates of the same object in result lists during repeated calls of this method during the lifetime of this object.

Parameters:

count - The requested count of elements.

Returns:

A List of further objects that WebClient should include in the report's display.

Since:

5.0.103

isRunning

boolean isRunning()

Return the running state of this object. If getNext() has not yet returned all results that are available (based on whichever criteria), the provider should be considered running in order to communicate to WebClient that more results are available on-demand. If no further results can be returned by getNext(), the provider should be considered stopped (isRunning() returns false) and remain that way for the remainder of the object's lifetime.

Returns:

true if this provider is still running and can provide more results; otherwise false.

Since:

5.0.103

getTotal

int getTotal()

Returns the total number of results that are available for display in the report's results list (based on the current filter parameters) or -1 if the object-providing process is still running.

Returns:

Total number of elements or -1 while the object-providing process is running.

Since:

5.0.103

close

void close()

Closure method; called if the report provider is no longer needed. Cleans up resources and stops object-providing processes.

Since:

5.0.103