database::testing::mock_database Class Reference

Configurable mock for database_backend interface. More...

#include <mock_database.h>

Inheritance diagram for database::testing::mock_database:

Collaboration diagram for database::testing::mock_database:

Public Member Functions
	mock_database ()
	~mock_database () override=default
	mock_database (const mock_database &)=delete
mock_database &	operator= (const mock_database &)=delete
	mock_database (mock_database &&other) noexcept
mock_database &	operator= (mock_database &&other) noexcept
database_types	type () const override
	Get the database type of this backend.
kcenon::common::VoidResult	initialize (const core::connection_config &config) override
	Initialize the database backend.
kcenon::common::VoidResult	shutdown () override
	Shutdown the database backend gracefully.
bool	is_initialized () const override
	Check if backend is initialized and ready.
kcenon::common::Result< core::database_result >	select_query (const std::string &query_string) override
	Execute a SELECT query.
kcenon::common::VoidResult	execute_query (const std::string &query_string) override
	Execute a general SQL query (DDL, DML)
kcenon::common::VoidResult	begin_transaction () override
	Begin a transaction.
kcenon::common::VoidResult	commit_transaction () override
	Commit the current transaction.
kcenon::common::VoidResult	rollback_transaction () override
	Rollback the current transaction.
bool	in_transaction () const override
	Check if backend is currently in a transaction.
std::string	last_error () const override
	Get last error message from backend.
std::map< std::string, std::string >	connection_info () const override
	Get backend-specific connection information.
mock_database &	set_database_type (database_types type)
mock_database &	set_connect_result (bool result)
mock_database &	set_default_select_result (const core::database_result &result)
mock_database &	set_default_rows_affected (uint64_t rows)
expectation_builder	expect_query (const std::string &query)
expectation_builder	expect_pattern (const std::string &regex_pattern)
expectation_builder	expect_any ()
mock_database &	simulate_connection_failure ()
mock_database &	simulate_disconnect ()
bool	verify_all_expectations () const
std::vector< std::string >	get_executed_queries () const
size_t	get_query_count () const
size_t	get_query_count (const std::string &pattern) const
void	reset ()
void	clear_expectations ()
void	clear_history ()
bool	is_connected () const
std::string	get_connection_string () const
Public Member Functions inherited from database::core::database_backend
virtual	~database_backend ()=default
virtual kcenon::common::Result< database_result >	select_prepared (const std::string &query, const std::vector< database_value > &params)
	Execute a parameterized SELECT query (prepared statement)
virtual kcenon::common::VoidResult	execute_prepared (const std::string &query, const std::vector< database_value > &params)
	Execute a parameterized DML/DDL query (prepared statement)

Private Member Functions
void	record_query (const std::string &query)
expectation *	find_expectation (const std::string &query)

Private Attributes
database_types	db_type_
bool	initialized_
bool	connect_result_
bool	in_transaction_
std::string	connection_string_
core::database_result	default_result_
uint64_t	default_rows_affected_
std::string	last_error_
std::vector< expectation >	expectations_
std::vector< std::string >	executed_queries_
std::mutex	mutex_

Friends
class	expectation_builder

Additional Inherited Members
Static Protected Member Functions inherited from database::core::database_backend
static std::string	expand_params (const std::string &query, const std::vector< database_value > &params)
	Expand positional parameters into a SQL string (fallback)

Detailed Description

Configurable mock for database_backend interface.

Features:

• Set expected queries and results
• Simulate errors and exceptions
• Record all executed queries for verification
• Pattern matching for flexible expectations

Example usage:

mock_database db;
 
// Set up expectation
db.expect_query("SELECT * FROM users")
  .will_return({{{"id", 1}, {"name", std::string("John")}}});
 
// Execute query
auto result = db.select_query("SELECT * FROM users");
 
// Verify
EXPECT_TRUE(db.verify_all_expectations());

Definition at line 41 of file mock_database.h.

Constructor & Destructor Documentation

mock_database() [1/3]

database::testing::mock_database::mock_database

(

)

Definition at line 11 of file mock_database.cpp.

    : db_type_(database_types::none)
    , initialized_(false)
    , connect_result_(true)
    , in_transaction_(false)
    , default_rows_affected_(1)
{
}

~mock_database()

database::testing::mock_database::~mock_database ( )

overridedefault

mock_database() [2/3]

database::testing::mock_database::mock_database ( const mock_database & )

delete

mock_database() [3/3]

database::testing::mock_database::mock_database ( mock_database && other )

noexcept

