DIV CSS 佈局教程網

Node.js 非同步程式設計入門(一):把 Callback 寫到你能接受的程度
編輯:關於JavaScript     

Node.js 建立在 V8 之上,是單執行緒的。為了不讓讀檔、查資料庫、發 HTTP 請求這些 I/O 操作把整個流程卡死,Node 採用了事件驅動的非同步模型。對從其他語言搬過來的開發者而言,這是最容易水土不服的一塊。

這個系列會由淺入深,從 callback 一路談到 thunk、Promise、co,直到 ES7 的 async/await。本篇先把最原始的 callback 寫法講透。

一、任務:查多個 IP 所在地的天氣

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" },
  { "ip": "180.153.132.38", "weather": "Clear", "region": "Shanghai" },
  { "ip": "74.125.235.224", "weather": "Rain", "region": "California" },
  { "ip": "60.28.215.115", "weather": "Clear", "region": "Tianjin" }
 ]

拆成四步:讀 IP → 查地理位置 → 查天氣 → 寫檔。為了練習,這裡全部用非同步 API。

二、引入模組

 // callback.js
 var fs = require('fs')
 var request = require('request')
 var qs = require('querystring')

三、讀檔並解析 JSON

 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)
      }
    }
  })
}

注意 callback 的簽名:callback(err, data)。成功時 err 為 null,失敗時只回 err。這就是 Node 的錯誤優先(error-first)慣例。

四、兩個查詢函式

 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: 'your-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

這是最關鍵的一段。五個 IP 要同時查,不能一個等一個,所以我們用計數器 remain 來判斷「全部完成了沒」:

 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) {   // 用 IIFE 鎖定迴圈變數
      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 geos2weathers(geos, callback) {
  var weathers = []
  var geo
  var remain = geos.length
  for (var i = 0; i < geos.length; i++) {
    geo = geos[i];
    (function(geo) {
      geo2weather(geo.latitude, geo.longitude, function(err, weather) {
        if (err) {
          callback(err)
        } else {
          weather.geo = geo
          weathers.push(weather)
          remain--
        }
        if (remain == 0) {
          callback(null, weathers)
        }
      })
    })(geo)
  }
}

六、寫檔

 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)
}

七、串起來

最直覺的寫法是巢狀:

 function handlerError(err) { console.log('error: ' + err) }

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!') }
            })
          }
        })
      }
    })
  }
})

很多人一看就說「這就是 callback地獄」。但其實把它攤平成具名函式就清楚多了:

 function ReadIPCallback(err, ips) {
  if (err) { handlerError(err) } else { ips2geos(ips, ips2geosCallback) }
}
function ips2geosCallback(err, geos) {
  if (err) { handlerError(err) } else { geos2weathers(geos, geos2weathersCallback) }
}
function geos2weathersCallback(err, weathers) {
  if (err) { handlerError(err) } else { writeWeather(weathers, writeWeatherCallback) }
}
function writeWeatherCallback(err) {
  if (err) { handlerError(err) } else { console.log('success!') }
}

readIP('./ip.json', ReadIPCallback)

執行 node callback.js 後就會產生 weather.json。

八、問題到底在哪

攤平之後你會發現,巢狀根本不是核心痛點。真正的問題是:非同步本質上要處理三件事——

1. 什麼時候結束?需要一個通知機制,callback 就是一種答案。
2. 結果怎麼傳回來?callback 透過參數把資料回傳。
3. 出錯怎麼辦?callback 透過 err 參數回報。

而這三件事在每個函式裡都要重複寫一遍 if (err) ... else ...。這種「樣板程式」才是真正令人痛苦的部分,也是後續 Promise、async/await 想解決的目標。

另外提醒:範例中的第三方服務(telize、openweathermap)與 request 套件如今多已停止維護或需自行申請金鑰,實作時請替換為現行可用的服務與 fetch/axios。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved