我要评论mormot2 获取数据集
其实在前面想学习mormot1部分已经收集了很多关于crud的示例了，但感觉总是不通透，不能很好使用，一则mormot函数命令规则比较不同寻常，另外确实示例太少，其实代码注释倒是讲了很多。
procedure fillprepare(table: tormtable; achecktablename: tormchecktablename = ctnnocheck); overload;
fillprepare 程序是为了从 tormtable 结果中准备获取值。
- 在准备之后，你可以调用
fillrow(1..table.rowcount)来获取任何一行的值。 - 或者，你也可以使用以下循环来遍历所有行：
while rec.fillone do dosomethingwith(rec);
- 在这个过程中，指定的
tormtable被存储在一个受保护的内部字段ftable中。 - 如果你想获取表中的字段名，可以设置
achecktablename参数。在匹配到当前记录之前，任何待处理的'tablename.'前缀都将被去除。
注意：这里的 dosomethingwith(rec); 是一个占位符，代表你可以对每一行记录 rec 执行某些操作。实际使用时，你需要将其替换为具体的业务逻辑代码。同时，rec 应该是一个已经定义好的记录类型变量，用于存储从 tormtable 中获取的数据。
另外，tormchecktablename 是一个枚举类型，ctnnocheck 是它的一个值，表示不进行表名检查。如果你需要检查表名，可以传递其他相应的枚举值给 achecktablename 参数。
function fillprepare(const aclient: irestorm; const asqlwhere: rawutf8 = ''; const fieldscsv: rawutf8 = ''; achecktablename: tormchecktablename = ctnnocheck): boolean; overload;
fillprepare 函数用于从 sql where 语句中获取值。
- 如果 sql 请求成功，则返回 true，如果在 sql 请求期间发生错误，则返回 false。
- 准备完成后，你可以通过调用
fillrow(1..table.rowcount)来获取任何一行的值。 - 或者，你也可以使用以下循环来遍历所有行：
while rec.fillone do dosomethingwith(rec);
- 函数会创建一个临时的
tormtable，并将其存储在一个受保护的内部字段ftable中。 - 如果
asqlwhere留空（''），则会尽快检索所有行（例如，通过绕过外部数据库的 sqlite3 虚拟表模块）。 - where 子句应使用内联参数（如
'name=:('arnaud'):'）以提高服务器速度。请注意，你可以像这样使用formatutf8()：
arec.fillprepare(client, formatutf8('salary>? and salary<?', [], [1000, 2000]));
或者直接使用带有 boundssqlwhere 参数数组的 fillprepare() 方法的重载版本。
fieldscsv可用于指定必须检索哪些字段。- 默认的
fieldscsv=''将检索所有简单的表字段，但如果你只需要访问一个或多个字段，并希望节省远程带宽，可以通过指定所需字段来实现。 - 如果
fieldscsv='*'，它将检索所有字段，包括 blobs。 - 请注意，如果你想稍后更新检索到的记录内容，则不应使用此可选的
fieldscsv参数，因为任何缺失的字段都将保留先前的值。但是，在fillprepare之后可以安全地使用batchupdate()（将仅设置 id、tmodtime 和映射的字段）。
function fillprepare(const aclient: irestorm; const formatsqlwhere: rawutf8; const boundssqlwhere: array of const; const fieldscsv: rawutf8 = ''): boolean; overload;
使用带有 '%' 参数的指定 where 子句准备获取值。
- 如果 sql 请求成功，则返回 true，如果在 sql 请求期间发生错误，则返回 false。
- 准备完成后，你可以通过调用
fillrow(1..table.rowcount)来获取任何一行的值。 - 或者，你也可以使用以下循环来遍历所有行：
while rec.fillone do dosomethingwith(rec);
- 函数会创建一个临时的
tormtable，并将其存储在一个受保护的内部字段ftable中。 - 为了提高服务器速度，where 子句应使用在
formatsqlwhere语句中标识为 '?' 的绑定参数，这些参数应按照boundssqlwhere开放数组中提供的值的顺序进行排列。对于tdatetime类型，使用datetosql/datetimetosql，或者直接将任何整数/双精度/货币/rawutf8 值绑定为请求的参数。 - 请注意，此方法原型在框架的 1.17 版中已更改：以前
paramssqlwhere是array of const类型，并在formatsqlwhere语句中使用 '%'，而现在它期望绑定参数为 '?'。 fieldscsv可用于指定必须检索哪些字段。- 默认的
fieldscsv=''将检索所有简单的表字段，但如果你只需要访问一个或多个字段，并希望节省远程带宽，可以通过指定所需字段来实现。 - 如果
fieldscsv='*'，它将检索所有字段，包括 blobs。 - 请注意，如果你想稍后更新检索到的记录内容，则不应使用此可选的
fieldscsv参数，因为任何缺失的字段都将保留先前的值。但是，在fillprepare之后可以安全地使用batchupdate()（将仅设置 id、tmodtime 和映射的字段）。
function fillprepare(const aclient: irestorm; const formatsqlwhere: rawutf8; const paramssqlwhere, boundssqlwhere: array of const; const fieldscsv: rawutf8 = ''): boolean; overload;
使用带有 '%' 和 '?' 参数的指定 where 子句准备获取值。
- 如果 sql 请求成功，则返回 true，如果在 sql 请求期间发生错误，则返回 false。
- 准备完成后，你可以通过调用
fillrow(1..table.rowcount)来获取任何一行的值。 - 或者，你也可以使用以下循环来遍历所有行：
while rec.fillone do dosomethingwith(rec);
- 函数会创建一个临时的
tormtable，并将其存储在一个受保护的内部字段ftable中。 formatsqlwhere子句会将所有 '%' 字符替换为提供的paramssqlwhere[]数组中的值，并将所有 '?' 字符绑定为boundssqlwhere[]数组中的绑定参数值。fieldscsv可用于指定必须检索哪些字段。- 默认的
fieldscsv=''将检索所有简单的表字段，但如果你只需要访问一个或多个字段，并希望节省远程带宽，可以通过指定所需字段来实现。 - 如果
fieldscsv='*'，它将检索所有字段，包括 blobs。 - 请注意，如果你想稍后更新检索到的记录内容，则不应使用此可选的
fieldscsv参数，因为任何缺失的字段都将保留先前的值。但是，在fillprepare之后可以安全地使用batchupdate()（将仅设置 id、tmodtime 和映射的字段）。
这个函数结合了两种参数替换方式：'%' 字符的直接替换和 '?' 的绑定参数方式，为用户提供了更大的灵活性。但同时，也要求用户更仔细地管理参数以避免潜在的 sql 注入风险。
function fillprepare(const aclient: irestorm; const aids: array of tid; const fieldscsv: rawutf8 = ''): boolean; overload;
准备从一个id列表中获取值。
- 如果sql请求成功，则返回true，如果sql请求期间出现错误，则返回false。
- 准备完成后，你可以通过调用
fillrow(1..table.rowcount)来获取任何一行的值。 - 或者，你也可以使用以下循环来遍历所有行：
while rec.fillone do dosomethingwith(rec);
- 函数会创建一个临时的
tormtable，并将其存储在一个受保护的内部字段ftable中。 fieldscsv可用于指定必须检索哪些字段。- 默认的
fieldscsv=''将检索所有简单的表字段，但如果你只需要访问一个或多个字段，并希望节省带宽，可以通过指定所需字段来实现。 - 如果
fieldscsv='*'，它将检索所有字段，包括blobs。 - 请注意，如果你想稍后更新检索到的记录内容，则不应使用此可选的
fieldscsv参数，因为任何缺失的字段都将保留先前的值。但在fillprepare之后可以安全地使用batchupdate()（只会设置id、tmodtime和映射的字段）。
这个重载版本的 fillprepare函数接收一个id数组作为参数，使得用户能够一次性检索多个特定id对应的记录，提高了数据检索的效率。同时，与上一个版本类似，它也支持通过 fieldscsv参数来定制需要检索的字段，以满足不同的数据需求。
function fillpreparemany(const aclient: irestorm; const aformatsqljoin: rawutf8; const aparamssqljoin, aboundssqljoin: array of const): boolean;
准备遍历包含 tormmany字段的join语句。
- 所有
tormmany.dest发布的字段现在将包含一个真正的torm实例，准备好用join语句的结果填充（这些实例将在fillclose时释放）——source也将指向自身实例。 aformatsqljoin子句将为自动化的join语句定义一个where子句，包括tormmany发布的属性（及其嵌套属性）。- 如果sql请求成功，则返回true，如果sql请求期间出现错误，则返回false。
- 一个典型的应用场景可能如下：
if aprod.fillpreparemany(database,
'owner=? and categories.dest.name=? and (sizes.dest.name=? or sizes.dest.name=?)',
[], ['mark', 'for boy', 'small', 'medium']) then
while aprod.fillone do
// 在这里，例如，aprod.categories.dest被实例化（并且categories.source=aprod）
writeln(aprod.name, ' ', aprod.owner, ' ', aprod.categories.dest.name, ' ', aprod.sizes.dest.name);
// 你也可以使用aprod.filltable来填充一个网格，例如
// （不要忘记设置aprod.filltable.ownermustfree := false）
这将执行类似于以下的join select语句：
select p.*, c.*, s.* from product p, category c, categories cc, size s, sizes ss
这个函数允许用户准备和执行复杂的join查询，同时自动处理 tormmany关系。通过这种方式，用户可以方便地获取相关联的数据，并在应用程序中进行进一步处理。此函数还提供了参数化查询的功能，增强了查询的灵活性和安全性。
发表评论