xScript - 仓湖云函数数字应用引擎
仓湖云函数数字应用引擎开发者使用手册
简介
| 其主要特性为 ： | |||
|---|---|---|---|
 轻量化 |  跨平台 |  效率高 |  国产信创 |
| 单文件 | 支持主流桌面系统 | 原生开发 | 完整自主产权 |
| 无依赖 | 支持主流服务器系统 | 主动缓存 | 国产硬件平台 |
| 大小10M | 提供移动端SDK | 自动回收 | 信创生态兼容 |
| 维度 | xScript | Deno | Node.js |
|---|---|---|---|
| 并发模型 | 多线程真并发(自动调度) | 单线程 + Worker Threads(手动管理) | Eventloop + Cluster模式(回调地狱) |
| 开发门槛 | 内置ORM/API生成器 | 需要组合第三方库 | 需要组合第三方库 |
| 工具链整合 | 标准库+扩展库+开箱即用MCP/建模工具 | 功能分散的标准库 | npm依赖冲突风险 |
| 类型安全 | 底层静态类型 + JS动态类型 | 仅TypeScript | 无强制类型检查 |
| 冷启效率 | 10ms级Serverless响应 | 平均500ms冷启 响应 | 平均800ms冷启响应 |
| 开发效率 | 一分钟生产级API | 缺乏成熟ORM | 需手动搭建架构 |
1.中小团队全栈开发（"一人搞定前后端")
2.企业内部工具链开发（快速构建内部应用系统）
3.数据应用加工或云函数轻应用场景（快速组合数据形成API能力）
启动
脚本结构
内置关键字
use - 引用其它脚本内容
内置常量
scriptPath - 脚本所在目录
runtimePath - 引擎所在目录
rootPath - 函数运行目录
内置库
request库
multipart库
crypto 库
encoding库
sql库
redis库
cache库
fs库
os库
ex库
xml和yaml库
color库
image库
wallet库
mail库
querystring库
crontab库
influxdb库
elasticsearch库
mongo库
runtime库
net库
ws库
mqtt库
compress库
console库
webservice库
国产数据库
sql库 - 达梦数据库
达梦数据库连接串属性表
| 属性名称 | 说明 |
|---|---|
| socketTimeout | 套接字超时时间，缺省为 0 |
| escapeProcess | 是否进行语法转义处理，缺省为 false；取值范围（true，false） |
| autoCommit | 是否自动提交，缺省为 true；取值范围（true，false） |
| maxRows | 结果集行数限制，若超过上限，则对结果集进行截断，取值范围 0~2147483647，缺省为 0，表示无限制 |
| rowPrefetch | 预取行数，缺省为 10 |
| lobMode | Lob 模式，缺省为 1；1： 分批缓存到本地，2： 一次将大字段数据缓存到本地 |
| ignoreCase | 是否忽略大小写，缺省为 true，取值范围（true，false） |
| alwayseAllowCommit | 在自动提交开关打开时，调用 rollback()接口是否不报错，缺省为 true，取值 范围（true，false） |
| batchType | 批处理类型，缺省为 1，1：进行批量绑定，2：不进行批量绑定 |
| appName | 客户端应用程序名称 |
| sessionTimeout | 会话超时时间，缺省为 0 |
| sslCertPath | 指定 ssl 加密证书文件的路径 |
| sslKeyPath | 指定 ssl 加密密钥文件的路径 |
| mppLocal | 是否 MPP 本地连接，缺省为 false；取值访问（true，false） |
| rwSeparate | 是否使用读写分离系统，缺省为 false；取值访问（false：不使用，true：使用） |
| rwPercent | 分发到主库的事务占主备库总事务的百分比，取值范围 0~100，缺省为 25 |
| isBdtaRS | 是否使用列模式结果集，缺省为 false；取值范围（true，false） |
| doSwitch | 连接发生异常或一些特殊场景下的连接处理策略。取值范围 0~2；0：关闭连接；1：当连接发生异常时自动切换到其他库，无论切换成功还是失败都会报错，用于通知上层应用进行事务执行失败时的相关处理；2：配合 epSelector=1 使用，如果服务名列表前面的节点恢复了，将当前连接切换到前面的节点上；缺省为 0 |
| continueBatchOnError | 批量执行出错时是否继续执行；缺省为 false；取值范围（true，false） |
| connectTimeout | 连接数据库超时时间；单位 ms，取值范围 0~2147483647，0 表示无限制；缺省为 5000 |
| columnNameUpperCase | 列名转换为大写字母，缺省为 false；取值范围（true，false） |
| rwIgnoreSql | 读写分离是否忽略 sql 类型，并按比例分发到主/备库，缺省为 false，取值范围（true，false） |
| compatibleMode | 兼容其他数据库, 属性值为数据库名称（例如：Oracle）, 支持兼容 Oracle 和 Mysql |
| dbAliveCheckFreq | 检测数据库是否存活的频率，单位 ms，缺省为 0；0：不检测，1：检测 |
| logDir | 日志等其他一些驱动过程文件生成目录，缺省值是当前工作目录 |
| logLevel | 生成日志的级别，日志按从低到高依次如下（off：不记录；error：只记录错误日志；warn：记录警告信息；sql：记录 sql 执行信息；info：记录全部执行信息；all：记录全部），缺省为 off，高级别同时记录低级别的信息 |
| logFlushFreq | 日志刷盘频率，单位 s，缺省为 10 |
| logBufferSize | 日志缓冲区大小，缺省为 32768 |
| logFlusherQueueSize | 日志刷盘线程中等待刷盘的日志缓冲区队列大小，缺省为 100 |
| statEnable | 是否启用状态监控，缺省为 false；取值范围（true，false） |
| statFlushFreq | 状态监控统计信息刷盘频率，单位 s；缺省为 3 |
| statSlowSqlCount | 日志打印慢 sql top 行数，缺省为 100；取值范围 0~1000 |
| statHighFreqSqlCount | 日志打印高频 sql top 行数，缺省为 100；取值范围 0~1000 |
| statSqlMaxCount | 状态监控可以统计不同 sql 的个数，缺省为 100000；取值范围 0~100000 |
| statSqlRemoveMode | 执行的不同 sql 个数超过 statSqlMaxCount 时使用的淘汰方式，取值范围（latest/eldest）；latest 淘汰最近执行的 sql，eldest 淘汰最老的 sql，缺省为 latest |
| statDir | 状态监 控信息以文本文件形式输出的目录，无缺省值，若不指定则监控信息不会以文本文件形式输出 |
| schema | 指定用户登录后的当前模式，缺省为用户的默认模式 |
| cipherPath | 第三方加密算法动态链接库位置 |
| compress | 是否压缩消息。取值范围 0~2；0：不压缩；1：完全压缩；2：优化的压缩；缺省为 0 |
| compressId | 压缩算法。0：ZLIB 压缩；1：SNAPPY 压缩；缺省为 0 |
| svcConfPath | 自定义客户端配置文件(dm_svc.conf)的完整路径 |
| batchAllowMaxErrors | continueBatchOnError 开启时，最大可容错行数，超过则停止执行，但不报错，取值范围 0~65535，缺省为 0，表示无限制 |
| batchNotOnCall | 存储过程是否不批量执行，默认 false，取值（true，false） |
| cluster | 当 doSwitch=2，epSelector=1 时，用于检测 DSC 集群节点故障恢复是否成功，默认空，取值（DSC） |
| columnNameCase | 列名大小写显示策略，默认空，取值（upper，lower） |
| epSelector | 服务名连接策略。0：依次选取列表中的不同节点建立连接，使得所有连接均匀地分布在各个节点上；1：选择列表中最前面的节点建立连接，只有当前节点无法建立连接时才会选择下一个节点进行连接；默认 0 |
| loginDscCtrl | 服务名连接数据库时是否只选择 dsc control 节点的库，默认 false，取值（true，false） |
| osName | 操作系统名称，默认空 |
| addressRemap | 地址重定向，格式：(IP_1:PORT_1,IP_2:PORT_2)，如：addressRemap=(192.168.0.1:5236,localhost:5237)，如果连接 192.168.0.1:5236，则实际连接到 localhost:5237。可以配置多个地址重定向，例如：addressRemap=(localhost:5236,localhost:5237)(localhost:5238,localhost:5239)，缺省为空 |
| userRemap | 用户名重定向，格式：(USER1,USER2)，如：userRemap=(USER1,USER2)，如果使用 USER1 用户连接，则实际连接用户为 USER2。可以配置多个重定向，例如：userRemap=(USER1,USER2)(USER3,USER4)，缺省为空 |
| switchInterval | 服务名连接数据库时，若遍历了服务名中所有库列表都未找到符合条件的库成功建立连接，等待一定时间再继续下一次遍历；单位 ms，取值范围 0~2147483647，缺省为 1000 |
| switchTimes | 服务名连接数据库时，若未找到符合条件的库成功建立连接，将尝试遍历服务名中库列表的次数，取值范围 0~2147483647，缺省 1 |
sql库 - 人大金仓数据库
人大金仓数据库连接串属性表
| 参数名 | 说明 | 备注 |
|---|---|---|
| host | 数据库服务器的地址，包括域名、主机名、主机的 IP 地址等，也可以是UNIX domain socket | 默认为localhost |
| port | 端口号 | 默认为54321 |
| user | 登录的用户名 | |
| password | 用户名的密码 | |
| dbname | 连接至的数据库名 | |
| sslmode | 是否使用SSL | 默认开启使用;可选参数为``Disable, Require, verify-ca, verify-full`` |
| sslcert | 证书路径，必须包含PEM编码数据 | |
| sslkey | 密钥文件路径，必须包含PEM编码数据 | |
| sslrootcert | 根证书路径，必须包含PEM编码数据 | |
| connect_timeout | 连接的最长等待时间，单位为秒 | 0值或未指定均为无限等待 |
模块流程
目录结构
响应请求
请求处理
请求体
响应体
时序
脚本文件
core.js - 核心函数脚本
global.js - 全局函数脚本
function.js - 脚本函数脚本
模块内置扩展库
payload 库
payload.get
{
"method": "GET",
"url": "/demo?k=v&m=n",
"path": "/demo",
"proto": "HTTP/1.1",
"proto_major": 1,
"proro_minor": 1,
"header": {
"Sec-Ch-Ua-Arch": [
"\"arm\""
],
"Sec-Ch-Ua-Platform": [
"\"macOS\""
],
"Sec-Ch-Ua-Bitness": [
"\"64\""
],
"Dnt": [
"1"
],
"User-Agent": [
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36 Edg/119.0.0.0"
],
"Sec-Fetch-Mode": [
"navigate"
],
"Dpr": [
"2"
],
"Sec-Ch-Ua-Mobile": [
"?0"
],
"Sec-Fetch-User": [
"?1"
],
"Accept-Language": [
"zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6"
],
"Viewport-Width": [
"1432"
],
"Sec-Ch-Ua-Platform-Version": [
"\"14.0.0\""
],
"Sec-Fetch-Dest": [
"document"
],
"Accept-Encoding": [
"gzip, deflate, br"
],
"Connection": [
"keep-alive"
],
"Cache-Control": [
"max-age=0"
],
"Upgrade-Insecure-Requests": [
"1"
],
"Accept": [
"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7"
],
"Sec-Fetch-Site": [
"none"
],
"If-None-Match": [
"\"fafaab8734167757e0404fd0dd40206c551f1efc\""
],
"Sec-Ch-Ua": [
"\"Microsoft Edge\";v=\"119\", \"Chromium\";v=\"119\", \"Not?A_Brand\";v=\"24\""
],
"Sec-Ch-Ua-Model": [
"\"\""
],
"Sec-Ch-Ua-Full-Version-List": [
"\"Microsoft Edge\";v=\"119.0.2151.46\", \"Chromium\";v=\"119.0.6045.105\", \"Not?A_Brand\";v=\"24.0.0.0\""
]
},
"body": [],
"content_length": 0,
"host": "127.0.0.1:8080",
"form": {},
"query": {
"k": [
"v"
],
"m": [
"n"
]
},
"remote_addr": "127.0.0.1:54201"
}payload.toCURL
payload.set
response 库
response.headers.set(key, value)
response.headers.get(key)
response.headers.add(key, value)
response.headers.del(key)
response.cookies.get(key)
response.cookies.set(key, value)
response.cookies.setRaw(cookieString)
response.cookies.del(key)
response.write(value)
response.forward(url_path)
response.body.get()
response.body.set(value)
response.status.code(code)
修改于 2025-10-29 12:18:55