对象和函数手册
【E2EE文档】

模板处理

渲染网页() : 文本型

渲染网页内容。

  • 模板文件:“文本型”。模板文件在网站中的路径。

  • 渲染数据:“存取键值表”。用来定义渲染内容的存取键值对对象。

服务器辅助

取回服务器对象() : 网站服务器

通过服务器句柄获取服务器对象。

  • 服务器对象地址:“整数型”。回调函数中收到的的第一个参数。

取回请求对象() : 逻辑型

获取请求和响应对象。

  • 请求对象地址:“整数型”。回调函数中收到的的第一个参数。

  • 响应对象地址:“整数型”。回调函数中收到的的第二个参数。

  • 要取回的请求对象:“服务器请求()”,可以被省略,提供参数数据时只能提供变量。传入请求对象变量用于接收实际请求对象。如果为空则不接收。

  • 要取回的响应对象:“服务器响应()”,可以被省略,提供参数数据时只能提供变量。传入响应对象变量用于接收实际响应对象。如果为空则不接收。

Base64编码() : 文本型

将数据编码到Base64。

  • 编码数据:“字节集”。要编码的字节集数据。

  • 编码表:“文本型”,可以被省略。除特殊情况下,不建议使用本参数。如果使用本参数,那么编码表长度必须为64位,否则会编码失败。默认编码表:“ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/”。

Base64解码() : 字节集

解码Base64文本到数据。

  • 解码内容:“文本型”。要解码的文本数据。

  • 编码表:“文本型”,可以被省略。除特殊情况下,不建议使用本参数。如果使用本参数,那么编码表长度必须为64位,否则会解码失败。默认编码表:“ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/”。

XSS脚本过滤() : 文本型

过滤XSS恶意脚本。将可能包含的恶意脚本清空,不影响正常内容。

  XSS是一种经常出现在web应用中的计算机安全漏洞,它允许恶意web用户将代码植入到提供给其它用户使用的页面中。比如这些代码包括HTML代码和客户端脚本。攻击者利用XSS漏洞旁路掉访问控制——例如同源策略()。这种类型的漏洞由于被黑客用来编写危害性更大的网络钓鱼()攻击而变得广为人知。对于跨站脚本攻击,黑客界共识是:跨站脚本攻击是新型的“缓冲区溢出攻击”,而JavaScript是新型的“ShellCode”。

  XSS漏洞的危害

    网络钓鱼,包括盗取各类用户账号;

    窃取用户cookies资料,从而获取用户隐私信息,或利用用户身份进一步对网站执行操作;

    劫持用户 会话,从而执行任意操作,例如进行非法转账、强制发表日志、发送电子邮件等;

    强制弹出广告页面、刷流量等;

    网页挂马;

    进行恶意操作,例如任意篡改页面信息、删除文章等;

    进行大量的客户端攻击,如DDoS攻击;

    获取客户端信息,例如用户的浏览历史、真实IP、开放端口等;

    控制受害者机器向其他网站发起攻击;

    结合其他漏洞,如CSRF漏洞,实施进一步作恶;

    提升用户权限,包括进一步渗透网站;

    传播跨站脚本蠕虫等;

  • 内容:“文本型”。要过滤脚本注入的内容。

  • 过滤模式:“整数型”,初始值为“0”。[0]执行HTML关键字转义,转义后在页面能正常显示 [1]过滤脚本等内容为空文本。默认为 0 。

对象工厂

创建键值表() : 存取键值表

创建一个键值表。格式单数为键,复数为值。例如:创建键值表()

。如果键不为文本则不会插入,值类型只支持存取键值表支持的类型,不支持的将不会被插入新对象中。

    注意:如果第一个值名称为“*”,当第二个值也为文本型时,将使用第二个值做为名称在外部包裹一层[存取键值表]。主要用于模板过滤处理。

    - 键值:“通用型”。键/值内容。单数为键(),复数为值()。

创建列表() : 存取列表

创建一个列表。值类型只支持存取列表支持的类型。例如:创建列表()

。存在不支持的类型只返回空文本。

  • 值:“通用型”。值内容。仅支持存取列表支持的类型。

库定义数据类型列表

网站服务器

互联网应用服务器。

启动() : 逻辑型

启动服务器。

  • 自定义配置:“存取键值表”,可以被省略。设置自定义配置项,用来替换现有服务器配置。为空则不使用任何自定义配置。

停止() : 逻辑型

停止服务器。

初始化() : 逻辑型

初始化网站。

  • 网站根目录:“文本型”。网站根目录的绝对路径。

订阅初始化函数() : 无返回值

