dolphindb 3.0.225 → 3.0.229

package/browser.d.ts

@@ -423,6 +423,10 @@ export declare class DDB {
     pinvoke: Promise<DdbVoid>;
     /** 首次定义 jsrpc 的 promise，保证并发调用 rpc 时只定义一次 jsrpc */
     pjsrpc: Promise<DdbVoid>;
+    /** 函数定义缓存 */
+    definitions: Map<string, string>;
+    /** 函数定义锁，保证并发调用时不重复定义，直接返回第一次定义的结果 */
+    pdefinitions: Map<string, Promise<string>>;
     get connected(): boolean;
     /**
         使用 WebSocket URL 初始化连接到 DolphinDB 的实例（不建立实际的网络连接）
@@ -574,6 +578,17 @@ export declare class DDB {
     parse_message(buf: Uint8Array, error: DdbDatabaseError): DdbMessage;
     /** 内部的流订阅方法  Internal stream subscription method */
     subscribe(): Promise<void>;
+    /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
+        也同时作为返回值
+        - definition: 函数完整定义
+        @example
+        await ddb.invoke(
+            await ddb.define(
+                'def foo (bar) {\n' +
+                '    print(bar)\n' +
+                '}\n'),
+            ['hello']) */
+    define(definition: string): Promise<string>;
 }
 export interface DdbMessageListener {
     (message: DdbMessage, _this: DDB): any;

package/browser.js

@@ -2443,6 +2443,10 @@ export class DDB {
     pinvoke;
     /** 首次定义 jsrpc 的 promise，保证并发调用 rpc 时只定义一次 jsrpc */
     pjsrpc;
+    /** 函数定义缓存 */
+    definitions = new Map();
+    /** 函数定义锁，保证并发调用时不重复定义，直接返回第一次定义的结果 */
+    pdefinitions = new Map();
     get connected() {
         return !this.error && this.lwebsocket.resource?.readyState === WebSocket.OPEN;
     }
@@ -3159,6 +3163,35 @@ export class DDB {
             }
         })).data());
     }
+    /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
+        也同时作为返回值
+        - definition: 函数完整定义
+        @example
+        await ddb.invoke(
+            await ddb.define(
+                'def foo (bar) {\n' +
+                '    print(bar)\n' +
+                '}\n'),
+            ['hello']) */
+    async define(definition) {
+        const matches = /\bdef (\w+) \(/.exec(definition);
+        if (!matches)
+            throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式 def xxx ()'));
+        const func_name = matches[1];
+        // 已定义成功
+        if (this.definitions.has(func_name))
+            return func_name;
+        // 防止并发调用 define 时多次重复定义
+        let promise = this.pdefinitions.get(func_name);
+        if (!promise)
+            this.pdefinitions.set(func_name, promise = this.execute(definition));
+        await promise;
+        this.definitions.set(func_name, definition);
+        // 成功定义之后，definitions 中有了，就不需要通过 promise 来防止并发了，清理掉
+        // 定义失败时 rejected promise 直接作为后续调用的结果返回
+        this.pdefinitions.delete(func_name);
+        return func_name;
+    }
 }
 /** https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer#security_requirements
     SharedArrayBuffer is disabled by default in most browsers as a security precaution to avoid Spectre attacks.