用于 Spanner 共享库的节点- API 包装器
注意点: 这是一个供Google Cloud Spanner驱动软件包(如高端节点.js Spanner驱动软件)使用的内部库. 它不是供终端客户直接使用的,可以在不事先通知的情况下进行中断更改.
先决条件
- 节点.js >= 20.0.0
- 去编译器( 去构建基础共享库, 如果不是预建的话)
- C++工具链(GCC/Clang或MSVC)
安装和大楼
要建立本土的加词并汇编发展的驱动程序,运行:
npm install
关于3层编译管道(Go Link、C++节点-gyp桥和双重出版无害环境管理/CJS)的全面建筑分解,参见 Build And RELASE.md (中文(简体) ) 文档.
使用量
const { Pool, Connection } = require('spannerlib-node');
async function run() {
const pool = await Pool.create(connectionString);
const conn = await pool.createConnection();
const rows = await conn.executeSql('SELECT 1');
while (await rows.next()) {
// process rows
}
await rows.close();
await conn.close();
await pool.close();
}
建筑
包装包括:
src/cpp/addon.cc: C++ 键 处理线程边界和V8和C之间的类型转换的节点-API桥.src/ffi/utils.ts: 帮助者功能,可以同步地使用承诺来引用本地方法.src/lib/: JavaScript 类(Pool, (中文(简体) ),Connection, (中文(简体) ),Rows),提供了干净的面向对象的界面.
组件互动
包裹通过低层本土桥执行呼叫(addon.cc) (中文(简体) ). 介绍用户的班级(Pool, (中文(简体) ), Connection, (中文(简体) ), Rows)在 lib 文件夹映射执行请求输入Protobuf有效载荷,并通过同步调度器传送到桥上 utils.ts。每个成功执行返回在单通州登记处内跟踪的内存ID控件(spannerlib.ts将本地垃圾收集触发器连接起来.
组件交互和内存管理
当 JavaScript 对象( 如 Pool 或者说 Connection)是创建的,它持有一个ID来引用一个被绑定的Go对象的内存. 这个 spannerLib 单通维持一个 FinalizationRegistry。这个注册允许节点.js在JavaScript对象收集垃圾时监听 。 当 GC 发生时, 注册会自动触发本地层的清理呼叫以释放相应的 Go 对象, 防止本地内存泄露, 即使开发者忘记调用 .close() 当然.