us.abstracta.jmeter.javadsl.jdbc

Class JdbcJmeterDsl

java.lang.Object

us.abstracta.jmeter.javadsl.jdbc.JdbcJmeterDsl

public class JdbcJmeterDsl
extends Object

Includes builder methods for JDBC test elements which allow interacting with databases.

Since:

0.38

Method Summary

Modifier and Type	Method and Description
static DslJdbcConnectionPool	jdbcConnectionPool(String name, Class<? extends Driver> driverClass, String url) Builds a JDBC connection pool which is used by other test elements to interact with a database.
static DslJdbcSampler	jdbcSampler(String poolName, String query) Builds a JDBC sampler which allows interacting with a database (sending queries) through JDBC.
static DslJdbcSampler	jdbcSampler(String name, String poolName, String query) Is the same as jdbcSampler(String, String) but allowing to set a name to the sampler for easy identification in collected statistics and metrics.

Methods inherited from class java.lang.Object

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

Method Detail

jdbcConnectionPool

public static DslJdbcConnectionPool jdbcConnectionPool(String name,
                                                       Class<? extends Driver> driverClass,
                                                       String url)

Builds a JDBC connection pool which is used by other test elements to interact with a database.

Parameters:

name - is the name assigned to the pool, and used by other test elements to use the configured pool. This name should be unique for the pool, and is directly tied to a JMeter thread variable

driverClass - specifies the JDBC Driver class, specific for the particular database to connect to. To specify a proper value, you will need to add the JDBC implementation jar library for the specific database in the classpath (as project test dependency).

url - the connection string used to connect to the database through the JDBC driver. This URL could include additional connection properties that may be required for the database (for example, specifying a default encoding).

Returns:

the DslJdbcConnectionPool instance that can be further customized though fluent API or added to a test plan.

See Also:

DslJdbcConnectionPool

jdbcSampler

public static DslJdbcSampler jdbcSampler(String poolName,
                                         String query)

Builds a JDBC sampler which allows interacting with a database (sending queries) through JDBC.

Parameters:

poolName - is a name of a previously defined jdbcConnectionPool(String, Class, String), and specifies which connection pool to use to interact with the database.

query - specifies the query string (it might be a prepared statement string) to send to the database. You can pass null value when using DslJdbcSampler.autoCommit(boolean), DslJdbcSampler.commit() and DslJdbcSampler.rollback() methods.

Returns:

the DslJdbcSampler instance for further configuration or usage in test plan.

See Also:

jdbcConnectionPool(String, Class, String), DslJdbcSampler

jdbcSampler

public static DslJdbcSampler jdbcSampler(String name,
                                         String poolName,
                                         String query)

Is the same as jdbcSampler(String, String) but allowing to set a name to the sampler for easy identification in collected statistics and metrics.

Parameters:

name - specifies the name to assign to the sampler.

poolName - is a name of a previously defined jdbcConnectionPool(String, Class, String), and specifies which connection pool to use to interact with the database.

query - specifies the query string (it might be a prepared statement string) to send to the database. You can pass null value when using DslJdbcSampler.autoCommit(boolean), DslJdbcSampler.commit() and DslJdbcSampler.rollback() methods.

Returns:

DslJdbcSampler