Package dev.roanh.gmark.query

Class QueryGenerator

java.lang.Object

dev.roanh.gmark.query.QueryGenerator

public final class QueryGenerator
extends Object

Utility class for generation queries for workloads.

See Also:

• Workload

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	QueryGenerator.ProgressListener	Interfaces for objects that want to listen to the progress of a query generation task.

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	ERROR_BOUND	Maximum number of times to try to generate a query before giving up and throwing a generation exception.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	QueryGenerator()	Prevent instantiation.

Method Summary

Modifier and Type	Method	Description
static QuerySet	generateQueries(Workload workload)	Generates a complete workload consisting of the number of queries defined in the given workload configuration and all conforming to the given workload specification.
static QuerySet	generateQueries(Workload workload, int n, QueryGenerator.ProgressListener listener)	Generates a workload of the given number of queries conforming to the given workload specification.
static QuerySet	generateQueries(Workload workload, QueryGenerator.ProgressListener listener)	Generates a complete workload consisting of the number of queries defined in the given workload configuration and all conforming to the given workload specification.
static Query	generateQuery(Workload workload)	Generates a single query according to the given workload specification.

Methods inherited from class java.lang.Object

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

Field Details

ERROR_BOUND

private static final int ERROR_BOUND

Maximum number of times to try to generate a query before giving up and throwing a generation exception.

See Also:

• Constant Field Values

Constructor Details

QueryGenerator

private QueryGenerator()

Prevent instantiation.

Method Details

generateQuery

public static Query generateQuery(Workload workload)
                           throws GenerationException

Generates a single query according to the given workload specification.

Parameters:

workload - The workload configuration.

Returns:

The generated query.

Throws:

GenerationException - When generating the query failed.

generateQueries

public static QuerySet generateQueries(Workload workload)
                                throws GenerationException

Generates a complete workload consisting of the number of queries defined in the given workload configuration and all conforming to the given workload specification.

Parameters:

workload - The workload configuration.

Returns:

The generated queries.

Throws:

GenerationException - When generating the queries failed.

See Also:

• Workload.getSize()

generateQueries

public static QuerySet generateQueries(Workload workload,
 QueryGenerator.ProgressListener listener)
                                throws GenerationException

Generates a complete workload consisting of the number of queries defined in the given workload configuration and all conforming to the given workload specification. The given progress listener is updated with the progress of the generation task.

Parameters:

workload - The workload configuration.

listener - The progress listener to use, can be null

Returns:

The generated queries.

Throws:

GenerationException - When generating the queries failed.

See Also:

• Workload.getSize()

generateQueries

public static QuerySet generateQueries(Workload workload,
 int n,
 QueryGenerator.ProgressListener listener)
                                throws GenerationException

Generates a workload of the given number of queries conforming to the given workload specification. The given number of queries overrides the workload size as defined in the workload configuration. The given progress listener is updated with the progress of the generation task.

Parameters:

workload - The workload configuration.

n - The number of queries to generate.

listener - The progress listener to use, can be null

Returns:

The generated queries.

Throws:

GenerationException - When generating the queries failed.