服务器启动之前,加载完配置后将触发此函数。如果需要读取服务器配置或者获取对象映射中心等,请订阅此函数。在模块中如果需要读取模块配置,则务必使用此函数。

象成员命令。

  • 初始化子程序:“子程序指针()”。服务器初始化子程序地址。此函数将在服务器获取所有配置和启动之前触发。函数原始格式为:

     <空> 函数名()

    模块服务器对象如果要获取配置或者对象映射中心等请务必此函数。可以复制以下内容作为模板:

        ============================================================

    .版本 2

          .子程序 服务器初始化,

            .参数 服务器地址, 整数型

            .局部变量 服务器, 网站服务器

            服务器 = 取回服务器对象()

            ' // TODO: 初始化服务器取服务器配置和对象映射中心等

      

    ============================================================。

订阅视图函数() : 逻辑型

通过请求相对路径订阅一个回调函数用于处理服务器请求。

  • 处理函数:“子程序指针()”。请求处理函数子程序地址。函数原始格式为:

     <逻辑型> 函数名()

    处理函数返回值决定是否处理成功。可以复制以下内容作为模板:

        ============================================================

    .版本 2

          .子程序 处理函数示例, 逻辑型

            .参数 请求对象地址, 整数型

            .参数 响应对象地址, 整数型

            .局部变量 请求, 服务器请求

            .局部变量 响应, 服务器响应

            .局部变量 模板数据, 存取键值表

            取回请求对象()

            ' // TODO: 业务处理逻辑

      返回())

    ============================================================。

    - 请求地址:“文本型”。请求相对路径地址。如实际网址为 http://localhost/add_user 则此处的路径为:/adduser 相对路径必须以“/”开头。可以使用正则。

    - 模板文件:“文本型”,可以被省略。处理函数默认渲染模板文件路径。不提供则在无模板参数的 响应.渲染() 会执行失败。建议使用“/”开头的相对路径,使用相对路径时将自动定位到“[网站]/[模板]/”目录下对应的文件。

    - 标签:“文本型”,可以被省略。标签标记。省略此处的标签对路径处理函数来说没有任何影响,订阅全局函数时省略标签则意味着处理所有用户请求函数(),此标签不是核心支持库中的“标签”组件。标签为一段文本,可以对功能用来做分组以便通过类似分组的方式进行全局控制。标签允许多个,您可以把功能按照层级进行处理,例如某个用户界面功能设置了以下标签:普通用户、普通用户帖子、普通用户帖子_发布。形成类似树状的结构,全局函数可以分别对每个层级的标签进行判断和控制,以便决定用户是否可以继续进行下一步处理。当然这只是其中一种场景,大部分时候您都可以通过标签的各种不同组合来完成您的业务场景处理。

取消视图函数() : 逻辑型

取消指定的路径处理函数。

  • 处理函数:“子程序指针()”。请求处理函数子程序地址。函数原始格式为:

     <逻辑型> 函数名()

    处理函数返回值决定是否处理成功。可以复制以下内容作为模板:

        ============================================================

    .版本 2

          .子程序 处理函数示例, 逻辑型

            .参数 请求对象地址, 整数型

            .参数 响应对象地址, 整数型

            .局部变量 请求, 服务器请求

            .局部变量 响应, 服务器响应

            .局部变量 模板数据, 存取键值表

            取回请求对象()

            ' // TODO: 业务处理逻辑

      返回())

    ============================================================。

订阅全局函数() : 逻辑型

订阅一个全局的处理函数用以预处理请求或者控制是否允许继续处理请求。如果不设置标签参数则该全局函数将处理所有用户请求。允许同时订阅多个全局函数(),设置标签后遇到指定“标签”内容的路径订阅函数时将会在函数执行之前触发。可以通过拦截“标签”来制定访问或权限规则等,该功能类似于Java等语言的注解功能。

  • 处理函数:“子程序指针()”。全局请求处理函数子程序地址。函数原始格式为:

     <逻辑型> 函数名()

    处理函数返回值决定是否继续进行其他的请求处理函数,返回[真]则继续处理该请求,返回[假]则终止接下来的所有处理过程()。可以复制以下内容作为模板:

        ============================================================

    .版本 2

          .子程序 全局函数示例, 逻辑型

            .参数 请求对象地址, 整数型

            .参数 响应对象地址, 整数型

            .局部变量 请求, 服务器请求

            .局部变量 响应, 服务器响应

            取回请求对象()

            ' // TODO: 全局业务处理逻辑

      返回()

    ============================================================。

    - 标签:“文本型”,可以被省略。标签标记。省略此处的标签对路径处理函数来说没有任何影响,订阅全局函数时省略标签则意味着处理所有用户请求函数(),此标签不是核心支持库中的“标签”组件。标签为一段文本,可以对功能用来做分组以便通过类似分组的方式进行全局控制。标签允许多个,您可以把功能按照层级进行处理,例如某个用户界面功能设置了以下标签:普通用户、普通用户帖子、普通用户帖子_发布。形成类似树状的结构,全局函数可以分别对每个层级的标签进行判断和控制,以便决定用户是否可以继续进行下一步处理。当然这只是其中一种场景,大部分时候您都可以通过标签的各种不同组合来完成您的业务场景处理。

