一般使用 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。使用过滤器列出用户
我们首先定义一个列表操作来根据姓名或年龄等条件检索用户。
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);
登录后复制
- 仅检索第一个用户：
var user = await data.find('nosql/users').first().promise();
console.log(user);
登录后复制
2。通过 id 检索用户
另一个有用的功能是通过 id 检索用户。使用 querybuilder 的 .id() 方法使这变得简单：
var builder = data.find('nosql/users');
builder.id($.params.id);
// or builder.where('id', $.params.id);
$.callback(await builder.promise());
登录后复制
用法示例:
var user = await action('users/list').params({ id: 5 }).promise();
console.log(user); // retrieves user with id 5
登录后复制
3。插入新用户
接下来，让我们定义一个插入操作以将新用户添加到数据库中。
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);
}
});
}
});
登录后复制
此操作将用户添加到databases/users.nosql。以下是调用插入操作的方法。
使用示例：
// in `definitions/test.js`
on('ready', function() {
var result = await action('users/insert', { name: 'alice', age: 25 }).promise();
console.log(result);
});
登录后复制
实际使用案例：querybuilder 的实际应用
1。按过滤后的名称检索用户
async function getusersbyname() {
var users = await action('users/list').query({ name: 'hannah' }).promise();
console.log(users);
}
getusersbyname();
登录后复制
2。通过id检索用户
async function getuserbyid() {
var user = await action('users/list').params({ id: 4 }).promise();
console.log(user);
}
getuserbyid();
登录后复制
3。插入新用户并检索更新的列表
async function insertAndRetrieve() {
await ACTION('Users/insert', { name: 'James', age: 32 }).promise();
var users = await ACTION('Users/list').promise();
console.log(users);
}
insertAndRetrieve();
登录后复制
结论
在 querybuilder 实际操作的第一部分中，我们介绍了基本知识：创建基本的 nosql 数据库、定义架构操作以及使用 querybuilder 方法列出、筛选、检索和插入用户。我们探索了每个操作的实用代码示例，以帮助您了解这些概念在现实场景中的工作原理。
在下一部分中，我们将深入研究更高级的 querybuilder 方法和复杂的过滤，为您提供在 total.js 中有效管理数据的完整工具包。
请继续关注《操作第 2 部分》中的 querybuilder，我们将深入探讨高级查询技术来增强您的 total.js 应用程序！
以上就是QueryBuilder 实践第 1 部分的详细内容，更多请关注其它相关文章！