Definition at line 20 of file mock_database.cpp.

    : db_type_(other.db_type_)
    , initialized_(other.initialized_)
    , connect_result_(other.connect_result_)
    , in_transaction_(other.in_transaction_)
    , connection_string_(std::move(other.connection_string_))
    , default_result_(std::move(other.default_result_))
    , default_rows_affected_(other.default_rows_affected_)
    , last_error_(std::move(other.last_error_))
    , expectations_(std::move(other.expectations_))
    , executed_queries_(std::move(other.executed_queries_))
{
    other.initialized_ = false;
    other.in_transaction_ = false;
}

Member Function Documentation

begin_transaction()

kcenon::common::VoidResult database::testing::mock_database::begin_transaction ( )

overridevirtual

Begin a transaction.

Returns

VoidResult::ok() on success, error on failure

Implements database::core::database_backend.

Definition at line 111 of file mock_database.cpp.

                                                        {
    std::lock_guard<std::mutex> lock(mutex_);
    if (in_transaction_) {
        return kcenon::common::VoidResult::err(kcenon::common::error_info{"Transaction already active"});
    }
    in_transaction_ = true;
    return kcenon::common::VoidResult::ok(std::monostate{});
}

References in_transaction_, and mutex_.

clear_expectations()

void database::testing::mock_database::clear_expectations

(

)

Definition at line 235 of file mock_database.cpp.

                                       {
    std::lock_guard<std::mutex> lock(mutex_);
    expectations_.clear();
}

References expectations_, and mutex_.

clear_history()

void database::testing::mock_database::clear_history

(

)

Definition at line 240 of file mock_database.cpp.

                                  {
    std::lock_guard<std::mutex> lock(mutex_);
    executed_queries_.clear();
}

References executed_queries_, and mutex_.

commit_transaction()

kcenon::common::VoidResult database::testing::mock_database::commit_transaction ( )

overridevirtual

Commit the current transaction.

Returns

VoidResult::ok() on success, error on failure

Implements database::core::database_backend.

Definition at line 120 of file mock_database.cpp.

                                                         {
    std::lock_guard<std::mutex> lock(mutex_);
    if (!in_transaction_) {
        return kcenon::common::VoidResult::err(kcenon::common::error_info{"No active transaction"});
    }
    in_transaction_ = false;
    return kcenon::common::VoidResult::ok(std::monostate{});
}

References in_transaction_, and mutex_.

connection_info()

std::map< std::string, std::string > database::testing::mock_database::connection_info ( ) const

overridevirtual

Get backend-specific connection information.

Returns

Map of connection properties (for debugging/monitoring)

Example keys: "server_version", "connection_id", "protocol_version"

Implements database::core::database_backend.

Definition at line 146 of file mock_database.cpp.

                                                                  {
    std::map<std::string, std::string> info;
    info["connection_string"] = connection_string_;
    info["initialized"] = initialized_ ? "true" : "false";
    info["in_transaction"] = in_transaction_ ? "true" : "false";
    return info;
}

References connection_string_, in_transaction_, and initialized_.

execute_query()

kcenon::common::VoidResult database::testing::mock_database::execute_query ( const std::string & query_string )

overridevirtual

Execute a general SQL query (DDL, DML)

Parameters

query_string

SQL statement

Returns

VoidResult::ok() on success, error on failure

Implements database::core::database_backend.

Definition at line 94 of file mock_database.cpp.

                                                                                 {
    std::lock_guard<std::mutex> lock(mutex_);
    record_query(query_string);
 
    if (auto* exp = find_expectation(query_string)) {
        if (exp->should_throw()) {
            last_error_ = exp->get_error_message();
            return kcenon::common::VoidResult::err(kcenon::common::error_info{last_error_});
        }
        if (!exp->get_execute_result()) {
            last_error_ = "Query execution failed";
            return kcenon::common::VoidResult::err(kcenon::common::error_info{last_error_});
        }
    }
    return kcenon::common::VoidResult::ok(std::monostate{});
}

References find_expectation(), last_error_, mutex_, and record_query().

Here is the call graph for this function:

expect_any()

expectation_builder database::testing::mock_database::expect_any

(

)

Definition at line 186 of file mock_database.cpp.

                                              {
    expectation exp;
    exp.for_any();
    return expectation_builder(this, std::move(exp));
}

References expectation_builder, and database::testing::expectation::for_any().

Referenced by database::testing::mock_database_builder::failing_database().

Here is the call graph for this function:

Here is the caller graph for this function:

expect_pattern()

expectation_builder database::testing::mock_database::expect_pattern

(

const std::string &

regex_pattern

)

