DIV CSS 佈局教程網

Node.js + Ajax:跨域取得 HTTP 伺服器回傳資料實作
編輯:關於JavaScript     

用 Node.js 寫一個最簡單的 API,再讓前端頁面透過 Ajax 去抓,是理解「前後端如何對接」最直接的練習。這個範例刻意把伺服器開在 1337 埠,而頁面從另一個埠提供,因此會踩到跨域——正好可以把解法一起講清楚。

一、前端頁面

靜態頁面 index.html(務必放在伺服器環境下執行;Windows 使用者可以直接用 IIS 站台,或利用編輯器內建的靜態伺服器):

<!DOCTYPE html>
<html>
<head lang="en">
  <meta charset="UTF-8">
  <title>node 中的 ajax 請求(html5 頁面)</title>
  <script type="text/javascript">
    function GetData(){
      var xhr = new XMLHttpRequest();
      xhr.open("GET", "https://localhost:1337/", true);
      xhr.onreadystatechange = function(){
        if (xhr.readyState == 4) {
          if (xhr.status == 200) {
            document.getElementById("res").innerHTML = xhr.responseText;
          }
        }
      };
      xhr.send(null);
    }
  </script>
</head>
<body>
  <input type="button" value="獲取數據" onclick="GetData()" />
  <div id="res"></div>
</body>
</html>

二、Node 服務端

var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    res.writeHead(200, {
      "Content-Type": "text/plain",
      "Access-Control-Allow-Origin": "https://localhost"
    });
    res.write("你好啊!");
  }
  res.end();
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽...");
});

關鍵就在 Access-Control-Allow-Origin 這個回應標頭:它明確告知瀏覽器「允許哪個來源讀取我的回應」。若省略埠號,則該網域下的任何埠都獲准。

先啟動服務:

node server.js

再開啟靜態頁面:

點擊「獲取數據」按鈕:

三、不想架伺服器?借用編輯器的內建服務

以 WebStorm 8.0 為例,啟動頁面後網址會類似 https://localhost:63342/,埠號是 63342。這時只要把服務端的白名單改成對應來源即可:

var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    res.writeHead(200, {
      "Content-Type": "text/plain",
      "Access-Control-Allow-Origin": "https://localhost:63342"
    });
    res.write("你好啊!");
  }
  res.end();
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽...");
});

重新執行 demo,效果相同。

四、改用 setHeader 逐項設定

var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    res.setHeader("Content-Type", "text/plain");
    res.setHeader("Access-Control-Allow-Origin", "https://localhost:63342");
    res.write("你好啊!");
  }
  res.end();
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽...");
});

仔細的人會發現:用 setHeader 時沒有地方寫狀態碼。狀態碼要另外指定:

res.statusCode = 200;

順帶一提,Node 預設會送出 Date 標頭:

若不希望暴露伺服器時間,可以關掉:

var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    res.statusCode = 200;
    res.sendDate = false;
    res.setHeader("Content-Type", "text/plain");
    res.setHeader("Access-Control-Allow-Origin", "https://localhost:63342");
    res.write("你好啊!");
  }
  res.end();
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽...");
});

狀態碼設好了,日期資訊也一併隱藏。

五、幾個常用的回應物件方法

  • res.getHeader(name):讀取已設定的回應標頭
  • res.removeHeader(name):刪除標頭,必須在 write 送出資料之前呼叫
  • res.headersSent:布爾值,回應標頭已送出為 true,否則為 false
var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    console.log(res.headersSent ? "響應頭已發送" : "響應頭未發送");
    res.writeHead(200, {
      "Content-Type": "text/plain",
      "Access-Control-Allow-Origin": "https://localhost:63342"
    });
    console.log(res.headersSent ? "響應頭已發送" : "響應頭未發送");
    res.write("你好啊!");
  }
  res.end();
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽...");
});

執行結果:

可以看見第一次輸出是「未發送」,writeHead 之後就變成「已發送」。

六、res.write 的返回值有什麼意義

res.write() 用來送出資料,但它其實會回傳一個布爾值,反映的是背壓(backpressure)狀態:

  • 資料量小或網速快時,Node 會直接把資料交給作業系統核心緩衝區,此時回傳 true;
  • 資料量大或網速慢時,Node 會先把資料積在記憶體中,等對方才吃得下,此時回傳 false。

想驗證的話,調整要輸出的檔案大小再觀察即可。

認真處理時,收到 false 就該等待 drain 事件再繼續寫入,否則大量資料會持續堆積在記憶體裡。

小結

一個可用的 Node + Ajax 最小範例就到這裡。跨域標頭、狀態碼、標頭操作、背壓判斷,這四件事理解之後,再往複雜的情境推進會順手很多。

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