取消全局函数() : 无返回值

取消的全局函数。

  • 处理函数:“子程序指针()”。全局请求处理函数子程序地址。函数原始格式为:

     <逻辑型> 函数名()

    处理函数返回值决定是否继续进行其他的请求处理函数,返回[真]则继续处理该请求,返回[假]则终止接下来的所有处理过程()。可以复制以下内容作为模板:

        ============================================================

    .版本 2

          .子程序 全局函数示例, 逻辑型

            .参数 请求对象地址, 整数型

            .参数 响应对象地址, 整数型

            .局部变量 请求, 服务器请求

            .局部变量 响应, 服务器响应

            取回请求对象()

            ' // TODO: 全局业务处理逻辑

      返回()

    ============================================================。

取配置项() : 文本型

取配置文件中的配置项内容。

  • 配置项:“文本型”。配置项名称。在 配置.conf/config.conf 文件中的配置项名称。如果配置中设置了[包含文件]项,则对应的配置文件中的配置项也能被读取到。

取配置文本() : 文本型

获取所有配置内容到文本。

置配置项() : 逻辑型

设置服务器配置项。如果为服务器基础参数,请在全部配置项设置完成后,使用“更新配置”命令通知服务器重新同步相关设定到服务器。本命令不保证线程安全,请在服务器启动之前执行

  • 配置项:“文本型”。配置项名称。在 配置.conf/config.conf 文件中的配置项名称。如果配置中设置了[包含文件]项,则对应的配置文件中的配置项也能被读取到。

  • 配置值:“文本型”。值文本内容。

更新配置() : 逻辑型

通知服务器重新同步配置项内容到服务器。本命令不保证线程安全,请在服务器启动之前执行。

加载模块() : 逻辑型

将指定服务器对象作为模块加载到当前服务器。可给指定服务器挂接一个路径和一个标签。路径为空则所有请求会被转发到挂接的服务器模块下,标签为空则无法给下级模块的添加额外的

全局函数。

  • 模块子服务器:“网站服务器()”。模块子服务器对象。请注意模块化子服务器请不要执行 启动() 命令,本命令请在 启动()前执行。对应服务器对象会被加载到主服务器成为主服务器的下级模块。

  • 模块名称:“文本型”。给模块定义名称。模块名称不能为空,且不能和已有模块同名,否则会添加失败。在主服务器中订阅的全局函数拥有相同标签内容时,可在模块执行前处理请求。

  • 挂载路径:“文本型”。模块子服务器业务处理挂载的路径。未设置或者路径为空文本和“/”时,主服务器的所有请求都会被模块服务器执行,相当于替换主服务器业务逻辑。

删除模块() : 逻辑型

将指定服务器对象模块从当前服务器删除。请在 启动() 前执行。

  • 挂载路径:“文本型”。模块子服务器业务处理挂载的路径。未设置或者路径为空文本和“/”时,主服务器的所有请求都会被模块服务器执行,相当于替换主服务器业务逻辑。

写常规日志() : 逻辑型

写普通日志到日志系统中。

  • 日志内容:“文本型”。要写入日志系统的日志内容。

写错误日志() : 无返回值

写错误日志到日志系统中。

  • 日志内容:“文本型”。要写入日志系统的日志内容。

克隆() : 网站服务器

复制一个服务器对象返回一个新的副本。

取对象映射中心() : 对象映射中心

返回当前服务器的映射中心对象。

是否为模块服务器() : 逻辑型

判断当前服务器是否为模块服务器。

服务器请求

互联网应用服务器请求。

取请求头() : 文本型

获取服务器请求头信息。

  • 请求头名称:“文本型”。HTTP头的名称。

取上传文件() : 文本型

获取用户上传的文件保存到本地的绝对路径。如果要使用该文件请移动到需要的地方,如果不使用请删除。

  • 文件表单名称:“文本型”。上传文件中的表单名称()。

取用户地址() : 文本型

获取用户地址()信息。

取用户端口() : 整数型

获取用户端口信息。

取请求版本号() : 文本型

获取用户请求版本号信息。

取请求路径() : 文本型

取请求的相对路径。

取请求类型() : 文本型

获取用户请求类型()。GET/POST等。

取参数() : 文本型

获取参数内容。

  • 参数表单名称:“文本型”。参数表单的名称()。

取所有参数() : 存取键值表

取所有的请求参数对象。注意:值结果大部分时候为文本,但如果同名称参数有多个则结果为文本存取列表对象。

置Session值() : 无返回值

设置用户Session的值。如果值内容为空文本则执行删除。

  • 主键名称:“文本型”。主键的名称。Session就像存取键值表,您可以通过一个键来读写数据。

  • 值文本:“文本型”,可以被省略。要写入到Session中的值文本内容。如果内容为空则执行删除。

取Cookies() : 存取键值表

获取用户的Cookies内容。

取SessionID() : 文本型

获取用户的Session的ID内容。

取Session值() : 文本型

获取用户Session的值。

  • 主键名称:“文本型”。主键的名称。Session就像存取键值表,您可以通过一个键来读写数据。

取所有上传文件() : 存取列表

取用户所有的文件信息列表。

返回的存取列表对象内为[存取键值对]对象,键值对主键为 [name] 表单名称 [filename] 文件原始名称 [file] 文件存储在本服务器的绝对路径()。

如果要使用该文件请移动到需要的地方,如果不使用请删除。

属性表() : 存取键值表

获取属性表对象。属性表对象是唯一的,获取后读写操作都是基于原始对象的()。

是否包含标签() : 逻辑型

判断请求匹配到的路径处理函数是否包含指定标签。

  • 标签:“文本型”。标签名称。

取标签列表() : 存取列表

获取请求匹配到的路径处理函数携带的标签列表。返回的列表为只读,请不要做添加删除等操作。如果需要修改使用此列表,请使用复制方法。

取配置项() : 文本型

取配置文件中的配置项内容。等同于 互联网服务器.取配置项()。

  • 配置项:“文本型”。配置项名称。在 配置.conf/config.conf 文件中的配置项名称。如果配置中设置了[包含文件]项,则对应的配置文件中的配置项也能被读取到。

取配置文本() : 文本型

获取所有配置内容到文本。等同于 互联网服务器.取配置文本()。

取对象映射中心() : 对象映射中心

返回当前服务器的映射中心对象。

服务器响应

互联网应用服务器响应。

置响应头() : 逻辑型

设置或者添加响应头。

  • 响应头名称:“文本型”。HTTP头的名称。

  • 响应头内容:“文本型”。返回给浏览器的HTTP头对应的内容。

添加Cookie() : 逻辑型

添加用户Cookie。

  • COOKIE表:“存取键值表”。存储COOKIE的存取键值表()。键为cookie项名称,值为cookie值。值可以为空。

  • 域名:“文本型”,可以被省略。COOKIE对应的域名。不设置则为当前域名。

  • 路径:“文本型”,可以被省略。对应网站中的路径。不设置则设置COOKIE到默认路径下。

  • 过期时间:“文本型”,可以被省略。过期时间文本。为“0”为删除COOKIE;为数字则为多少毫秒后过期;如果指定的为指定日期时间请使用转换函数转换为GMT时间格式。

  • 是否安全传输:“逻辑型”,可以被省略。规定是否通过安全的 HTTPS 连接来传输 cookie。为空或者“假”则不使用。

置SessionID() : 逻辑型

设置用户SessionID。

  • SessionID:“文本型”。设置用户的SessionID内容。

取SessionID() : 文本型

获取用户SessionID。

取响应状态() : 整数型

获取页面响应状态。例如:200()/404(),其余请参考HTTP协议。

置响应状态() : 逻辑型

设置页面响应状态。例如:200()/404(),其余请参考HTTP协议。

  • HTTP响应状态:“整数型”。HTTP的返回状态。例如[200]正常 [404]网页不存在 [500]网页错误等。

写文本() : 逻辑型

将内容输出到页面。

  • 文本内容:“文本型”。欲写出的文本内容。

写数据() : 逻辑型

将数据输出到页面。

  • 数据内容:“字节集”。欲写出的字节集内容。

渲染() : 逻辑型

渲染内容并输出到页面。

  • 模板数据:“存取键值表”,可以被省略。需要生成模板的来源数据。如果模板数据为空,则默认传递 请求.属性表() 用于模板渲染。

  • 模板路径:“文本型”,可以被省略。在网站模板目录下的相对路径。如果为空则使用当前请求相对路径所对应的网站模板目录下的文件。例如用户请求为 “http://localhost/user/add”,则用户请求相对路径为“/user/add”,而模板文件为 “[网站目录]/模板/user/add.html”。其中 .html 后缀为网站配置项[模板后缀]设置的值。默认为 .html。

  • 渲染文档类型:“文本型”,可以被省略。返回给浏览器的HTTP头部Content-Type内容。如果为空则使用服务器配置()。具体格式可以参考HTML的MimeMap。

