Database System 0.1.0
Advanced C++20 Database System with Multi-Backend Support
Loading...
Searching...
No Matches
sqlite_backend.h
Go to the documentation of this file.
1// BSD 3-Clause License
2// Copyright (c) 2025, 🍀☀🌕🌥 🌊
3// See the LICENSE file in the project root for full license information.
4
20#pragma once
21
24
25#include <memory>
26#include <string>
27#include <atomic>
28#include <mutex>
29
30namespace database
31{
32namespace backends
33{
34
69 : public core::backend_base<sqlite_backend, database_types::sqlite>
70{
71public:
75 static constexpr const char* backend_name() { return "sqlite_backend"; }
76
81
85 ~sqlite_backend() override = default;
86
87 // database_backend interface implementation
88
89 kcenon::common::Result<core::database_result> select_query(const std::string& query_string) override;
90
91 kcenon::common::VoidResult execute_query(const std::string& query_string) override;
92
93 [[nodiscard]] kcenon::common::Result<core::database_result> select_prepared(
94 const std::string& query,
95 const std::vector<core::database_value>& params) override;
96
97 [[nodiscard]] kcenon::common::VoidResult execute_prepared(
98 const std::string& query,
99 const std::vector<core::database_value>& params) override;
100
101 kcenon::common::VoidResult begin_transaction() override;
102
103 kcenon::common::VoidResult commit_transaction() override;
104
105 kcenon::common::VoidResult rollback_transaction() override;
106
107 bool in_transaction() const override;
108
109 std::string last_error() const override;
110
111 std::map<std::string, std::string> connection_info() const override;
112
113protected:
115
121 kcenon::common::VoidResult do_initialize(const core::connection_config& config);
122
127 kcenon::common::VoidResult do_shutdown();
128
129private:
135 unsigned int execute_modification_query(const std::string& query_string);
136
143 core::database_value convert_sqlite_value(void* stmt, int column_index);
144
145 void* connection_{nullptr};
146 std::atomic<bool> in_transaction_{false};
147 mutable std::string last_error_;
149 mutable std::recursive_mutex sqlite_mutex_;
150};
151
152} // namespace backends
153} // namespace database
CRTP template base class for database backends.
Registry for database backend plugins.
SQLite implementation of database_backend interface.
~sqlite_backend() override=default
Destructor - ensures proper cleanup.
core::database_value convert_sqlite_value(void *stmt, int column_index)
Convert SQLite column value to database_value.
core::connection_config connection_config_
Cached connection config.
kcenon::common::VoidResult do_initialize(const core::connection_config &config)
Database-specific initialization logic.
kcenon::common::VoidResult execute_prepared(const std::string &query, const std::vector< core::database_value > &params) override
Execute a parameterized DML/DDL query (prepared statement)
kcenon::common::VoidResult rollback_transaction() override
Rollback the current transaction.
std::map< std::string, std::string > connection_info() const override
Get backend-specific connection information.
kcenon::common::VoidResult begin_transaction() override
Begin a transaction.
kcenon::common::VoidResult do_shutdown()
Database-specific shutdown logic.
unsigned int execute_modification_query(const std::string &query_string)
Execute a modification query (INSERT, UPDATE, DELETE)
kcenon::common::Result< core::database_result > select_prepared(const std::string &query, const std::vector< core::database_value > &params) override
Execute a parameterized SELECT query (prepared statement)
kcenon::common::VoidResult commit_transaction() override
Commit the current transaction.
kcenon::common::VoidResult execute_query(const std::string &query_string) override
Execute a general SQL query (DDL, DML)
bool in_transaction() const override
Check if backend is currently in a transaction.
void * connection_
SQLite connection (sqlite3*)
std::string last_error() const override
Get last error message from backend.
kcenon::common::Result< core::database_result > select_query(const std::string &query_string) override
Execute a SELECT query.
static constexpr const char * backend_name()
Backend name for error messages.
std::string last_error_
Last error message.
std::recursive_mutex sqlite_mutex_
Mutex for thread safety.
std::atomic< bool > in_transaction_
Transaction state.
CRTP template base class for database backends.
std::variant< std::string, int64_t, double, bool, std::nullptr_t > database_value
database_types
Represents various database backends or modes.
@ sqlite
Indicates a SQLite database.
Configuration for database connection.