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中文网其他相关文章！