重定向() : 逻辑型

重定向到新的网址。

  • 重定向地址:“文本型”。要重定向的网址。网站内请使用相对路径,网站外用绝对地址。

  • 是否为永久地址:“逻辑型”,可以被省略。通知浏览器当前地址是否永久定位到新的地址。如果省略则默认为“假”。HTTP响应信息中[301]代表永久重定向 [302]为临时重定向,具体请参考HTTP/1.1协议。

发送文件() : 逻辑型

发送文件给用户。

  • 文件路径:“文本型”。可以使用相对路径和绝对路径。相对路径是针对 [网站]/网页/ 目录的相对位置。相对路径请使用“/”开头。

取默认模板路径() : 文本型

获取请求匹配到的路径处理函数携带的模板路径。

存取键值表

存取值用的表。

取类型() : 整数型

取内容类型。使用 #存取类型_ 开头的常量。

  • 主键:“文本型”。主键文本。

是否存在() : 逻辑型

判断指定键对应的值是否存在。对应键不存在时返回为假。

  • 主键:“文本型”。主键文本。

取文本() : 文本型

取内容文本。

  • 主键:“文本型”。主键文本。

取整数() : 整数型

取内容为整数型。

  • 主键:“文本型”。主键文本。

取长整数() : 长整数型

取内容为长整数型。

  • 主键:“文本型”。主键文本。

取双精度小数() : 双精度小数型

取内容为双精度小数。

  • 主键:“文本型”。主键文本。

取小数() : 小数型

取内容为小数。

  • 主键:“文本型”。主键文本。

取逻辑值() : 逻辑型

取内容为逻辑值。

  • 主键:“文本型”。主键文本。

取键值表() : 存取键值表

取内容为存取键值表。

  • 主键:“文本型”。主键文本。

取列表() : 存取列表

取内容为存取列表。

  • 主键:“文本型”。主键文本。

置文本() : 逻辑型

置内容文本。

  • 主键:“文本型”。主键文本。

  • 值:“文本型”。值内容。

置整数() : 逻辑型

置内容为整数型。

  • 主键:“文本型”。主键文本。

  • 值:“整数型”。值内容。

置长整数() : 逻辑型

置内容为长整数型。

  • 主键:“文本型”。主键文本。

  • 值:“长整数型”。值内容。

置双精度小数() : 逻辑型

置内容为双精度小数。

  • 主键:“文本型”。主键文本。

  • 值:“双精度小数型”。值内容。

置小数() : 逻辑型

置内容为小数。

  • 主键:“文本型”。主键文本。

  • 值:“小数型”。值内容。

置逻辑值() : 逻辑型

置内容为逻辑值。

  • 主键:“文本型”。主键文本。

  • 值:“逻辑型”。值内容。

置键值表() : 逻辑型

置内容为存取键值表。

  • 主键:“文本型”。主键文本。

  • 值:“存取键值表”。值内容。

置列表() : 逻辑型

置内容为存取列表。

  • 主键:“文本型”。主键文本。

  • 值:“存取列表”。值内容。

取数量() : 整数型

取元素数量。

取时间() : 日期时间型

  • 主键:“文本型”。主键文本。

置时间() : 逻辑型

  • 主键:“文本型”。主键文本。

  • 值:“日期时间型”。值内容。

取字节集() : 字节集

  • 主键:“文本型”。主键文本。

置字节集() : 逻辑型

  • 主键:“文本型”。主键文本。

  • 值:“字节集”。值内容。

取值() : 通用型

  • 主键:“文本型”。主键文本。

置值() : 逻辑型

  • 主键:“文本型”。主键文本。

  • 值:“通用型”。值内容。

取键数组() : 文本型数组

取所有键名称数组。

删除() : 逻辑型

删除键值对。

  • 主键:“文本型”。主键文本。

清空() : 逻辑型

清空所有内容。

到文本() : 文本型

输出内容为文本。

到JSON() : 文本型

内容转换到JSON文本。

  • 是否修饰:“逻辑型”,初始值为“假”。修饰后输出的内容更便于阅读。效率会稍微低一点。

从JSON载入() : 逻辑型

从JSON载入。

  • 值:“文本型”。值内容。

合并到() : 逻辑型

合并当前键值表到指定键值表中。

  • 目标键值表:“存取键值表”。目标键值表对象。当前键值表的数据会被复制并入到目标键值表中。

到数据类型() : 逻辑型

转换当前对象到用户自定义数据。

  • 配置文件:“文本型”。配置文件路径。

  • 自定义数据:“通用型”。配置的用户自定义数据类型。

存取列表

存取值用的列表。

取类型() : 整数型

取内容类型。使用 #存取类型_ 开头的常量。

  • 索引:“整数型”。列表索引位置。从1开始。

是否为空值() : 逻辑型

判断索引对应的值是否为空。索引超出范围时也返回为真。

  • 索引:“整数型”。列表索引位置。从1开始。

取文本() : 文本型

取内容文本。

  • 索引:“整数型”。列表索引位置。从1开始。

取整数() : 整数型

取内容为整数型。

  • 索引:“整数型”。列表索引位置。从1开始。

取长整数() : 长整数型

取内容为长整数型。

  • 索引:“整数型”。列表索引位置。从1开始。

取双精度小数() : 双精度小数型

取内容为双精度小数。

  • 索引:“整数型”。列表索引位置。从1开始。

取小数() : 小数型

取内容为小数。

  • 索引:“整数型”。列表索引位置。从1开始。

取逻辑值() : 逻辑型

取内容为逻辑值。

  • 索引:“整数型”。列表索引位置。从1开始。

取键值表() : 存取键值表

取内容为存取键值表。

  • 索引:“整数型”。列表索引位置。从1开始。

取列表() : 存取列表

取内容为存取列表。

  • 索引:“整数型”。列表索引位置。从1开始。

取时间() : 日期时间型

  • 索引:“整数型”。列表索引位置。从1开始。

取字节集() : 字节集

  • 索引:“整数型”。列表索引位置。从1开始。

取值() : 通用型

  • 索引:“整数型”。列表索引位置。从1开始。

置文本() : 逻辑型

置内容文本。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“文本型”。值内容。

置整数() : 逻辑型

置内容为整数型。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“整数型”。值内容。

置长整数() : 逻辑型

置内容为长整数型。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“长整数型”。值内容。

置双精度小数() : 逻辑型

置内容为双精度小数。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“双精度小数型”。值内容。

置小数() : 逻辑型

置内容为小数。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“小数型”。值内容。

置逻辑值() : 逻辑型

置内容为逻辑值。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“逻辑型”。值内容。

置键值表() : 逻辑型

置内容为存取键值表。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“存取键值表”。值内容。

置列表() : 逻辑型

置内容为存取列表。

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“存取列表”。值内容。

置时间() : 逻辑型

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“日期时间型”。值内容。

置字节集() : 逻辑型

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“字节集”。值内容。

置值() : 逻辑型

  • 索引:“整数型”。列表索引位置。从1开始。

  • 值:“通用型”。值内容。

插入文本() : 逻辑型

插入内容文本。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“文本型”。值内容。

插入整数() : 逻辑型

插入内容为整数型。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“整数型”。值内容。

插入长整数() : 逻辑型

插入内容为长整数型。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“长整数型”。值内容。

插入双精度小数() : 逻辑型

插入内容为双精度小数。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“双精度小数型”。值内容。

插入小数() : 逻辑型

插入内容为小数。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“小数型”。值内容。

插入逻辑值() : 逻辑型

插入内容为逻辑值。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“逻辑型”。值内容。

插入键值表() : 逻辑型

插入内容为存取键值表。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“存取键值表”。值内容。

插入列表() : 逻辑型

插入内容为存取列表。

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“存取列表”。值内容。

插入时间() : 逻辑型

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“日期时间型”。值内容。

插入字节集() : 逻辑型

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“字节集”。值内容。

插入值() : 逻辑型

  • 索引:“整数型”。插入位置。[1]插入顶部,负数则从尾部插入,例如-1则插入到最后一条之前。

  • 值:“通用型”。值内容。

添加文本() : 逻辑型

添加内容文本。

  • 值:“文本型”。值内容。

添加整数() : 逻辑型

添加内容为整数型。

  • 值:“整数型”。值内容。

添加长整数() : 逻辑型

添加内容为长整数型。

  • 值:“长整数型”。值内容。

添加双精度小数() : 逻辑型

添加内容为双精度小数。

  • 值:“双精度小数型”。值内容。

添加小数() : 逻辑型

添加内容为小数。

  • 值:“小数型”。值内容。

添加逻辑值() : 逻辑型

添加内容为逻辑值。

  • 值:“逻辑型”。值内容。

添加键值表() : 逻辑型

添加内容为存取键值表。

  • 值:“存取键值表”。值内容。

添加列表() : 逻辑型

