一般使用 Node.js 或專門使用 Total.js 建立應用程式時，高效查詢和管理資料至關重要。在本部落格中，我們將介紹如何使用 Total.js QueryBuilder 執行基本資料操作。第一部分將介紹基本概念，示範插入和檢索資料等核心操作，並展示實際範例以幫助您入門。
Total.js 的 QueryBuilder 提供了一個強大的抽象層，用於透過過濾、插入、更新和檢索資料等操作與各種資料庫進行互動。無論您是在開發輕量級應用程式還是管理複雜查詢，QueryBuilder 都為 Node.js 應用程式提供了簡單而靈活的 ORM 解決方案。
QueryBuilder 充當中間層，抽象資料庫引擎的細節。為了有效地利用它，您需要整合現有的實現或建立自己的實現以滿足您的要求。 Total.js 支援多種資料庫引擎，確保不同用例的彈性。
以下是目前可用的實作：
在本指南中，我們將從嵌入式 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 中的操作建立模式。我們將定義列出、檢索和插入使用者的操作。
在 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);
}
});
}
});
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中文網其他相關文章！
