事情的起因很簡單:有人在社群裡拋出一個問題——「如果要用 Node.js 連接 SQL Server,該怎麼辦?」沿著這個方向查找資料後,大致整理出兩條可行路線:一是採用社群開發的第三方套件(例如 node-tds 這類 TDS 實作),二是直接走 Windows 平台的老路子,透過 ADODB.Connection 這個 ActiveX 物件來完成連線。
仔細想想,如果 ActiveX 這條路走得通,那麼在 Windows 環境底下,Node.js 幾乎可以無所不能,開發體驗也會變得跟早年寫 ASP 有幾分相似。問題是:這兩個世界彼此並不認識,它們之間到底靠什麼溝通?與其空想,不如動手實驗。
核心策略是:讓 Node.js 透過 cscript.exe(Windows 的指令碼執行個體)間接存取 ActiveX。cscript 能解析 JScript 與 VBScript 兩種指令碼,考量到後續維護的便利性,選擇語法更接近 JavaScript 的 JScript 來開發。
較新版本的 Node.js 已經內建對子行程的操作能力,因此跨行程通訊本身並不算障礙。關鍵在於如何取得子行程的輸出:
var util = require('util'),
exec = require('child_process').exec,
child;
child = exec('cat *.js bad_file | wc -l',
function (error, stdout, stderr) {
console.log('stdout: ' + stdout);
console.log('stderr: ' + stderr);
if (error !== null) {
console.log('exec error: ' + error);
}
});
如範例所示,我們可以從回呼函式裡拿到主控台的輸出內容 stdout,這正是資料回流的路徑。
var connection = new ActiveXObject("ADODB.Connection");
var result = 'ok';
try{
connection.Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + params.accessfile);
connection.Execute(params.sql);
} catch(ex){
result = ex.message;
}
return {
result: result
};
只要替換 connection.Open 的連接字串參數,同一套寫法也能用來存取 SQL Server,可參考各資料庫的連接字串範例。
為了避免維護兩份程式碼,特別把 cscript 與 Node.js 的邏輯合併在同一個檔案中,並以 typeof exports 判斷目前的執行環境,讓同一份程式碼在兩種環境下各取所需。
cscript 端一律採用 ASCII 編碼,遇到非 ASCII 字元則轉為 \uHHHH 形式的 Unicode 轉義,藉此避開編碼不一致造成的亂碼。
雙引號與百分比符號在命令列中具有特殊意義,直接傳遞容易出錯。解法是把參數先做 Base64 編碼再傳入,从根本上迴避衝突。而在 cscript 環境中,正好可以借重 MSXML2.DOMDocument 完成 Base64 的解碼:
function base64Decode(base64){
var xmldom = new ActiveXObject("MSXML2.DOMDocument");
var adostream = new ActiveXObject("ADODB.Stream");
var temp = xmldom.createElement("temp");
temp.dataType = "bin.base64";
temp.text = base64;
adostream.Charset = "utf-8";
adostream.Type = 1; // 1=adTypeBinary 2=adTypeText
adostream.Open();
adostream.Write(temp.nodeTypedValue);
adostream.Position = 0;
adostream.Type = 2; // 1=adTypeBinary 2=adTypeText
var result = adostream.ReadText(-1); // -1=adReadAll
adostream.Close();
adostream = null;
xmldom = null;
return result;
}
1、建立子行程,並傳入經過編碼的參數;
2、子行程處理完畢後,把結果以 JSON 格式化輸出到主控台,接著自行結束;
3、讀取主控台的輸出資料,執行回呼函式。
1、讓 Node.js 具備了存取 ActiveX 物件的能力;
2、實作門檻低,開發與維護都相當直觀。
1、只能運行於 Windows 平台;
2、資料的編解碼會額外消耗 CPU 資源;
3、每次呼叫都得建立一個新的子行程並重新連線(這一點仍有優化空間)。
整體而言,這個方案具備一定的實用價值,而跨行程通訊的效能表現,仍有值得繼續深挖的地方。
var Access = {
create: function(params){
var fso = new ActiveXObject("Scripting.FileSystemObject");
var result = 'ok';
if (!fso.FileExists(params.accessfile)){
var adoxcatalog = new ActiveXObject("ADOX.Catalog");
try {
adoxcatalog.Create("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + params.accessfile);
} catch(ex) {
result = ex.message;
return;
}
adoxcatalog = null;
} else {
result = 'exists';
}
return {
result: result
};
},
existsTable: function(params){
var connection = new ActiveXObject("ADODB.Connection");
var result = 'ok', exists = false;
try{
connection.Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + params.accessfile);
var recordset = connection.OpenSchema(20/*adSchemaTables*/);
recordset.MoveFirst();
while (!recordset.EOF){
if (recordset("TABLE_TYPE") == "TABLE" && recordset("TABLE_NAME") == params.tablename){
exists = true;
break;
}
recordset.MoveNext();
}
recordset.Close();
recordset = null;
} catch(ex){
result = ex.message;
}
return {
"result": result,
"exists": exists
};
},
execute: function(params){
var connection = new ActiveXObject("ADODB.Connection");
var result = 'ok';
try{
connection.Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + params.accessfile);
connection.Execute(params.sql);
} catch(ex){
result = ex.message;
}
return {
result: result
};
},
query: function(params){
var connection = new ActiveXObject("ADODB.Connection");
var result = 'ok', records = [];
try{
connection.Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + params.accessfile);
var recordset = new ActiveXObject("ADODB.Recordset");
recordset.Open(params.sql, connection);
var fields = [];
var enumer = new Enumerator(recordset.Fields);
for (; !enumer.atEnd(); enumer.moveNext()){
fields.push(enumer.item().name);
}
recordset.MoveFirst();
while (!recordset.EOF) {
var item = {};
for (var i = 0; i < fields.length; i++){
var fieldname = fields[i];
item[fieldname] = recordset(fieldname).value;
}
records.push(item);
recordset.MoveNext();
}
recordset.Close();
recordset = null;
} catch(ex){
result = ex.message;
}
return {
result: result,
records: records
};
}
};
在 cscript 分支中,還需要自備一份 JSON 序列化與 Base64 解碼的實作,並透過 WScript.StdOut 把結果包在 <json>...</json> 標記之間輸出;Node.js 分支則負責把參數序列化、Base64 編碼後交給 cscript,再从 stdout 中擷取 JSON 並解析回物件。完整的原始碼可於公開的程式碼範例庫中查閱。
var access = require('./access.js');
var util = require('util');
var accessfile = 'demo.mdb';
access.create({ accessfile: accessfile }, function(data){
console.log(data);
});
access.existsTable({ accessfile: accessfile, tablename: 'demo' }, function(data){
if (data.result == 'ok' && !data.exists){
access.execute({
accessfile: 'demo.mdb',
sql: "CREATE TABLE demo(id Counter Primary key, data Text(100))"
});
}
});
access.execute({
accessfile: 'demo.mdb',
sql: util.format("INSERT INTO demo(data) VALUES('zswang 路過!%s')", +new Date)
}, function(data){
console.log(data);
});
access.query({
accessfile: 'demo.mdb',
sql: "SELECT * FROM demo"
}, function(data){
console.log(data);
});