Definition at line 180 of file mock_database.cpp.

                                                                                {
    expectation exp;
    exp.for_pattern(regex_pattern);
    return expectation_builder(this, std::move(exp));
}

References expectation_builder, and database::testing::expectation::for_pattern().

Referenced by database::testing::mock_database_builder::with_data().

Here is the call graph for this function:

Here is the caller graph for this function:

expect_query()

expectation_builder database::testing::mock_database::expect_query

(

const std::string &

query

)

Definition at line 174 of file mock_database.cpp.

                                                                      {
    expectation exp;
    exp.for_query(query, match_type::EXACT);
    return expectation_builder(this, std::move(exp));
}

References database::testing::EXACT, expectation_builder, and database::testing::expectation::for_query().

Here is the call graph for this function:

find_expectation()

expectation * database::testing::mock_database::find_expectation ( const std::string & query )

private

Definition at line 257 of file mock_database.cpp.

                                                                   {
    for (auto& exp : expectations_) {
        if (exp.matches(query) && exp.can_be_invoked()) {
            return &exp;
        }
    }
    return nullptr;
}

References expectations_.

Referenced by execute_query(), and select_query().

Here is the caller graph for this function:

get_connection_string()

std::string database::testing::mock_database::get_connection_string

(

)

const

Definition at line 249 of file mock_database.cpp.

                                                     {
    return connection_string_;
}

References connection_string_.

get_executed_queries()

std::vector< std::string > database::testing::mock_database::get_executed_queries

(

)

const

Definition at line 208 of file mock_database.cpp.

                                                               {
    std::lock_guard<std::mutex> lock(mutex_);
    return executed_queries_;
}

References executed_queries_, and mutex_.

get_query_count() [1/2]

size_t database::testing::mock_database::get_query_count

(

)

const

Definition at line 213 of file mock_database.cpp.

                                            {
    std::lock_guard<std::mutex> lock(mutex_);
    return executed_queries_.size();
}

References executed_queries_, and mutex_.

get_query_count() [2/2]

size_t database::testing::mock_database::get_query_count

(

const std::string &

pattern

)

const

Definition at line 218 of file mock_database.cpp.

                                                                    {
    std::lock_guard<std::mutex> lock(mutex_);
    std::regex re(pattern);
    return std::count_if(executed_queries_.begin(), executed_queries_.end(),
                         [&re](const std::string& q) { return std::regex_search(q, re); });
}

References executed_queries_, and mutex_.

in_transaction()

bool database::testing::mock_database::in_transaction ( ) const

overridevirtual

Check if backend is currently in a transaction.

Returns

true if transaction is active

Implements database::core::database_backend.

Definition at line 138 of file mock_database.cpp.

                                         {
    return in_transaction_;
}

References in_transaction_.

initialize()

kcenon::common::VoidResult database::testing::mock_database::initialize ( const core::connection_config & config )

overridevirtual

Initialize the database backend.

Parameters

config

Connection configuration

Returns

VoidResult::ok() on success, error on failure

This method should:

• Establish database connection
• Validate connection parameters
• Set up connection pooling if applicable
• Initialize backend-specific resources

Implements database::core::database_backend.

Definition at line 58 of file mock_database.cpp.

                                                                                    {
    std::lock_guard<std::mutex> lock(mutex_);
    connection_string_ = config.host + ":" + std::to_string(config.port) + "/" + config.database;
    if (connect_result_) {
        initialized_ = true;
        return kcenon::common::VoidResult::ok(std::monostate{});
    }
    last_error_ = "Connection failed";
    return kcenon::common::VoidResult::err(kcenon::common::error_info{"Connection failed"});
}

References connect_result_, connection_string_, database::core::connection_config::database, database::core::connection_config::host, initialized_, last_error_, mutex_, and database::core::connection_config::port.

Referenced by database::testing::scoped_test_database::scoped_test_database().

Here is the caller graph for this function:

is_connected()

bool database::testing::mock_database::is_connected

(

)

const

Definition at line 245 of file mock_database.cpp.

                                       {
    return initialized_;
}

References initialized_.

is_initialized()

bool database::testing::mock_database::is_initialized ( ) const

overridevirtual

Check if backend is initialized and ready.

Returns

true if initialized and can accept queries

Implements database::core::database_backend.

Definition at line 76 of file mock_database.cpp.

                                         {
    return initialized_;
}

References initialized_.

last_error()

std::string database::testing::mock_database::last_error ( ) const

overridevirtual

Get last error message from backend.

Returns

Error message, or empty string if no error

Implements database::core::database_backend.

Definition at line 142 of file mock_database.cpp.

                                          {
    return last_error_;
}

References last_error_.

operator=() [1/2]

mock_database & database::testing::mock_database::operator= ( const mock_database & )

delete

operator=() [2/2]

mock_database & database::testing::mock_database::operator= ( mock_database && other )

noexcept

Definition at line 36 of file mock_database.cpp.

                                                                      {
    if (this != &other) {
        db_type_ = other.db_type_;
        initialized_ = other.initialized_;
        connect_result_ = other.connect_result_;
        in_transaction_ = other.in_transaction_;
        connection_string_ = std::move(other.connection_string_);
        default_result_ = std::move(other.default_result_);
        default_rows_affected_ = other.default_rows_affected_;
        last_error_ = std::move(other.last_error_);
        expectations_ = std::move(other.expectations_);
        executed_queries_ = std::move(other.executed_queries_);
        other.initialized_ = false;
        other.in_transaction_ = false;
    }
    return *this;
}

record_query()

void database::testing::mock_database::record_query ( const std::string & query )

private

Definition at line 253 of file mock_database.cpp.

                                                       {
    executed_queries_.push_back(query);
}

References executed_queries_.

Referenced by execute_query(), and select_query().

Here is the caller graph for this function:

reset()

void database::testing::mock_database::reset

(

)

Definition at line 225 of file mock_database.cpp.

                          {
    std::lock_guard<std::mutex> lock(mutex_);
    expectations_.clear();
    executed_queries_.clear();
    initialized_ = false;
    in_transaction_ = false;
    connection_string_.clear();
    last_error_.clear();
}

References connection_string_, executed_queries_, expectations_, in_transaction_, initialized_, last_error_, and mutex_.

Referenced by database::testing::scoped_test_database::~scoped_test_database().

Here is the caller graph for this function:

rollback_transaction()

kcenon::common::VoidResult database::testing::mock_database::rollback_transaction ( )

overridevirtual

Rollback the current transaction.

Returns

VoidResult::ok() on success, error on failure

Implements database::core::database_backend.

Definition at line 129 of file mock_database.cpp.

                                                           {
    std::lock_guard<std::mutex> lock(mutex_);
    if (!in_transaction_) {
        return kcenon::common::VoidResult::err(kcenon::common::error_info{"No active transaction"});
    }
    in_transaction_ = false;
    return kcenon::common::VoidResult::ok(std::monostate{});
}

References in_transaction_, and mutex_.

select_query()

kcenon::common::Result< core::database_result > database::testing::mock_database::select_query ( const std::string & query_string )

overridevirtual

Execute a SELECT query.

Parameters

query_string

SQL SELECT statement

Returns

Query results as rows, or error

Implements database::core::database_backend.

Definition at line 80 of file mock_database.cpp.

                                                                                                 {
    std::lock_guard<std::mutex> lock(mutex_);
    record_query(query_string);
 
    if (auto* exp = find_expectation(query_string)) {
        if (exp->should_throw()) {
            last_error_ = exp->get_error_message();
            return kcenon::common::Result<core::database_result>::err(kcenon::common::error_info{last_error_});
        }
        return kcenon::common::Result<core::database_result>::ok(exp->get_result());
    }
    return kcenon::common::Result<core::database_result>::ok(default_result_);
}

References default_result_, find_expectation(), last_error_, mutex_, and record_query().

Here is the call graph for this function:

set_connect_result()

mock_database & database::testing::mock_database::set_connect_result

(

bool

result

)

Definition at line 159 of file mock_database.cpp.

                                                            {
    connect_result_ = result;
    return *this;
}

References connect_result_.

set_database_type()

mock_database & database::testing::mock_database::set_database_type

(

database_types

type

)

Definition at line 154 of file mock_database.cpp.

                                                                   {
    db_type_ = type;
    return *this;
}

References db_type_, and type().

Here is the call graph for this function:

set_default_rows_affected()

mock_database & database::testing::mock_database::set_default_rows_affected

(

uint64_t

rows

)

Definition at line 169 of file mock_database.cpp.

                                                                     {
    default_rows_affected_ = rows;
    return *this;
}

References default_rows_affected_.

set_default_select_result()

mock_database & database::testing::mock_database::set_default_select_result

(

const core::database_result &

result

)

Definition at line 164 of file mock_database.cpp.

                                                                                         {
    default_result_ = result;
    return *this;
}

References default_result_.

shutdown()

kcenon::common::VoidResult database::testing::mock_database::shutdown ( )

overridevirtual

Shutdown the database backend gracefully.

Returns

VoidResult::ok() on success, error on failure

This method should:

