LibSQL: Database layer

This patch implements the beginnings of a database API allowing for the creation of tables, inserting rows in those tables, and retrieving those rows.
Author: https://github.com/JanDeVisser Commit: 87bd69559f Pull-request: https://github.com/SerenityOS/serenity/pull/7483 Reviewed-by: https://github.com/trflynn89 ✅
2025-06-10 18:10:56 +09:00 · 2021-06-17 14:12:46 -04:00 · 2021-06-17 14:12:46 -04:00 · 87bd69559f · 2024-07-18 12:00:34 +09:00
commit 87bd69559f
parent 267eb3b329
7 changed files with 511 additions and 0 deletions
--- a/Userland/Libraries/LibSQL/Database.h
+++ b/Userland/Libraries/LibSQL/Database.h
@ -0,0 +1,54 @@
+/*
+ * Copyright (c) 2021, Jan de Visser <jan@de-visser.net>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/RefPtr.h>
+#include <AK/String.h>
+#include <LibCore/Object.h>
+#include <LibSQL/Forward.h>
+#include <LibSQL/Heap.h>
+
+namespace SQL {
+
+/**
+ * A Database object logically connects a Heap with the SQL data we want
+ * to store in it. It has BTree pointers for B-Trees holding the definitions
+ * of tables, columns, indexes, and other SQL objects.
+ */
+class Database : public Core::Object {
+    C_OBJECT(Database);
+
+public:
+    explicit Database(String);
+    ~Database() override = default;
+
+    void commit() { m_heap->flush(); }
+
+    void add_schema(SchemaDef const&);
+    static Key get_schema_key(String const&);
+    RefPtr<SchemaDef> get_schema(String const&);
+
+    void add_table(TableDef& table);
+    static Key get_table_key(String const&, String const&);
+    RefPtr<TableDef> get_table(String const&, String const&);
+
+    Vector<Row> select_all(TableDef const&);
+    Vector<Row> match(TableDef const&, Key const&);
+    bool insert(Row&);
+    bool update(Row&);
+
+private:
+    RefPtr<Heap> m_heap;
+    RefPtr<BTree> m_schemas;
+    RefPtr<BTree> m_tables;
+    RefPtr<BTree> m_table_columns;
+
+    HashMap<u32, RefPtr<SchemaDef>> m_schema_cache;
+    HashMap<u32, RefPtr<TableDef>> m_table_cache;
+};
+
+}