Node.js 基於 V8 引擎,**單執行緒**事件迴圈架構。若 I/O 操作(讀檔、資料庫、網路請求)採用同步阻塞方式,會嚴重拖慢效能。因此 Node.js 採用**非同步回呼**模式:發起 I/O 請求後立即返回,完成時透過 callback 處理結果。
需求:讀取 `ip.json` 內的 IP 陣列 → 查詢各 IP 地理位置 → 查詢當地天氣 → 寫入 `weather.json`。所有步驟皆為非同步。
// ip.json
["115.29.230.208", "180.153.132.38", "74.125.235.224", "91.239.201.98", "60.28.215.115"]
// weather.json (預期輸出)
[
{ "ip": "115.29.230.208", "weather": "Clouds", "region": "Zhejiang" },
{ "ip": "180.153.132.38", "weather": "Clear", "region": "Shanghai" },
...
]
// callback.js
var fs = require('fs');
var request = require('request'); // npm install request
var qs = require('querystring');
function readIP(path, callback) {
fs.readFile(path, function(err, data) {
if (err) return callback(err);
try {
var ips = JSON.parse(data);
callback(null, ips);
} catch (e) {
callback(e);
}
});
}
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: '9bf4d2b07c7ddeb780c5b32e636c679d' // OpenWeatherMap API Key
};
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);
});
}
function ips2geos(ips, callback) {
var geos = [];
var remain = ips.length;
ips.forEach(function(ip) {
ip2geo(ip, function(err, geo) {
if (err) return callback(err);
geo.ip = ip; // 附加原始 IP 以便後續關聯
geos.push(geo);
if (--remain === 0) callback(null, geos);
});
});
}
function geos2weathers(geos, callback) {
var weathers = [];
var remain = geos.length;
geos.forEach(function(geo) {
geo2weather(geo.latitude, geo.longitude, function(err, weather) {
if (err) return callback(err);
weather.geo = geo;
weathers.push(weather);
if (--remain === 0) callback(null, weathers);
});
});
}
function writeWeather(weathers, callback) {
var output = weathers.map(function(w) {
return {
ip: w.geo.ip,
weather: w.weather[0].main,
region: w.geo.region
};
});
fs.writeFile('./weather.json', JSON.stringify(output, null, ' '), callback);
}
function handleError(err) { console.log('error: ' + err); }
readIP('./ip.json', function(err, ips) {
if (err) return handleError(err);
ips2geos(ips, function(err, geos) {
if (err) return handleError(err);
geos2weathers(geos, function(err, weathers) {
if (err) return handleError(err);
writeWeather(weathers, function(err) {
if (err) return handleError(err);
console.log('success!');
});
});
});
});
上述巢狀結構即為所謂「Callback Hell」。**巢狀本身不是問題**,問題在於錯誤處理分散、流程難以線性閱讀。下一篇將介紹:
理解 Callback 是掌握 Node.js 非同步基石,請務必親手執行 `node callback.js` 體驗完整流程。