com.tibco.patterns.qbp

Class QueryRunner

java.lang.Object

com.tibco.patterns.qbp.QueryRunner

public class QueryRunner
extends java.lang.Object

Run a set of queries using a compound query builder. A configuration file is used to define a source of data for the queries and a target TIBCO Patterns - Search server for the queries. Query data can be read from a set of one or more CSV files, or from a TIBCO Patterns - Search server. If reading data from CSV files they must be in a format compatible with NetricsCompoundReader. Queries are generated using an ANetricsCompoundQueryBuilder object passed into the QueryRunner. The input data format is taken from the table structure defined in the ANetricsCompountQueryBuilder. The query runner configuration supports mapping input and output table names and field names. See the RunQuery.xsd schema for an explanation of the query run configuration options.

This class is used by the main of the GeneralCompoundQueryBuilder class to implement the run query option. It may also be used by outside applications to implement similar functionality.

Constructor Summary

Constructors

Constructor and Description
QueryRunner(java.io.File run_config_file, com.netrics.likeit.ANetricsCompoundQueryBuilder our_builder, AQBPLogger run_logger) Create a query runner from a configuration file.

Method Summary

Modifier and Type	Method and Description
boolean	run() Run the set of queries for this query runner.

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryRunner

public QueryRunner(java.io.File run_config_file,
                   com.netrics.likeit.ANetricsCompoundQueryBuilder our_builder,
                   AQBPLogger run_logger)
            throws java.lang.IllegalArgumentException,
                   AQBPLogger.QBPException

Create a query runner from a configuration file. This creates a query runner from a query runner configuration file. It validates the configuration file against the query builder it is given. All errors in the configuration are logged to the given logger as errors, not configuration errors (as this is not a query builder configuration). If any configuration errors are found a AQBPLogger.QBPException is thrown.

Parameters:

run_config_file - the configuration for the query run.

our_builder - the query builder to be used to construct the queries.

run_logger - logger for reporting errors.

Throws:

java.lang.IllegalArgumentException - if run_logger is null.

AQBPLogger.QBPException - for all other errors.

Method Detail

run

public boolean run()
            throws AQBPLogger.QBPException

Run the set of queries for this query runner. The query records are scanned only once. This method picks up where the previous call to run left off. If a previous run completed, subsequent calls to this method produce no queries.

Returns:

true if all source records were processed successfully, false if there were any errors in the query processing.

Throws:

AQBPLogger.QBPException - on unrecoverable errors, or any error if the logger for this runner is in exception mode.