• Close active connections
• Release connection pool resources
• Flush pending transactions
• Clean up backend-specific resources

Implements database::core::database_backend.

Definition at line 69 of file mock_database.cpp.

                                               {
    std::lock_guard<std::mutex> lock(mutex_);
    initialized_ = false;
    in_transaction_ = false;
    return kcenon::common::VoidResult::ok(std::monostate{});
}

References in_transaction_, initialized_, and mutex_.

Referenced by database::testing::scoped_test_database::~scoped_test_database().

Here is the caller graph for this function:

simulate_connection_failure()

mock_database & database::testing::mock_database::simulate_connection_failure

(

)

Definition at line 192 of file mock_database.cpp.

                                                          {
    connect_result_ = false;
    return *this;
}

References connect_result_.

simulate_disconnect()

mock_database & database::testing::mock_database::simulate_disconnect

(

)

Definition at line 197 of file mock_database.cpp.

                                                  {
    initialized_ = false;
    return *this;
}

References initialized_.

type()

database_types database::testing::mock_database::type ( ) const

overridevirtual

Get the database type of this backend.

Returns

Database type identifier

Implements database::core::database_backend.

Definition at line 54 of file mock_database.cpp.

                                         {
    return db_type_;
}

References db_type_.

Referenced by set_database_type().

Here is the caller graph for this function:

verify_all_expectations()

bool database::testing::mock_database::verify_all_expectations

(

)

const

Definition at line 202 of file mock_database.cpp.

                                                  {
    std::lock_guard<std::mutex> lock(mutex_);
    return std::all_of(expectations_.begin(), expectations_.end(),
                       [](const expectation& exp) { return exp.is_satisfied(); });
}

References expectations_, and mutex_.

Friends And Related Symbol Documentation

expectation_builder

friend class expectation_builder

friend

Definition at line 97 of file mock_database.h.

Referenced by expect_any(), expect_pattern(), and expect_query().

Member Data Documentation

connect_result_

bool database::testing::mock_database::connect_result_

private

Definition at line 101 of file mock_database.h.

Referenced by initialize(), set_connect_result(), and simulate_connection_failure().

connection_string_

std::string database::testing::mock_database::connection_string_

private

Definition at line 103 of file mock_database.h.

Referenced by connection_info(), get_connection_string(), initialize(), and reset().

db_type_

database_types database::testing::mock_database::db_type_

private

Definition at line 99 of file mock_database.h.

Referenced by set_database_type(), and type().

default_result_

core::database_result database::testing::mock_database::default_result_

private

Definition at line 104 of file mock_database.h.

Referenced by select_query(), and set_default_select_result().

default_rows_affected_

uint64_t database::testing::mock_database::default_rows_affected_

private

Definition at line 105 of file mock_database.h.

Referenced by set_default_rows_affected().

executed_queries_

std::vector<std::string> database::testing::mock_database::executed_queries_

private

Definition at line 109 of file mock_database.h.

Referenced by clear_history(), get_executed_queries(), get_query_count(), get_query_count(), record_query(), and reset().

expectations_

std::vector<expectation> database::testing::mock_database::expectations_

private

Definition at line 108 of file mock_database.h.

Referenced by clear_expectations(), find_expectation(), reset(), verify_all_expectations(), database::testing::expectation_builder::will_fail(), database::testing::expectation_builder::will_return(), database::testing::expectation_builder::will_return_rows(), and database::testing::expectation_builder::will_succeed().

in_transaction_

bool database::testing::mock_database::in_transaction_

private

Definition at line 102 of file mock_database.h.

Referenced by begin_transaction(), commit_transaction(), connection_info(), in_transaction(), reset(), rollback_transaction(), and shutdown().

initialized_

bool database::testing::mock_database::initialized_

private

Definition at line 100 of file mock_database.h.

Referenced by connection_info(), initialize(), is_connected(), is_initialized(), reset(), shutdown(), and simulate_disconnect().

last_error_

std::string database::testing::mock_database::last_error_

private

Definition at line 106 of file mock_database.h.

Referenced by execute_query(), initialize(), last_error(), reset(), and select_query().

mutex_

std::mutex database::testing::mock_database::mutex_

mutableprivate

Definition at line 110 of file mock_database.h.

Referenced by begin_transaction(), clear_expectations(), clear_history(), commit_transaction(), execute_query(), get_executed_queries(), get_query_count(), get_query_count(), initialize(), reset(), rollback_transaction(), select_query(), shutdown(), and verify_all_expectations().

---

The documentation for this class was generated from the following files:

• tests/mocks/mock_database.h
• tests/mocks/mock_database.cpp