Klasse BaseDataFactory

java.lang.Object
com.inet.report.database.BaseDataFactory
Alle implementierten Schnittstellen:
DataFactory, Serializable
Bekannte direkte Unterklassen:
JdbcData
public abstract class BaseDataFactory extends Object implements DataFactory
Abstract base implementation of the DataFactory.
Siehe auch:

  • Konstruktordetails

    • BaseDataFactory

      protected BaseDataFactory()
      Create a new instance. The configuration receive a default value.
      Seit:
      13.1

  • Methodendetails

    • getReportDataPerInstance

      public boolean getReportDataPerInstance()
      Override this method only if you use subreport(s) and you set the data for the report with the getReportData or DataFactory.fetchData(Engine, FetchTables, DataCollector) method. For more information please refer to the sample Main_and_Subreport_Data_WithExternalResultSet.java.
      With this method you can specify whether the engine should call getReportData per subreport instance or only once for each of the subreports in the executed report. The same subreport can execute multiple time in a report with different parameters depending on its location. A subreport instance means one execution of one subreport. The method should return true if you want to set the different report data depending on the state of the report or if you want to set data depending on one or more parameter values. If you want to set data only once per sub-report, this function must return false. For example if you have a sub-report taking one prompt p0, and getReportDataPerInstance() returns true, then your sub-report will be called $n$ times whenever the value for p0 has been changed. So if your report has sub-reports and your sub-report prompts are linked with fields of the main report and you want to set the data whenever the sub-report prompts change, let getReportDataPerInstance() return true.
      Angegeben von:
      getReportDataPerInstance in Schnittstelle DataFactory
      Gibt zurück:
      true if the engine should invoke getReportData for every subreport instance or false otherwise.

    • getConfiguration

      public com.inet.report.DatabaseConfiguration getConfiguration()
      Returns the DatabaseConfiguration of this DataFactory.
      Angegeben von:
      getConfiguration in Schnittstelle DataFactory
      Gibt zurück:
      the DatabaseConfiguration

    • setConfiguration

      public void setConfiguration(@Nonnull com.inet.report.DatabaseConfiguration configuration)
      Sets the DatabaseConfiguration for this DataFactory. this is calling from the runtime after creating.
      Angegeben von:
      setConfiguration in Schnittstelle DataFactory
      Parameter:
      configuration - the current configuration

    • getTableSourceData

      public TableData getTableSourceData(@Nonnull TableSource ts) throws ReportException
      Is called from getReportData to request the data of a single TableSource if the TableSource is not a joined table or view. So it's called for procedures, commands and single tables or views.

      If you have define a column of type DatabaseMetaData.procedureColumnIn then you can get the current value with: 

      Object value = ts.getInputParameters().get(x).getValue();
      This required that getReportDataPerInstance() must return true.
      Angegeben von:
      getTableSourceData in Schnittstelle DataFactory
      Parameter:
      ts - The current table source
      Gibt zurück:
      The resulting data, never null.
      Löst aus:
      ReportException - if error occurs in the API access

    • getTableSourceData

      protected TableData getTableSourceData(@Nonnull TableSource ts, @Nonnull List<DatabaseField> columns) throws ReportException
      Is called from getTableSourceData to request the data of a single TableSource if the TableSource is not a joined table or view. So it's called for procedures, commands and single tables or views.
      NOTE: You'll have to override either this method or getTableSourceData(TableSource) - the default implementation of this method will always throw a ReportException
      Parameter:
      ts - the table source to get the data for
      columns - the columns of the table source to get the data for
      Gibt zurück:
      the resulting data, never null
      Löst aus:
      ReportException - in case an error occurs during the API access or if this method is not implemented
      Seit:
      15.1

    • getColumns

      public @Nonnull List<ColumnInfo> getColumns(@Nonnull TableSource ts) throws ReportException
      Returns the column information for a TableSource.

      If you want return parameter columns with type DatabaseMetaData.procedureColumnIn then DataFactory.getReportDataPerInstance() must return true and the TableSourceInfo must of type TableSourceInfo.TYPE_SPROC.

      Angegeben von:
      getColumns in Schnittstelle DataFactory
      Parameter:
      ts - the table source to get the data for
      Gibt zurück:
      A list with column information, can be empty but not null
      Löst aus:
      ReportException - if any error occurs

    • getColumns

      protected @Nonnull List<ColumnInfo> getColumns(@Nonnull Datasource datasource, String catalog, String schema, String name, int type) throws ReportException
      Returns the column information for a TableSource
      Parameter:
      datasource - The Datasource containing the Connection.
      catalog - The catalog/database.
      schema - The object owner/schema or null.
      name - The object name.
      type - The type of source
      Gibt zurück:
      A list with column infos, can be empty but not null
      Löst aus:
      ReportException - if any error occurs
      Seit:
      13.0

    • fetchData

      public void fetchData(Engine engine, FetchTables fetchTables, DataCollector collector) throws ReportException
      Fetches the part of the report data for which this data factory is responsible. A description about what tables are required to fetch is given in the specified FetchTables instance. The resulting fetched data is put to the specified DataCollector during execution of this method.

      An example implementation for this method:

      for( TableSource tableSource : fetchDef.getTableSources() ) {
    TableData tableData;
    
     // retrieve data for table source "tableSource"
    tableData = [...]
    
    // deliver the data to the collector:
    collector.addUnjoinedData( tableSource, tableData );
}
      Angegeben von:
      fetchData in Schnittstelle DataFactory
      Parameter:
      engine - the engine of the report to render
      fetchTables - a model of joining table describing the data this data factory needs to deliver
      collector - the collector which receives any resulting data
      Löst aus:
      ReportException - on failures during data fetching