Package net.bugreaper.modules.db

Class MariaDb

java.lang.Object

net.bugreaper.modules.db.jdbc.JdbcExecutor<MariaDb>

net.bugreaper.modules.db.MariaDb

All Implemented Interfaces:

SqlConfig<MariaDb>, SqlGet, SqlPost

public class MariaDb
extends JdbcExecutor<MariaDb>

MariaDb helper that provides a common API for operating with MariaDb.

It is recommended to use a single instance: MariaDb db = MariaDb.getInstance();

Provides:

• Assertions with await support
• Data manipulation operations such as create, update, and clean

For more information, see JdbcExecutor.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	COUNT
protected String	getColumnsQuery
protected JdbcDirectivesHikari	jdbc
protected String	password
protected static final String	SELECT_ALL
protected String	url
protected String	username

Constructor Summary

Constructors

Constructor	Description
MariaDb()	Constructs a MariaDB client using YAML configuration.
MariaDb(String dbUrl, String username, String passwd)	Creates a new MariaDb database helper instance with the specified connection parameters.

Method Summary

Modifier and Type	Method	Description
protected void	assertCountInTableBuilder(String tableName, String conditions, Object[][] conditionsArray, String expectedCount, int awaitMs)
static MariaDb	getInstance()	Returns the instance of MariaDb with config builder MariaDb().
protected String[]	getTableColumns(String tableName)	Returns the list of columns in the table.
protected void	recordExistsBuilder(String tableName, String conditions, Object[][] conditionsArray, int awaitMs)
protected void	seeInDbByCondMethod(String tableName, String conditions)
protected void	showDataFromTableMethod(String tableName)

Methods inherited from class net.bugreaper.modules.db.jdbc.JdbcExecutor

deleteFromTable, deleteFromTable, deleteFromTable, getConfigSummary, insertIntoTable, insertIntoTable, insertIntoTable, renameTable, rollbackTable, runScript, runScriptFromFile, seeRecordExistsInTable, seeRecordExistsInTable, seeRecordExistsInTableCustom, seeRowsCountInTableExactly, seeRowsCountInTableExactly, seeRowsCountInTableExactly, seeRowsCountInTableExactlyCustom, seeTableIsEmpty, seeTableIsNotEmpty, self, setAwaitMs, setTemplatesDirectory, showDataByCondition, showDataFromTable, truncateTable, truncateTables, updateTable, updateTable, updateTable, withAwaitMs

Methods inherited from class java.lang.Object

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

Field Details

jdbc

protected JdbcDirectivesHikari jdbc

getColumnsQuery

protected String getColumnsQuery

url

protected String url

username

protected String username

password

protected String password

SELECT_ALL

protected static final String SELECT_ALL

See Also:

• Constant Field Values

COUNT

protected static final String COUNT

See Also:

• Constant Field Values

Constructor Details

MariaDb

public MariaDb(String dbUrl,
 String username,
 String passwd)

Creates a new MariaDb database helper instance with the specified connection parameters.

Parameters:

dbUrl - the JDBC connection URL for the MariaDb database

username - the username used to authenticate with the database

passwd - the password used to authenticate with the database

Throws:

IllegalArgumentException - if any of the required parameters are null or empty

MariaDb

public MariaDb()

Constructs a MariaDB client using YAML configuration.

Loads configuration values from a YAML file.

Example:

MariaDb db = new MariaDb();

 mariadb:
   url: 'jdbc:mariadb://localhost:3308'
   username: user
   password: pass
   await: 1000 (optional)
 

See Also:

• JdbcExecutor

Method Details

getInstance

public static MariaDb getInstance()

Returns the instance of MariaDb with config builder MariaDb().

This implementation is thread-safe using method-level synchronization.

Returns:

the shared instance of MariaDb

Throws:

IllegalArgumentException - if the configuration contains invalid values

See Also:

• config setup

assertCountInTableBuilder

@Step("(DB)[ASSERT] Table: \'{tableName}\' contains EXACTLY <{expectedCount}> record/s {conditions}")
protected void assertCountInTableBuilder(String tableName,
 String conditions,
 @Param(mode=HIDDEN)
 Object[][] conditionsArray,
 String expectedCount,
 @Param(mode=HIDDEN)
 int awaitMs)

recordExistsBuilder

@Step("(DB)[ASSERT] Table \'{tableName}\' contains records {conditions}")
protected void recordExistsBuilder(String tableName,
 String conditions,
 @Param(mode=HIDDEN)
 Object[][] conditionsArray,
 @Param(mode=HIDDEN)
 int awaitMs)

showDataFromTableMethod

protected void showDataFromTableMethod(String tableName)

seeInDbByCondMethod

@Step("(DB) Show data from table \'{tableName}\' {conditions}")
protected void seeInDbByCondMethod(String tableName,
 String conditions)

getTableColumns

protected String[] getTableColumns(String tableName)

Returns the list of columns in the table.

Parameters:

tableName - table name in the format schema_name.table_name

Returns:

array containing column names