QueryBuilder 實踐第 1 部分

一般使用 Node.js 或專門使用 Total.js 建立應用程式時，高效查詢和管理資料至關重要。在本部落格中，我們將介紹如何使用 Total.js QueryBuilder 執行基本資料操作。第一部分將介紹基本概念，示範插入和檢索資料等核心操作，並展示實際範例以幫助您入門。

入門：探索 Total.js 中的 QueryBuilder

Total.js 的 QueryBuilder 提供了一個強大的抽象層，用於透過過濾、插入、更新和檢索資料等操作與各種資料庫進行互動。無論您是在開發輕量級應用程式還是管理複雜查詢，QueryBuilder 都為 Node.js 應用程式提供了簡單而靈活的 ORM 解決方案。

資料庫支援和實施

QueryBuilder 充當中間層，抽象資料庫引擎的細節。為了有效地利用它，您需要整合現有的實現或建立自己的實現以滿足您的要求。 Total.js 支援多種資料庫引擎，確保不同用例的彈性。

以下是目前可用的實作：

• NoSQL 嵌入式資料庫 (TextDB)： 這是 Total.js 核心中包含的一個輕量級、基於檔案的資料庫，非常適合小型應用程式或原型設計。
• PostgreSQL： 將 QueryBuilder 與最強大、功能最豐富的關聯式資料庫之一結合使用。
• MySQL： 與這個廣泛使用的資料庫集成，以獲得可擴展的高效能解決方案。
• SQLite： 利用 QueryBuilder 和這個輕量級、無伺服器資料庫來快速部署或嵌入式應用程式。

設定查詢產生器

在本指南中，我們將從嵌入式 NoSQL (TextDB) 資料庫開始，示範如何定義模式並執行查詢、插入和更新資料等基本操作。最後，您將具備針對其他支援的資料庫引擎調整這些操作的技能。

設定資料庫

為了有效學習，我們將使用範例使用者資料建立一個測試 NoSQL 資料庫檔案。

資料庫設定：建立一個databases/users.nosql 檔案來儲存範例使用者記錄：

{"id": 2, "name": "Bob", "age": 30}
{"id": 3, "name": "Charlie", "age": 28}
{"id": 4, "name": "Diana", "age": 22}
{"id": 5, "name": "Edward", "age": 35}
{"id": 6, "name": "John", "age": 45}
{"id": 7, "name": "Fiona", "age": 27}
{"id": 8, "name": "George", "age": 29}
{"id": 9, "name": "Hannah", "age": 24}
{"id": 10, "name": "Isaac", "age": 31}
{"id": 11, "name": "Julia", "age": 26}

很高興知道：您不需要在資料庫資料夾中手動建立 .nosql 檔案。如果它不存在，框架能夠在插入操作期間建立它。但.nosql 文件內容是明文，了解其結構很重要。也許它對於修復某些情況會很有用。

模式定義：使用 schemas/users.js 中的操作建立模式。我們將定義列出、檢索和插入使用者的操作。

帶有實際範例的基本 QueryBuilder 操作

在 schemas/users.js 中，我們將定義列出和插入使用者的操作。此架構使用 QueryBuilder 方法來過濾資料、檢索特定記錄並為資料庫新增使用者。

1。使用過濾器列出使用者
我們首先定義一個列表操作來根據姓名或年齡等條件檢索使用者。

{"id": 2, "name": "Bob", "age": 30}
{"id": 3, "name": "Charlie", "age": 28}
{"id": 4, "name": "Diana", "age": 22}
{"id": 5, "name": "Edward", "age": 35}
{"id": 6, "name": "John", "age": 45}
{"id": 7, "name": "Fiona", "age": 27}
{"id": 8, "name": "George", "age": 29}
{"id": 9, "name": "Hannah", "age": 24}
{"id": 10, "name": "Isaac", "age": 31}
{"id": 11, "name": "Julia", "age": 26}

使用範例:

以下是使用清單過濾使用者的一些變體。

• 依名稱過濾：

NEWSCHEMA('Users', function(schema) {

    schema.action('list', {
        name: 'List users',
        query: 'page:Number, sort:String, name:String',
        params: 'id:String',
        action: async function($) {
            // Example: filter by name
            var users = await DATA.find('nosql/users').where('name', $.query.name).promise();
            $.callback(users); 
        }
    });
});

• 只檢索第一個使用者：

var users = await ACTION('Users/list').where('name', 'John').promise();
console.log(users);

2。透過 ID 檢索使用者
另一個有用的功能是透過 ID 檢索使用者。使用 QueryBuilder 的 .id() 方法使這變得簡單：

var user = await DATA.find('nosql/users').first().promise();
console.log(user);

用法範例：

var builder = DATA.find('nosql/users');
builder.id($.params.id);
// or builder.where('id', $.params.id);
$.callback(await builder.promise());

3。插入新用戶
接下來，讓我們定義一個插入操作以將新使用者新增至資料庫。

var user = await ACTION('Users/list').params({ id: 5 }).promise();
console.log(user);  // Retrieves user with id 5

此操作將使用者新增至databases/users.nosql。以下是呼叫插入操作的方法。

使用範例:

schema.action('insert', {
    name: 'Inserting new users',
    input: '*name:String, age:Number',
    output: 'success:Boolean',
    action: function($, model) {
        DATA.insert('nosql/users', model).callback(function(err) {
            if (err) {
                console.error(err);
            } else {
                $.success(true);
            }
        });
    }
});

實際使用案例：QueryBuilder 的實際應用

1。以篩選後的名稱擷取使用者

// in `definitions/test.js`
ON('ready', function() {
  var result = await ACTION('Users/insert', { name: 'Alice', age: 25 }).promise();
    console.log(result);
});

2。透過ID檢索使用者

async function getUsersByName() {
    var users = await ACTION('Users/list').query({ name: 'Hannah' }).promise();
    console.log(users);
}
getUsersByName();

3。插入新使用者並檢索更新的清單

async function getUserByID() {
    var user = await ACTION('Users/list').params({ id: 4 }).promise();
    console.log(user);
}
getUserByID();

結論

在 QueryBuilder 實際操作的第一部分中，我們介紹了基本知識：建立基本的 NoSQL 資料庫、定義架構操作以及使用 QueryBuilder 方法列出、篩選、檢索和插入使用者。我們探索了每個操作的實用程式碼範例，以幫助您了解這些概念在現實場景中的工作原理。
在下一部分中，我們將深入研究更高級的 QueryBuilder 方法和複雜的過濾，為您提供在 Total.js 中有效管理資料的完整工具包。
請繼續關注《操作第 2 部分》中的 QueryBuilder，我們將深入探討進階查詢技術來增強您的 Total.js 應用程式！

以上是QueryBuilder 實踐第 1 部分的詳細內容。更多資訊請關注PHP中文網其他相關文章！