添加内容为存取列表。

  • 值:“存取列表”。值内容。

添加时间() : 逻辑型

  • 值:“日期时间型”。值内容。

添加字节集() : 逻辑型

  • 值:“字节集”。值内容。

添加值() : 逻辑型

  • 值:“通用型”。值内容。

取数量() : 整数型

取列表数量。

删除() : 逻辑型

删除索引位置的值。

  • 索引:“整数型”。要删除的索引位置。从1开始。如果为负数,则从后删除,如:[-1]删除最后一个。

  • 删除数量:“整数型”,可以被省略。总删除数量不能超出删除范围。如果为空则只删除1条,如果为 -1 则删除后边所有。

清空() : 逻辑型

清空所有内容。

到文本() : 文本型

输出内容为文本。

到JSON() : 文本型

内容转换到JSON文本。

  • 是否修饰:“逻辑型”,初始值为“假”。修饰后输出的内容更便于阅读。效率会稍微低一点。

从JSON载入() : 逻辑型

从JSON载入。

  • JSON文本:“文本型”。JSON文本不为数组类型文本则载入失败。

合并到() : 逻辑型

合并当前列表到指定列表中。

  • 目标列表:“存取列表”。目标列表对象。当前列表的数据会被复制并入到目标列表尾部。

读写共享锁

对同一个变量执行读写操作的时候加锁。开始读() 和 结束读() 永远结对,开始写() 和 结束写() 永远结对。共享锁的特性为读操作允许同时多个执行,写操作只有一个可以执行。如果遇到写操作,则后边的所有其它读写操作都将执行等待。

开始读() : 整数型

开始读操作,返回读钥匙句柄。跟 结束读() 永远是结对关系。执行完成读取操作请务必使用 结束读()

命令关闭读操作。通过本命令能保证能够同时多个操作执行读取,但只有一个操作能够写入。没有读取操作时才会写入,有写入时读取会等待写入操作完成。

结束读() : 逻辑型

关闭读操作锁定。

  • 读钥匙句柄:“整数型”。通过 开始读() 返回的句柄对象。

开始写() : 整数型

执行写操作,返回写钥匙句柄。跟 结束写() 永远是结对关系。执行完成写入操作请务必使用 结束写()

命令关闭写操作。通过本命令能保证同时只有一个操作在写入数据。所有其它读写操作都将执行等待。

结束写() : 逻辑型

关闭写操作锁定。

  • 写钥匙句柄:“整数型”。通过 开始写() 返回的句柄对象。

对象映射中心

处理存取键值表和存取列表跟自定义数据类型之间的转换等操作。

对象转自定义() : 逻辑型

将()对象转自定义数据。

  • 映射对象名称:“文本型”。对象映射的名称。

  • 来源键值表:“存取键值表”。键值对来源数据。

  • 目标自定义数据:“通用型”。目标用户自定义数据类型()。

自定义转对象() : 逻辑型

将自定义数据转()对象。

  • 映射对象名称:“文本型”。对象映射的名称。

  • 来源自定义数据:“通用型”。来源用户自定义数据类型()。

  • 目标键值表:“存取键值表”。键值对目标数据。

  • 是否使用昵称:“逻辑型”,初始值为“真”。是否使用配置的昵称信息。昵称不存在时则使用原名称。

对象转数组() : 逻辑型

将()对象转自定义数据数组。转换前请清空数组内容。

  • 映射对象名称:“文本型”。对象映射的名称。

  • 来源列表:“存取列表”。来源列表对象。

  • 目标自定义数据数组:“通用型”,提供参数数据时只能提供变量数组。目标用户自定义数据类型()。

数组转对象() : 逻辑型

将自定义数据数组转()对象。

  • 映射对象名称:“文本型”。对象映射的名称。

  • 来源自定义数据:“通用型”,提供参数数据时可以同时提供数组或非数组数据。来源用户自定义数据类型()。

  • 目标列表对象:“存取列表”。目标列表对象。

  • 是否使用昵称:“逻辑型”,初始值为“真”。是否使用配置的昵称信息。昵称不存在时则使用原名称。

ADODB数据库连接池

ADO数据库连接池。提供基础的ADO访问数据库连接池功能。

创建() : 逻辑型

