Node.js 基於 V8 引擎,是單線程的,並採用異步方式處理會造成阻塞的 I/O 操作。對於從其他語言遷移過來的開發者來說,異步編程往往是最"痛苦"的一環。本篇作為系列首篇,從最基礎的 callback 講起,後續還會談到 thunk、Promise、co 乃至 ES7 的 async/await。
假設 ip.json 中存放了若干 IP 地址:
代碼如下:
// ip.json
["115.29.230.208", "180.153.132.38", "74.125.235.224", "91.239.201.98", "60.28.215.115"]
我們希望查出每個 IP 所在地的天氣,並寫入 weather.json:
代碼如下:
// weather.json
[ { "ip": "115.29.230.208", "weather": "Clouds", "region": "Zhejiang" }, ... ]
整個流程可分四步:1. 讀取 IP;2. 由 IP 查地理位置;3. 由地理位置查天氣;4. 寫入文件。這幾步都是異步的。
先借助三個基礎模塊:fs(讀寫文件)、request(發 HTTP 請求)、querystring(組裝 URL 參數)。新建 callback.js:
代碼如下:
var fs = require('fs')
var request = require('request')
var qs = require('querystring')
讀取文件中的 IP 列表:
代碼如下:
function readIP(path, callback) {
fs.readFile(path, function(err, data) {
if (err) { callback(err) }
else { try { data = JSON.parse(data); callback(null, data) } catch (error) { callback(error) } }
})
}
用 IP 獲取地理位置,用 geo 獲取天氣:
代碼如下:
function ip2geo(ip, callback) {
var url = 'https://www.telize.com/geoip/' + ip
request({ url: url, json: true }, function(err, resp, body) { callback(err, body) })
}
function geo2weather(lat, lon, callback) {
var params = { lat: lat, lon: lon, APPID: '...' }
var url = 'https://api.openweathermap.org/data/2.5/weather?' + qs.stringify(params)
request({ url: url, json: true }, function(err, resp, body) { callback(err, body) })
}
由於 IP 有多個,需要並行請求。這裡用一個 remain 計數器記錄未返回的數量,減到 0 表示全部完成:
代碼如下:
function ips2geos(ips, callback) {
var geos = []; var ip; var remain = ips.length
for (var i = 0; i < ips.length; i++) {
ip = ips[i];
(function(ip) {
ip2geo(ip, function(err, geo) {
if (err) { callback(err) }
else { geo.ip = ip; geos.push(geo); remain-- }
if (remain == 0) { callback(null, geos) }
})
})(ip)
}
}
最後把結果寫入文件:
代碼如下:
function writeWeather(weathers, callback) {
var output = []
for (var i = 0; i < weathers.length; i++) {
var weather = weathers[i]
output.push({ ip: weather.geo.ip, weather: weather.weather[0].main, region: weather.geo.region })
}
fs.writeFile('./weather.json', JSON.stringify(output, null, ' '), callback)
}
把這些函數串起來:
代碼如下:
readIP('./ip.json', function(err, ips) {
if (err) { handlerError(err) }
else { ips2geos(ips, function(err, geos) {
if (err) { handlerError(err) } else { geos2weathers(geos, function(err, weathers) {
if (err) { handlerError(err) } else { writeWeather(weathers, function(err) {
if (err) { handlerError(err) } else { console.log('success!') }
}) }
}) }
}) }
})
你可能會皺眉:這嵌套也太多了吧!但別急,嵌套並不是異步的真正問題。我們可以把它拆成一個個具名回調函數:
代碼如下:
function ReadIPCallback(err, ips) {
if (err) { handlerError(err) } else { ips2geos(ips, ips2geosCallback) }
}
function ips2geosCallback(err, geos) {
if (err) { handlerError(err) } else { geos2weathers(geos, geos2weathersCallback) }
}
readIP('./ip.json', ReadIPCallback)
那真正的問題是什麼?其實就是異步本身。異步本質上要處理三件事:1. 操作何時結束,需要通知回來——callback 就是一種方案;2. 結果要傳回來——callback 通過 data 參數傳數據;3. 出錯了怎麼辦——callback 通過 err 參數傳錯誤。理解這三點,就抓住了 Node.js 異步編程的核心。