创建连接池。

  • 服务器对象:“网站服务器()”。传递服务器对象。统一错误日志等。

  • 连接字符串:“文本型”。ADO的连接字符串。

  • 数据库类型名称:“文本型”,可以被省略。例如:SQLite、MSSQL、MySQL等。

  • 对象映射中心:“对象映射中心()”,可以被省略。如果指定了对象映射中心才能执行查询到数据、保存对象和删除等ORM操作。

  • 取最后ID的SQL:“文本型”,可以被省略。用在ORM保存对象时使用,不使用ORM保存对象功能可不填写。内置了:SQLite、MSSQL、MySQL 的取ID语句,这些数据库时不用填写。其它类型数据库请自己填写获取最后ID的语句,支持两个转义文本,分别是:“<ID>”和“<表>”,使用时可组织类似如下语句:SELECT MAX(<ID>) FROM <表>。

取连接() : ADODB数据库连接

取回数据库操作连接对象。由于是抽象层连接,所以不需要归还给连接池。

ADODB数据库连接

ADO数据库连接。注意:这是抽象层面的连接,为了优化请求效率,只有在开启事务()后才会保持连接,在查询执行等时候取到数据会立即归还真实连接。释放方式等待自然释放即可。

查询() : 存取列表

通过SQL查询数据。

  • SQL语句:“文本型”。查询数据库的SQL语句。

  • 最大记录数:“整数型”,可以被省略。限定一次能够读取的最大记录数量。等于0时不限定。

查询到自定义数组() : 整数型

通过SQL查询数据,查询成功后接收到用户自定义数组参数中。返回数据数量。

  • SQL语句:“文本型”。查询数据库的SQL语句。

  • 最大记录数:“整数型”,可以被省略。限定一次能够读取的最大记录数量。等于0时不限定。

  • 映射类型名:“文本型”。在对象映射中心注册过的名称。

  • 自定义数组变量:“通用型”,提供参数数据时只能提供变量数组。将对象映射到的自定义数组。

查询头条() : 存取键值表

通过SQL查询数据,返回第一条记录。

  • SQL语句:“文本型”。查询数据库的SQL语句。

查询头条到自定义() : 逻辑型

通过SQL查询数据,查询成功后返回第一条记录到用户自定义数据参数中。返回成功与否。

  • SQL语句:“文本型”。查询数据库的SQL语句。

  • 映射类型名:“文本型”。在对象映射中心注册过的名称。

  • 自定义数据:“通用型”。将对象映射到的自定义数据。

查询到分页() : ADODB数据库分页

通过SQL查询数据并返回分页对象。

  • SQL语句:“文本型”。查询数据库的SQL语句。

  • 分页大小:“整数型”,可以被省略。获取时每页数据的条数。如果为空或者小于1则默认为30。

  • 取数量SQL语句:“文本型”,可以被省略。数据库驱动中不少类型的数据库游标在ADO中都无法取到实际数量,所以可能需要额外提供取数量的SQL语句。如果ADO使用的数据库驱动不支持取数量时,没有设置当前参数,则对象会自动运算总数,效率会低一些。

执行() : 逻辑型

执行SQL。

  • SQL语句:“文本型”。要执行的SQL语句。

开启事务() : 逻辑型

开启事务处理。开启成功后将会锁定真实连接直到事务处理完毕。使用完后务必使用 提交事务/回滚时间 完成连接内的处理。

提交事务() : 逻辑型

确认修改有效后提交事务处理。

回滚事务() : 逻辑型

修改失败后执行事务回滚处理。

保存对象() : 逻辑型

如果设置了ID则根据是否存在ID数据来确定为添加还是修改操作。成功返回真并且回写最新的ID到对应字段。存在ID数据则执行修改,不存在则添加。如果有同ID别名关联的表数据则同步

执行添加或修改操作。

  • 映射类型名:“文本型”。在对象映射中心注册过的名称。

  • 自定义数据:“通用型”。将对象映射到的自定义数据。

ADODB数据库分页

ADO数据库分页对象。本对象复制无效。注意:如果后续逻辑复杂,请在取到所有需要的数据后执行关闭()命令释放资源再处理您接下来的业务逻辑。

取数量() : 整数型

获取全部查询到的数据的总数。

取分页总数() : 整数型

获取总分页数。

取分页大小() : 整数型

获取每页数据的条数。

取分页数据() : 存取列表

取指定页的数据,返回分页数据列表。

  • 分页位置:“整数型”,可以被省略。指定获取数据的页面位置,如果为空或者小于1则默认为1。

取分页数据到数组() : 整数型

取指定页的数据并转换到指定类型的自定义数据数组,返回数据条数。

  • 分页位置:“整数型”,可以被省略。指定获取数据的页面位置,如果为空或者小于1则默认为1。

  • 映射名称:“文本型”。在对象映射中心配置的名称。

  • 自定义数组变量:“通用型”,提供参数数据时只能提供变量数组。将对象映射到的自定义数组。

关闭() : 逻辑型

关闭当前分页对象,关闭后会自动释放所有相关资源。