Node.js - 工具模組

在這篇文章中，我們將討論一些Node.js庫提供的工具模組，這是非常常見的，經常使用在整個應用程式中。

Sr.No.	模組的名稱和說明
1	Console 用於列印輸出和錯誤資訊
2	Process 用於獲取當前進程的資訊，提供處理相關活動的多個事件
3	OS Module 提供基本的作業系統相關的實用功能
4	Path Module 實用工具提供用於處理和轉化檔案路徑
5	Net Module 提供伺服器和用戶端的資料流。作為一個網路應用包
6	DNS Module 提供的功能做實際的DNS查詢，以及使用底層作業系統的名稱解析功能
7	Domain Module 提供一種方式來處理多個不同的I/O操作為一個組

Node.js - 控制台

 

 

方法

Sr. No.	方法	描述
1	console.log([data][, ...])	列印及帶有換行符到stdout，此函式可將多個引數在printf()類似的方式
2	console.info([data][, ...])	列印及帶有換行符到stdout，此函式可將多個引數在printf()類似的方式
3	console.error([data][, ...])	列印及帶有換行符到stderr，此函式可將多個引數在printf()類似的方
4	console.warn([data][, ...])	列印及帶有換行符到stderr，此函式可將多個引數在printf()類似的方式
5	console.dir(obj[, options])	使用util.inspect在obj和生成的字串列印到stdout
6	console.time(label)	標記時間
7	console.timeEnd(label)	完成定時，記錄輸出
8	console.trace(message[, ...])	列印到stderr“Trace :'，其次是格式化的訊息和堆疊跟蹤到當前位置
9	console.assert(value[, message][, ...])	類似於assert.ok()，但錯誤資訊被格式化為util.format(message...)

範例

建立一個js檔案名為test.js 在目錄 D:\>yiibai_worksp\nodejs

File: test.js

var counter = 10;

console.log("Counter: %d", counter);

console.time("Getting data");
//make a database call to retrive the data
//getDataFromDataBase();
console.timeEnd('Getting data');

console.info("Program Ended!")

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs> node test.js

驗證輸出

Counter: 10
Getting data: 0ms
Program Ended!

Node.js - 進程

process 是一個全域性性物件，並用於表示Node進程。

退出碼

節點正常退出時帶狀態0碼，在沒有更多的非同步操作掛起時。其他退出程式碼描述如下：

Code	名稱	描述
1	未捕獲致命異常	有一個未捕獲的異常，它不是由域或uncaughtException事件處理程式處理
2	未使用	通過對於Bash濫用內建保留
3	內部的JavaScript解析錯誤	JavaScript原始碼，在內部Node引導過程引起了解析錯誤。這是極為罕見的，一般只是在Node本身的開發過程中才發生的。
4	內部的JavaScript評估計算失敗	JavaScript原始碼，在內部Node的引導過程未能評估計算時返回一個函式值。這是極為罕見的，一般只是在Node本身的開發過程中發生的。
5	致命錯誤	在V8中的一個致命不可恢復的錯誤。通常情況下一個訊息將被列印到stderr使用字首致命錯誤。
6	非函式內部例外處理程式	有一個未捕獲的異常，但內部致命的例外處理函式被莫名其妙地設定為一個非函式，並且不能被呼叫。
7	內部例外處理程式執行時故障	這裡是一個未捕獲的異常，並試圖處理它內部的致命的例外處理函式本身丟擲一個錯誤。
8	未使用
9	無效的引數	要麼未知選項指定，或沒有值時需要提供一個值的選項。
10	內部的JavaScript執行時故障	JavaScript原始碼，在內部Node引導過程中丟擲一個錯誤，當引導函式被呼叫。這是極為罕見的，一般Node是在開發過程中發生的。
12	無效的偵錯引數	--debug和/或--debug-brk選項都設定，但不能選擇無效的埠號。
>128	信號退出	如果Node接收到一個致命信號如SIGKILL或SIGHUP，然後它的退出程式碼是128加上的信號程式碼的值。這是一個標準Unix，實際上由於退出程式碼被定義為7位整數，信號退出設定的高序位，包含所述信號的程式碼值。

事件

Process（進程）是一個eventEmitter，並且它發出下列事件

Sr.No.	Event	描述
1	exit	發射當進程即將退出。沒有辦法來防止事件迴圈退出在這一點上， 並且一旦所有的退出監聽器執行完成，程式將退出。
2	beforeExit	當Node清空它的事件迴圈，並沒有其他事情安排此事件被發射。通常情況下，當沒有預定的工作Node退出，但是一個監聽'beforeExit'可進行非同步呼叫，並導致Node繼續。
3	uncaughtException	發射當異常冒泡一路回到事件迴圈。如果一個監聽器新增了此異常，則預設操作（這是列印堆疊跟蹤並退出）不會發生。
4	Signal Events	發射當進程接收到信號，例如SIGINT，SIGHUP等

屬性

Process（進程）提供了許多有用的特性，以更好地控制系統的相互作用。

Sr.No.	屬性	描述
1	stdout	可寫流到標準輸出
2	stderr	可寫流到stderr
3	stdin	可寫流標準輸入
4	argv	包含命令列引數陣列。第一元件將是“節點”，第二個元素是JavaScript檔案的名稱。接下來元素的內容是額外的命令列引數
5	execPath	這是啟動進程的可執行檔案的絕對路徑
6	execArgv	這是一組Node特定的命令列選項從可執行啟動進程
7	env	包含使用者環境的物件
8	exitCode	許多可作為進程退出程式碼優雅地退出，或者是通過process.exit()無需指定程式碼退出
9	version	編譯時屬性暴露NODE_VERSION
10	versions	屬性用來暴露node及其依賴的版本字串
11	config	物件包含JavaScript用來表示編譯當前Node可執行的組態選項能力。這是類似於“config.gypi”檔案，所產生在./configure指令碼執行時
12	pid	進程的PID
13	title	getter/setter設定 'ps' 所顯示
14	arch	在什麼處理器架構上執行： 'arm', 'ia32', 或 'x64'
15	platform	正在執行在什麼平台： 'darwin', 'freebsd', 'linux', 'sunos' 或 'win32'
16	mainModule	備選的方法來檢索require.main。不同的是，如果主模組改變在執行時，require.main仍可能指的是原來的主模組中被要求的變化發生之前的模組。通常它是安全假設的，這兩個指的是相同的模組

方法

Process（進程）提供了許多有用的方法，以更好的控制系統的相互作用。

Sr.No.	方法	描述
1	abort()	這導致node發出中止。node退出並生成一個核心檔案
2	chdir(directory)	改變進程的當前工作目錄，或如果失敗將引發異常
3	cwd()	返回進程的當前工作目錄
4	exit([code])	終止使用指定的程式碼進程。如果省略，退出使用'成功'的程式碼0
5	getgid()	獲取行程群組標識，這是數值組ID，而不是組名。此函式僅適用於POSIX平台（即非Windows，Android）。
6	setgid(id)	設定行程群組的標識。 (詳看setgid(2).) 這要麼接受一個數位ID或組名字串。如果指定了組名，則此方法阻塞在解析到一個數位ID。此函式僅適用於POSIX平台（即非Windows，Android）。
7	getuid()	獲取進程的使用者身份。這是數位ID，而不是使用者名。此函式僅適用於POSIX平台（即非Windows，Android）。
8	setuid(id)	設定進程的使用者的身份。（請參閱setgid（2））。這接受一個數位ID或使用者名字串。如果指定一個使用者名，這個方法會阻塞，同時解析到一個數位ID。此函式僅適用於POSIX平台（即非Windows，Android）。
9	getgroups()	返回帶有補充組ID的陣列。POSIX離開未指定是否該有效組ID包函，而Node.js保證它始終是。此函式僅適用於POSIX平台（即非Windows，Android）。
10	setgroups(groups)	設定輔助組標識。這是一個許可權操作，這意味著需要以root或具有CAP_SETGID許可權。此函式僅適用於POSIX平台（即非Windows，Android）。
11	initgroups(user, extra_group)	讀取/etc/group檔案並初始化組存取列表，使用所有這些組的使用者是其成員。這是一個許可權操作，這意味著需要以root或具有CAP_SETGID權力。此函式僅適用於POSIX平台（即非Windows，Android）。
12	kill(pid[, signal])	傳送信號給一個進程。pid是進程ID和信號描述傳送信號的字串。信號的名字就像'SIGINT'或'SIGHUP'字串。如果省略，信號是'SIGTERM'。
13	memoryUsage()	返回描述以位元組為單位的Node進程的記憶體使用量的物件
14	nextTick(callback)	一旦當前事件迴圈轉到執行結束，呼叫回撥函式
15	umask([mask])	設定或讀取進程的檔案模式建立掩碼。子進程繼承父進程的掩碼。返回老掩碼如果掩碼引數給出，否則返回當前掩碼
16	uptime()	Node已經執行的秒數
17	hrtime()	返回當前高解析度實時在[seconds, nanoseconds] 元組。它是相對於過去的任意時間。它是不相關的一天中的時間，因此，不會受到時鐘偏移。 主要用途是用於測量時間間隔之間的效能。

範例

建立一個js檔案名為test.js 在目錄 D:\>yiibai_worksp\nodejs

File: test.js

var util = require('util');

//printing to console
process.stdout.write("Hello World!" + "\n");

//reading passed parameter
process.argv.forEach(function(val, index, array) {
   console.log(index + ': ' + val);
});

//executable path
console.log(process.execPath);

//print the current directory
console.log('Current directory: ' + process.cwd());
	
//print the process version
console.log('Current version: ' + process.version);

//print the memory usage
console.log(util.inspect(process.memoryUsage()));

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs> node test.js

驗證輸出：

Hello World!
0: node
1: D:\yiibai_worksp\nodejs\test.js
D:\yiibai_worksp\nodejs\node.exe
Current directory: D:\yiibai_worksp\nodejs
Current version: v0.12.7
{ rss: 16379904, heapTotal: 9751808, heapUsed: 4067896 }

Node.js - OS 模組

os模組用於一些基本的作業系統相關的實用功能。os模組可以使用以下語法匯入。

var os = require("os")

方法

Sr. No.	方法	描述
1	os.tmpdir()	返回臨時檔案作業系統的預設目錄
2	os.endianness()	返回CPU的儲存方式。可能的值是“BE”或“LE”
3	os.hostname()	返回作業系統的主機名
4	os.type()	返回作業系統名稱
5	os.platform()	返回作業系統平台
6	os.arch()	返回作業系統的CPU架構。可能的值是“64”，“arm”和“ia32”
7	os.release()	返回作業系統版本
8	os.uptime()	返回系統正常執行時間（秒）
9	os.loadavg()	返回包含1，5和15分鐘的負載量平均值的陣列
10	os.totalmem()	返回以位元組系統儲存器的總量
11	os.freemem()	返回可用系統記憶體量（位元組）
12	os.cpus()	返回一個包含每個已安裝的CPU/核心的資訊物件的陣列：model, speed (in MHz),和時間（含有用在CPU/核心的毫秒數量的物件：user, nice, sys, idle, and irq).
13	os.networkInterfaces()	得到的網路介面的列表

屬性

Sr. No.	屬性	描述
1	os.EOL	作業系統限定行尾的適當標記的常數

範例

建立一個js檔案名為test.js 在 D:\>yiibai_worksp\nodejs 

File: test.js

var os = require("os");

//endianness
console.log('endianness : ' + os.endianness());

//type
console.log('type : ' + os.type());

//platform
console.log('platform : ' + os.platform());

//totalmem
console.log('total memory : ' + os.totalmem() + " bytes.");

//freemem
console.log('free memory : ' + os.freemem() + " bytes.");

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs> node test.js

驗證輸出：

endianness : LE
type : Windows_NT
platform : win32
total memory : 4201889792 bytes.
free memory : 1233211392 bytes.

Node.js - Path 模組

path 模組用於處理和轉換檔案路徑。path模組可以使用以下語法匯入。

var path = require("path")

屬性

進程提供了許多有用的特性，以獲得更好的控制系統的相互作用。

Sr.No.	屬性	描述
1	path.sep	特定於平台的檔案分隔符 '\\' 或 '/'.
2	path.delimiter	特定於平台的路徑分隔符, ; 或 ':'.
3	path.posix	提供存取路徑上述方法，但始終在POSIX相容的方式進行互動
4	path.win32	提供存取路徑上述方法，但總是在Win32相容的方式進行互動

方法

Sr. No.	方法	描述
1	path.normalize(p)	規範化字串路徑，採用'..'和'.'部分
2	path.join([path1][, path2][, ...])	連線所有引數一起和規範生成的路徑
3	path.resolve([from ...], to)	解析到一個絕對路徑
4	path.isAbsolute(path)	確定路徑是否是一個絕對路徑。絕對路徑將始終解析到相同的位置，而不考慮工作目錄
5	path.relative(from, to)	解決相對路徑從from到to
6	path.dirname(p)	返回路徑的目錄名稱，類似於Unix的目錄名的命令。
7	path.basename(p[, ext])	返回路徑的最後部分，類似於UNIX命令基名。
8	path.extname(p)	返回路徑的擴充套件，從最後一個“.”結束到字串在路徑的最後部分。如果沒有'.'在路徑最後部分或第一個字元的是“.”，那麼它返回一個空字串。
9	path.parse(pathString)	從路徑字串返回物件
10	path.format(pathObject)	從一個物件返回 path.parse上述相反的路徑字串

範例

建立一個js檔案名為test.js 在 D:\>yiibai_worksp\nodejs

File: test.js

var path = require("path");

//normalization
console.log('normalization : ' + path.normalize('/test/test1//2slashes/1slash/tab/..'));

//join
console.log('joint path : ' + path.join('/test', 'test1', '2slashes/1slash', 'tab', '..'));

//resolve
console.log('resolve : ' + path.resolve('test.js'));

//extName
console.log('ext name : ' + path.extname('test.js'));

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs> node test.js

驗證輸出：

normalization : \test\test1\2slashes\1slash
joint path : \test\test1\2slashes\1slash
resolve : D:\yiibai_worksp\nodejs\test.js
ext name : .js

Node.js - Net模組

net 模組是用來建立伺服器和用戶端。它提供了一個非同步網路包裝。 net模組可以使用以下語法匯入。

var net = require("net")

方法

Sr. No.	方法	描述
1	net.createServer([options][, connectionListener])	建立一個新的TCP伺服器。connectionListener引數自動設定為監聽器的'連線'事件
2	net.connect(options[, connectionListener])	工廠方法，它返回一個新的“net.Socket”，並連線到提供的地址和埠
3	net.createConnection(options[, connectionListener])	工廠方法，它返回一個新的“net.Socket”，並連線到提供的地址和埠
4	net.connect(port[, host][, connectListener])	建立於主機的TCP連線埠。如果省略主機，預設使用“localhost”。connectListener引數將作為一個監聽器“連線”事件。它返回一個新的“net.Socket”工廠方法
5	net.createConnection(port[, host][, connectListener])	建立於主機的TCP連線埠。如果省略主機，預設是“localhost”。 connectListener引數將作為一個監聽器“連線”事件。它返回一個新的“net.Socket”工廠方法
6	net.connect(path[, connectListener])	建立Unix通訊端連線路徑。connectListener引數將作為一個監聽器“連線”事件。工廠方法返回一個新的“net.Socket”
7	net.createConnection(path[, connectListener])	建立Unix通訊端連線路徑，connectListener引數將作為一個監聽器“連線”事件。工廠方法返回一個新的“net.Socket”
8	net.isIP(input)	測試輸入是否為IP地址，返回0則是無效的字串，返回4則是IP版本4的地址， 返回6 則是IP版本6的地址
9	net.isIPv4(input)	返回true，如果輸入的是版本4的IP地址，否則返回false
10	net.isIPv6(input)	返回true，如果輸入的是版本6的IP地址，否則返回false

Class:net.Server

此類用於建立TCP或本地伺服器。

方法

Sr. No.	方法	描述
1	server.listen(port[, host][, backlog][, callback])	開始接受指定的埠和主機上的連線。如果省略主機，伺服器將接受針對任何IPv4地址（INADDR_ANY）連線，埠值為0時將分配一個隨機埠
2	server.listen(path[, callback])	啟動本地socket伺服器監聽給定的路徑上的連線
3	server.listen(handle[, callback])	控制代碼物件可以被設定為一個伺服器或socket（下面_handle構件任何東西），或一個{fd:<n>}物件。這將導致伺服器接受指定控制代碼連線，但可以推測該檔案描述符或控制代碼已被系結到埠或域通訊端。監聽檔案描述符在Windows上不支援。
4	server.listen(options[, callback])	port，host和backlog選項的屬性，以及可選callback 函式，這些做一個呼叫 server.listen(port, [host], [backlog], [callback]) 。或者，可使用的路徑選項指定一個UNIX通訊端。
5	server.close([callback])	最終關閉時結束所有連線和伺服器發出一個“關閉”事件
6	server.address()	作業系統返回伺服器的系結地址，所述地址族名稱和埠。
7	server.unref()	在伺服器上呼叫unref將允許程式退出，如果這是在事件系統中唯一的活動伺服器。如果伺服器已經unrefd再次呼叫unref將無任何作用。
8	server.ref()	與unref相反，如果它是僅存的伺服器（預設行為）呼叫ref在unrefd之前伺服器不會讓程式退出。如果伺服器refd呼叫再次ref不會有任何效果。
9	server.getConnections(callback)	非同步獲取伺服器上的並行連線數量。 當通訊端被送往forks。回撥函式應該用兩個引數 err和count。

事件

Sr. No.	事件	描述
1	listening	發射在伺服器系結呼叫server.listen後
2	connection	當一個新的連線建立時發射。Socket物件，連線物件提供給事件處理。Socket是net.Socket的一個範例。
3	close	伺服器關閉時發出。需要注意的是，如果連線存在，這個事件是不會發射的，直到所有的連線都結束。
4	error	當錯誤發生時發出。 “關閉”將被直接呼叫此事件之後。

Class:net.Socket

這個物件是一個TCP或本地通訊端的抽象。net.Socket的範例實現全雙工流介面。它們可以由使用者建立，並用作一個用戶端（使用connect()），也可以由Node建立並通過伺服器的'連線'事件傳遞給使用者。

事件

net.Socket是一個eventEmitter，它發出下列事件。

Sr.No.	事件	描述
1	lookup	解析主機名之後，但在連線之前發射。不適用於Unix通訊端
2	connect	當成功建立一個通訊端連線時發射
3	data	當接收資料時發射。引數資料將是一個緩衝或字串。重新編碼的資料是通過socket.setEncoding()設定的
4	end	當通訊端的另一端傳送一個FIN包發射
5	timeout	如果通訊端超閒置時發射。這是唯一的，以通知通訊端已經空閒。使用者必須手動關閉連線
6	drain	當寫緩衝區變空時發射。可用於限制上傳
7	error	當錯誤發生時發射，“關閉”事件將被直接稱為繼此事件。
8	close	當通訊端被完全關閉時發射，引數had_error是一個布林值，指明如果通訊端是由於傳輸錯誤關閉。

屬性

net.Socket提供了許多有用的特性，以更好的控制通訊端的相互作用。

Sr.No.	屬性	描述
1	socket.bufferSize	此屬性表示要寫入當前緩衝的字元數
2	socket.remoteAddress	遠端IP地址的字串表示。例如， '74.125.127.100' 或 '2001:4860:a005::68'
3	socket.remoteFamily	遠端IP系列（簇）的字串表示。 'IPv4' 或 'IPv6'
4	socket.remotePort	遠端埠的數位表示。例如，80 或 21
5	socket.localAddress	遠端用戶端連線到原生的IP地址的字串表示。例如，如果正在在“0.0.0.0”監聽，用戶端連線到 '192.168.1.1', 那麼它的值就是 '192.168.1.1'
6	socket.localPort	本地埠的數位表示。例如，80 或 21
7	socket.bytesRead	接收的位元組數
8	socket.bytesWritten	傳送的位元組數

方法

Sr. No.	方法	描述
1	new net.Socket([options])	構造一個新的 Socket 物件
2	socket.connect(port[, host][, connectListener])	開啟一個給定的通訊端連線。如果埠和主機給出，那麼通訊端就會被開啟作為TCP通訊端，如果省略主機，將使用localhost。如果路徑給定，通訊端就會被開啟作為一個Unix通訊端到該路徑
3	socket.connect(path[, connectListener])	開啟一個給定的通訊端連線。如果埠和主機給出，那麼通訊端就會被開啟作為TCP通訊端，如果省略主機，將使用localhost。如果路徑給定，通訊端就會被開啟作為一個Unix通訊端到該路徑
4	socket.setEncoding([encoding])	通訊端為唯讀流設定編碼
5	socket.write(data[, encoding][, callback])	傳送通訊端上的資料。第二個引數指定的編碼是在字串的情況 - 它預設為UTF8編碼。
6	socket.end([data][, encoding])	半關閉通訊端，即它傳送FIN包。可能伺服器仍然會傳送一些資料。
7	socket.destroy()	確保沒有更多的I/O活動發生在此通訊端。只有在錯誤的情況下（解析錯誤）有必要。
8	socket.pause()	暫停資料讀出。即，“資料”事件將不會被發射。有用的節流回到上載
9	socket.resume()	呼叫 pause() 後讀取暫停
10	socket.setTimeout(timeout[, callback])	設定通訊端不活動的通訊端在timeout毫秒後超時。預設 net.Socket 不會超時。
11	socket.setNoDelay([noDelay])	禁用Nagle演算法。預設情況下TCP連線使用Nagle演算法，它們在傳送之前關閉快取資料。noDelay設定true時每次socket.write()被呼叫將立即釋放掉的資料。noDelay 預設值是true.
12	socket.setKeepAlive([enable][, initialDelay])	啟用/禁用保持有效功能， 可選設定初始延遲後，第一存活探測被傳送在空閒插槽。 enable 預設值是 false.
13	socket.address()	返回系結地址， 報告作業系統的地址系列名稱和通訊端的埠。 返回一個物件有三個屬性，例如{ port: 12346, family: 'IPv4', address: '127.0.0.1' }.
14	socket.unref()	通訊端上呼叫unref 將允許程式退出，如果這是事件系統中唯一的活動通訊端。如果通訊端已經unrefd再次呼叫unref 將不會起作用。
15	socket.ref()	與unref相反，呼叫ref在unrefd通訊端之前不會讓程式退出，如果它是唯一剩下的socket（預設行為）。如果通訊端refd呼叫再次ref將沒有起任何作用。

範例

建立一個js檔案名為server.js 在 D:\>yiibai_worksp\nodejs

File: server.js

var net = require('net');
var server = net.createServer(function(connection) { 
   console.log('client connected');
   connection.on('end', function() {
      console.log('client disconnected');
   });
   connection.write('Welcome to Yiibai Yiibai!\r\n');
   connection.pipe(connection);
});
server.listen(8080, function() { 
  console.log('server is listening');
});

現在執行server.js看到的結果：

D:\yiibai_worksp\nodejs>node server.js

驗證輸出。

server is listening

建立一個js檔案名為client.js 在 C:\>Nodejs_WorkSpace.

File: client.js

var net = require('net');
var client = net.connect({port: 8080}, function() {
   console.log('connected to server!');  
});
client.on('data', function(data) {
   console.log(data.toString());
   client.end();
});
client.on('end', function() { 
   console.log('disconnected from server');
});

現在啟動另一個命令列視窗，執行 client.js 看到結果：

D:\yiibai_worksp\nodejs>node client.js

驗證輸出：

connected to server!
Welcome to Yiibai Yiibai!

disconnected from server

驗證，其中server.js執行輸出在終端上如下：

server is listening
client connected
client disconnected

Node.js - DNS 模組

dns 模組是用來做實際的DNS查詢，以及使用底層作業系統的名稱解析功能..它提供了一個非同步網路包裝。dns模組可以使用以下語法匯入。

var dns = require("dns")

方法

Sr. No.	方法	描述
1	dns.lookup(hostname[, options], callback)	解析主機名（如“google.com”）進入第一找到A（IPv4）或AAAA（IPv6）紀錄。選項可以是物件或整數。如果未提供選項，那麼IP v4和v6的地址都是有效的。如果選項是整數，那麼它必須是4或6
2	dns.lookupService(address, port, callback)	使用getnameinfo會解析給定的地址和埠成一個主機名和服務
3	dns.resolve(hostname[, rrtype], callback)	解析主機名（如“google.com”）到由rrtype指定的記錄型別的陣列
4	dns.resolve4(hostname, callback)	與 dns.resolve() 相同, 但僅限於IPv4的查詢（A記錄）。地址是IPv4地址的陣列(如，['74.125.79.104', '74.125.79.105', '74.125.79.106'])
5	dns.resolve6(hostname, callback)	與dns.resolve4()相同，除了IPv6的查詢（一個AAAA查詢）
6	dns.resolveMx(hostname, callback)	與dns.resolve()相同，但僅限於郵件交換查詢（MX記錄）
7	dns.resolveTxt(hostname, callback)	與 dns.resolve()相同，但僅限於文字查詢（TXT記錄）。地址是文字紀錄，以供主機的2-D陣列 (如, [ ['v=spf1 ip4:0.0.0.0 ', '~all' ] ]). 每個子陣列包含一個記錄的TXT塊。根據使用的情況，可以任意連線在一起或分別處理
8	dns.resolveSrv(hostname, callback)	與dns.resolve()相同，但僅用於服務記錄（SRV記錄）。 地址是一個SRV記錄的陣列提供主機名。SRV記錄屬性包括優先順序，權重，埠和名稱(e.g., [{'priority': 10, 'weight': 5, 'port': 21223, 'name': 'service.example.com'}, ...]).
9	dns.resolveSoa(hostname, callback)	與 dns.resolve() 相同, 但僅限於認證記錄查詢開始（SOA記錄）
10	dns.resolveNs(hostname, callback)	與 dns.resolve() 相同, 但只針對域名伺服器記錄（NS記錄）。地址是可用於主機的名稱伺服器記錄的陣列 (如, ['ns1.example.com', 'ns2.example.com']).
11	dns.resolveCname(hostname, callback)	與 dns.resolve()相同, 但僅限於規範名稱記錄（CNAME記錄）。地址是的規範名稱記錄可用於主機的陣列 (如, ['bar.example.com']).
12	dns.reverse(ip, callback)	Reverse resolves an ip address to an array of hostnames.
13	dns.getServers()	Returns an array of IP addresses as strings that are currently being used for resolution.
14	dns.setServers(servers)	Given an array of IP addresses as strings, set them as the servers to use for resolving.

rrtypes

以下是所使用dns.resolve()方法的有效rrtypes的列表

• A - IPV4 地址（預設）

• AAAA - IPV6 地址

• MX - 郵件交換記錄

• TXT - 文字記錄

• SRV - SRV記錄

• PTR - 用於逆向IP查詢

• NS - 域名伺服器記錄

• CNAME - 規範名稱記錄

• SOA - 規範記錄的開始

錯誤程式碼

每個DNS查詢可以返回下列錯誤程式碼之一：

• dns.NODATA - DNS伺服器返回回答不含資料

• dns.FORMERR - DNS伺服器要求查詢是misformatted

• dns.SERVFAIL - DNS伺服器返回的一般故障

• dns.NOTFOUND - 域名未找到

• dns.NOTIMP - DNS伺服器不執行請求操作

• dns.REFUSED - DNS伺服器拒絕查詢

• dns.BADQUERY - 非格式化的DNS查詢

• dns.BADNAME - 非格式化的主機名

• dns.BADFAMILY - 不支援的地址族

• dns.BADRESP - Misformatted DNS回復

• dns.CONNREFUSED - 無法聯絡DNS伺服器

• dns.TIMEOUT - 超時在聯絡DNS伺服器的時候

• dns.EOF - 檔案的結尾

• dns.FILE - 讀取檔案錯誤

• dns.NOMEM - 記憶體不足

• dns.DESTRUCTION - 通道被銷毀

• dns.BADSTR - 非法格式化字串

• dns.BADFLAGS - 非法標誌指定

• dns.NONAME - 給定主機名不是數位

• dns.BADHINTS - 非法提示標誌指定

• dns.NOTINITIALIZED - c-ares庫初始化尚未執行

• dns.LOADIPHLPAPI - 載入 iphlpapi.dll 錯誤

• dns.ADDRGETNETWORKPARAMS - 找不到GetNetworkParams函式

• dns.CANCELLED - DNS查詢取消

範例

建立一個js檔案名為test.js 在 D:\>yiibai_worksp\nodejs

File: test.js

var dns = require('dns');

dns.lookup('www.tw511.com', function onLookup(err, address, family) {
   console.log('address:', address);
   dns.reverse(address, function (err, hostnames) {
   if (err) {
      console.log(err.stack);
   }

   console.log('reverse for ' + address + ': ' + JSON.stringify(hostnames));
});  
});

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs> node test.js

驗證輸出：

address: 112.124.103.85
Error: getHostByAddr ENOTFOUND 112.124.103.85
    at errnoException (dns.js:44:10)
    at Object.onresolve [as oncomplete] (dns.js:199:19)
reverse for 112.124.103.85: undefined

Node.js - Domain模組

domain 模組是用於攔截未處理的錯誤。這些未處理的錯誤可以使用內部系結或外部系結來攔截。如果錯誤都那麼不處理，那麼Node應用會崩潰。

• 內部系結 - 錯誤發生執行程式碼是在一個域的run方法。

• 外部系結 - 使用它的add方法將錯誤發生明確地加入到域。

domain（域）模組可以使用以下語法匯入。

var domain = require("domain")

域模組的Domain類是用來提供路由錯誤以及未捕獲異常活動域物件的功能。 這是一個EventEmitter的子類。為了處理它捕獲錯誤，監聽它的錯誤事件。它使用如下的語法建立：

var domain = require("domain");
var domain1 = domain.create();

方法

Sr. No.	方法	描述
1	domain.run(function)	執行所提供的函式在域的上下文中，隱式係結在這種情況下建立的所有事件發射器，定時器和低階請求，這是使用域的最基本的方法
2	domain.add(emitter)	顯式地將一個發射器到域。如果由發射器事件處理程式丟擲一個錯誤，或者，如果發射器發出一個錯誤事件，它會被路由到該域的錯誤事件，就如隱式係結
3	domain.remove(emitter)	與domain.add(emitter)相反。從指定的發射器處理刪除域
4	domain.bind(callback)	返回的函式將被圍繞包裝提供回撥函式。當返回的函式被呼叫時，被丟擲的任何錯誤都將被路由到該域的錯誤事件
5	domain.intercept(callback)	此方法幾乎是domain.bind(callback)相同， 然而，除了捕獲丟擲錯誤，它也將擷取Error 物件傳送作為第一個引數到函式。
6	domain.enter()	輸入是一種用於執行，係結，並攔截方法來設定活動域管道。它設定domain.active和process.domain到域，並隱式地推到域，域管理模組域棧（詳見domain.exit()詳細資訊，域名棧）。呼叫以進入分隔鏈開始系結到域非同步呼叫和I/O操作。
7	domain.exit()	exit方法退出當前域，它彈出關閉域堆疊。任何時間執行將要切換到不同鏈的非同步呼叫的上下文中，重要的是要確保當前域退出。呼叫以退出分隔末尾或者中斷鏈系結到一個域的非同步呼叫和I/O操作。
8	domain.dispose()	一旦處理被呼叫，該域將不再使用回撥系結到通過執行，係結或攔截該域。以及一個dispose事件發射

屬性

Sr.No.	屬性	描述
1	domain.members	定時器和事件發射器陣列已明確新增到域

範例

建立一個js檔案名為test.js 在 D:\>yiibai_worksp\nodejs

File: test.js

var EventEmitter = require("events").EventEmitter;
var domain = require("domain");

var emitter1 = new EventEmitter();

//Create a domain
var domain1 = domain.create();

domain1.on('error', function(err){
   console.log("domain1 handled this error ("+err.message+")");
});

//explicit binding 
domain1.add(emitter1);

emitter1.on('error',function(err){
   console.log("listener handled this error ("+err.message+")");
});

emitter1.emit('error',new Error('To be handled by listener'));

emitter1.removeAllListeners('error');

emitter1.emit('error',new Error('To be handled by domain1'));

var domain2 = domain.create();

domain2.on('error', function(err){
   console.log("domain2 handled this error ("+err.message+")");
});

//implicit binding
domain2.run(function(){
   var emitter2 = new EventEmitter();
   
   emitter2.emit('error',new Error('To be handled by domain2'));   
});


domain1.remove(emitter1);

emitter1.emit('error',new Error('Converted to exception. System will crash!'));

現在執行test.js看到的結果：

D:\yiibai_worksp\nodejs>node test.js

驗證輸出：

listener handled this error (To be handled by listener)
domain1 handled this error (To be handled by domain1)
domain2 handled this error (To be handled by domain2)

events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: Converted to exception. System will crash!
    at Object.<anonymous> (C:\Nodejs_WorkSpace\test.js:42:23)
    at Module._compile (module.js:456:26)
    at Object.Module._extensions..js (module.js:474:10)
    at Module.load (module.js:356:32)
    at Function.Module._load (module.js:312:12)
    at Function.Module.runMain (module.js:497:10)
    at startup (node.js:119:16)
    at node.js:929:3

Node.js - Web模組

Web伺服器簡介

Web伺服器是用於處理使用HTTP協定請求並返回網頁作為響應到用戶端的軟體應用程式。 Web伺服器通常提供HTML文件並伴隨著圖片，樣式表和指令碼。大多數Web伺服器還支援使用指令碼語言作為伺服器端指令碼，或重定向到從資料庫中獲取資料的執行特定任務的應用程式伺服器，執行複雜的邏輯等，Web伺服器然後返回應用伺服器到用戶端輸出。

Apache web伺服器是最常見的一個網路伺服器。它是一個開源專案。

路徑定位過程

Web伺服器對映使用URL，統一資源定位符的檔案的路徑。它可以是一個本地檔案系統或一個外部/內部程式。例如：

用戶端使用的瀏覽器發起一個URL請求：http://www.test-example-site.com/website/index.htm.

瀏覽器發起的一個請求是：

Web伺服器將追加路徑到根目錄。舉個例子：根目錄是home/www，那麼實際路徑將被轉換為 home/www/website/index.htm.

Web網路架構介紹

Web應用程式的使用分為四層：

• Client - 此層是由Web瀏覽器，移動瀏覽器或應用程式，它可以發起HTTP請求到伺服器。

• Server - 這一層包括可攔截發出的用戶端請求，並將其傳遞到由Web伺服器響應。

• Business - 這一層由應用程式伺服器組成，它通過利用Web伺服器執行動態任務。這一層互動通過資料庫或某些外部程式資料層。

• Data - 此層由資料庫或任何來源的資料。

使用Node建立Web伺服器

使用http.createServer方法建立HTTP伺服器。通過它一個函式帶引數請求和響應。編寫一個範例實現返回一個請求頁面。通過在8081埠上監聽。

建立一個js檔案名為server.js 在 D:\>yiibai_worksp\nodejs

File: server.js

//http module is required to create a web server
var http = require('http');
//fs module is required to read file from file system
var fs = require('fs');
//url module is required to parse the URL passed to server
var url = require('url');

//create the server
http.createServer(function (request, response) {  
   //parse the pathname containing file name
   var pathname = url.parse(request.url).pathname;
   //print the name of the file for which request is made.
   //if url is http://localhost:8081/test.htm then
   //pathname will be /test.html
   console.log("Request for " + pathname + " received.");
   //read the requested file content from file system
   fs.readFile(pathname.substr(1), function (err, data) {
      //if error occured during file read
      //send a error response to client
      //that web page is not found.
      if (err) {
         console.log(err.stack);
         // HTTP Status: 404 : NOT FOUND
         // Content Type: text/plain
         response.writeHead(404, {'Content-Type': 'text/html'});
      }else{	
         //Page found	  
         // HTTP Status: 200 : OK
         // Content Type: text/plain
         response.writeHead(200, {'Content-Type': 'text/html'});	
         // write the content of the file to response body
         response.write(data.toString());		
      }
      // send the response body 
      response.end();
   });   
}).listen(8081);
// console will print the message
console.log('Server running at http://127.0.0.1:8081/');

建立一個名為 test.html 的 html 檔案在 D:\>yiibai_worksp\nodejs

File: test.html

<html>
<head>
<title>Sample Page</title>
</head>
<body>
    Hello World!
</body>
</html>

現在執行server.js看到的結果：

D:\yiibai_worksp\nodejs>node server.js

驗證輸出。伺服器已經啟動

Server running at http://127.0.0.1:8081/

發出請求到Node.js伺服器

在任何瀏覽器中開啟以下網址：http://127.0.0.1:8081/test.html，看看下面的結果。

驗證伺服器端的輸出

Server running at http://127.0.0.1:8081/
Request for /test.html received.

使用Node建立Web用戶端

Web用戶端可以使用http模組來建立。參見下面的例子：

建立一個名為client.js的js檔案在 D:\>yiibai_worksp\nodejs

File: client.js

//http module is required to create a web client
var http = require('http');

//options are to be used by request 
var options = {
   host: 'localhost',
   port: '8081',
   path: '/test.html'  
};


//callback function is used to deal with response
var callback = function(response){
   // Continuously update stream with data
   var body = '';
   response.on('data', function(data) {
      body += data;
   });
   response.on('end', function() {
      // Data received completely.
      console.log(body);
   });
}
//make a request to the server
var req = http.request(options, callback);
req.end();

現在執行client.js在不同的終端命令列，也就是在server.js以外終端上看到的結果：

D:\yiibai_worksp\nodejs>node client.js

驗證輸出：

<html>
<head>
<title>Sample Page</title>
</head>
<body>
    Hello World!
</body>
</html>

驗證伺服器端的輸出

Server running at http://127.0.0.1:8081/
Request for /test.html received.
Request for /test.html received.

Node.js - Express應用程式

Express 概述

Express JS是用於建立Node JS的Web應用程式非常流行的Web應用程式框架。它提供了一個整合的環境便於快速開發基於Node的Web應用程式。Express框架是基於連線的中介軟體引擎並使用Jade HTML模板框架來做HTML模板。以下是一些Express 框架的核心功能：

• 允許設立中介軟體來響應HTTP請求

• 定義了用於執行基於HTTP方法和URL不同作用的路由表

• 允許動態渲染基於引數傳遞給模板的HTML頁面

安裝Express

首先，使用NPM安裝Express框架到全域性，以便它可以使用Node終端來建立Web應用程式。

D:\yiibai_worksp\nodejs> npm install express -g

當npm完成下載，可以通過檢視內容來驗證，內容在 <user-directory>/npm/node_modules. 或輸入以下命令：

D:\yiibai_worksp\nodejs> npm ls -g

將看到以下的輸出：

C:\Documents and Settings\Administrator\Application Data\npm
+-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | | +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  |   +-- [email protected]
  +-- [email protected]
  +-- [email protected]

Express生成器

現在使用NPM安裝express生成器。express生成器用於使用express命令建立應用程式框架。

D:\yiibai_worksp\nodejs> npm install express-generator -g

將看到以下的輸出：

D:\yiibai_worksp\nodejs>npm install express-generator -g
C:\Users\Administrator\AppData\Roaming\npm\express -> C:\Users\Administrator\AppData\Roaming\npm\node_modules\express-generator\bin\express[email protected] C:\Users\Administrator\AppData\Roaming\npm\node_modules
\express-generator
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])

Hello world 範例

現在使用下面的命令建立一個範例應用程式 firstApplication：

D:\yiibai_worksp\nodejs> express firstApplication

將看到以下的輸出：

   create : firstApplication
   create : firstApplication/package.json
   create : firstApplication/app.js
   create : firstApplication/public
   create : firstApplication/public/javascripts
   create : firstApplication/public/images
   create : firstApplication/public/stylesheets
   create : firstApplication/public/stylesheets/style.css
   create : firstApplication/routes
   create : firstApplication/routes/index.js
   create : firstApplication/routes/users.js
   create : firstApplication/views
   create : firstApplication/views/index.jade
   create : firstApplication/views/layout.jade
   create : firstApplication/views/error.jade
   create : firstApplication/bin
   create : firstApplication/bin/www

   install dependencies:
     $ cd firstApplication && npm install

   run the app:
     $ DEBUG=firstApplication:* ./bin/www

進入 firstApplication 檔案夾並使用下面的命令來安裝 firstApplication 的依賴關係：

D:\yiibai_worksp\nodejs\firstApplication> npm install

將看到以下的輸出：

[email protected] node_modules\debug
+-- [email protected]

[email protected] node_modules\cookie-parser
+-- [email protected]
+-- [email protected]

[email protected] node_modules\morgan
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])

[email protected] node_modules\serve-favicon
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])

[email protected] node_modules\jade
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])
+-- [email protected] ([email protected], [email protected], [email protected])
+-- [email protected] ([email protected], [email protected])
+-- [email protected] ([email protected])

[email protected] node_modules\express
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])
+-- [email protected] ([email protected])
+-- [email protected] ([email protected], [email protected])
+-- [email protected] ([email protected], [email protected], [email protected])
+-- [email protected] ([email protected], [email protected])
+-- [email protected] ([email protected], [email protected])

[email protected] node_modules\body-parser
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected]
+-- [email protected] ([email protected])
+-- [email protected] ([email protected], [email protected])

在這裡，express生成器建立了一個完整的應用程式結構，可以驗證在 firstApplication 檔案夾中（Nodejs_WorkSpace檔案夾下面）裡建立的檔案夾/檔案：

.
+-- app.js
+-- bin
|   +-- www
+-- package.json
+-- public
|   +-- images
|   +-- javascripts
|   +-- stylesheets
|       +-- style.css
+-- routes
|   +-- index.js
|   +-- users.js
+-- views
    +-- error.jade
    +-- index.jade
    +-- layout.jade

• package.json 是應用程式描述符檔案包含在依賴項列表中，應用程式使用 Node 的其他屬性

• app.js 包含了伺服器的初始化程式碼

• bin是用於儲存在生產模式下的應用程式

• public用於儲存影象，樣式表和JavaScript檔案

• routes 包含路由處理程式

• views 包含HTML模板來生成Web應用各種檢視

第一個應用程式

app.js 是基於 express 的應用核心引擎。讓我們更新預設app.js包括埠資訊，並使用它來建立一個伺服器。新增以下行到app.js ：

//set the server port
app.set('port', process.env.PORT || 3000);

//create the server 
http.createServer(app).listen(app.get('port'), function(){
  console.log('Express server listening on port ' + app.get('port'));
});

更新 app.js

以下是app.js檔案的全部內容

更新 app.js 檔案的內容在 D:\>yiibai_worksp\nodejs\firstApplication.

File: app.js

var express = require('express');
var path = require('path');
var favicon = require('serve-favicon');
var logger = require('morgan');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var http = require('http');

var routes = require('./routes/index');
var users = require('./routes/users');

var app = express();

// view engine setup
app.set('port', process.env.PORT || 8891);
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');

// uncomment after placing your favicon in /public
//app.use(favicon(__dirname + '/public/favicon.ico'));
app.use(logger('dev'));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));

app.use('/', routes);
app.use('/users', users);

// catch 404 and forward to error handler
app.use(function(req, res, next) {
   var err = new Error('Not Found');
   err.status = 404;
   next(err);
});

// error handlers

// development error handler
// will print stacktrace
if (app.get('env') === 'development') {
   app.use(function(err, req, res, next) {
      res.status(err.status || 500);
      res.render('error', {
         message: err.message,
         error: err
      });
   });
}

// production error handler
// no stacktraces leaked to user
app.use(function(err, req, res, next) {
   res.status(err.status || 500);
   res.render('error', {
      message: err.message,
      error: {}
   });
});

http.createServer(app).listen(app.get('port'), function(){
  console.log('Express server listening on port ' + app.get('port'));
});

module.exports = app;

現在執行app.js看到的結果：

D:\yiibai_worksp\firstApplication>node app

驗證輸出，伺服器已經啟動

Express server listening on port 8891

發出一個請求到firstApplication

在瀏覽器開啟網址：http://localhost:8891/，看看下面的結果：

 

再次在瀏覽器開啟網址：http://localhost:8891/users，看看下面的結果：

基本的路由

在app.js下面的程式碼系結兩個Route處理。

var routes = require('./routes/index');
var users = require('./routes/users');
...
app.use('/', routes);
app.use('/users', users);

• routes - 路由(index.js), 路由處理程式處理所有請求，主頁發出通過 localhost:8891

• users - users (users.js), 路由處理來處理所有發出的請求 /users 通過 localhost:3000/users

以下是對應折程式碼：D:\>yiibai_worksp\nodejs\firstApplication\routes\index.js是由express生成器建立。

var express = require('express');
var router = express.Router();

/* GET home page. */
router.get('/', function(req, res, next) {
  res.render('index', { title: 'Express' });
});

module.exports = router;

當Node伺服器接收到一個主頁的請求，express路由器渲染索引頁是使用模板index.jade同時傳遞引數title的值為'Express'。以下是模板程式碼內容：D:\>yiibai_worksp\nodejs\firstApplication\views\index.jade

extends layout

block content
  h1= title
  p Welcome to #{title}

Node.js - 加強第一個應用程式

概述

在這篇文章中，我們將加強Express第一個應用程式，建立 Express JS 應用程式：

• 顯示所有使用者的列表

• 顯示一個特定的使用者的細節

• 新增新的使用者的詳細資訊

第1步：建立一個基於JSON資料庫

首先，讓我們建立一個使用者範例JSON基礎資料庫。

建立一個名為 user.json 在一個 JSON 檔案於 D:\>yiibai_worksp\nodejs\firstApplication

File: user.json

{
   "user1" : {
      "name" : "mahesh",
	  "password" : "password1",
	  "profession" : "teacher"
   },
   "user2" : {
      "name" : "suresh",
	  "password" : "password2",
	  "profession" : "librarian"
   },
   "user3" : {
      "name" : "newuser",
	  "password" : "password3",
	  "profession" : "clerk"
   }
}

第2步：建立特定的使用者Jade檢視

在建立一個 user 目錄在 D:\>yiibai_worksp\node\firstApplication\views 如下檢視：index.jade - 檢視顯示所有使用者的列表。

• new.jade - 檢視顯示一個表單來新增一個新使用者。

• profile.jade - 檢視顯示的使用者的細節

建立一個index.jade在 D:\>yiibai_worksp\nodejs\firstApplication\views\users.

File: index.jade

h1 Users

p 
   a(href="/users/new/") Create new user
ul
   - for (var username in users) {
   li 
      a(href="/users/" + encodeURIComponent(username))= users[username].name
   - };

建立一個檔案 new.jade 在 D:\>yiibai_worksp\nodejs\firstApplication\views\users.

File: new.jade

h1 New User

form(method="POST" action="/Users/addUser")
	P 
		label(for="name") Name

		input#name(name="name")
	P 
		label(for="password") Password

		input#name(name="password")
	P 
		label(for="profession") Profession

		input#name(name="profession")
	P
		input(type="submit", value="Create")

建立一個檔案 profile.jade 在 D:\>yiibai_worksp\nodejs\firstApplication\views\users.

File: profile.jade

h1 Name: #{user.name}

h2 Profession: #{user.profession}

第3步：更新使用者路由處理 users.js

更新檔案 users.js 在 D:\>yiibai_worksp\nodejs\firstApplication\routes.

File: users.js

var express = require('express');
var router = express.Router();

var users = require('../users.json');
/* GET users listing. */
router.get('/', function(req, res) {
   res.render('users/index', { title: 'Users',users:users });
});

/* Get form to add a new user*/
router.get('/new', function(req, res) {
   res.render('users/new', { title: 'New User'});
});

/* Get detail of a new user */
router.get('/:name', function(req, res, next) {
   var user = users[req.params.name] 
   if(user){
      res.render('users/profile', { title: 'User Profile', user:user});
   }else{
      next();
   }   
});

/* post the form to add new user */
router.post('/addUser', function(req, res, next) {   
   if(users[req.body.name]){
      res.send('Conflict', 409);
   }else{
     users[req.body.name] = req.body;
	 res.redirect('/users/');
   }   
});

module.exports = router;

現在執行app.js看到的結果：

D:\yiibai_worksp\nodejs\firstApplication>node app

驗證輸出，伺服器已經啟動

Express server listening on port 3000

發出請求到firstApplication得到所有使用者的列表。在瀏覽器開啟網址：http://localhost:8891/users，看看下面的結果。 

點選建立新的使用者連結看到表單。

提交表單並檢視更新列表。

點選檢視使用者的詳細。

可以檢查伺服器狀態如下：

D:\yiibai_worksp\nodejs\firstApplication>node app
Express server listening on port 3000
GET /users/ 200 809.161 ms - 201
GET /users/new/ 304 101.627 ms - -
GET /users/new/ 304 33.496 ms - -
POST /Users/addUser 302 56.206 ms - 70
GET /users/ 200 43.548 ms - 245
GET /users/naresh 200 12.313 ms - 47

Node.js - Restful API

什麼是REST架構？

REST表示代表狀態傳輸。REST是基於Web標準的體系結構並使用HTTP協定。它圍繞著資源，其中每一個元件是資源，資源是由一個共同的介面使用HTTP的標準方法獲得。REST首先是由Roy Fielding在2000年推出。

在REST架構中，REST伺服器只是提供獲取資源，REST用戶端存取和修改的資源。這裡每個資源由URI標識的/全域性ID。REST使用不同方式表示資源，如文字，JSON，XML。 JSON是最流行的一種。

HTTP 方法

以下四個HTTP方法通常用在基於的REST架構。

• GET - 提供資源的唯讀存取

• PUT - 用於建立一個新的資源

• DELETE - 用於刪除資源

• POST - 用於更新現有的一個資源或建立新的資源

RESTful Web服務介紹

Web服務是用於交換應用程式或系統之間的資料開放的協定和標準的集合。寫在各種程式設計語言的軟體應用， 並在各種平台上執行可以使用Web服務以類似的進程間通訊的方式在一台計算機上，通過計算機網路交換資料，如網際網路。這種互操作性（如Java和Python，或Windows和Linux應用程式之間），是由於使用了開放標準。

基於REST架構的Web服務稱為RESTful Web服務。這些Web服務使用HTTP方法來實現REST架構的概念。RESTful Web服務通常定義的URI，統一資源識別符號的服務，提供資源的表示，如JSON，並設定HTTP方法。

為一個庫建立RESTful

現在，我們將加強express範例應用程式，以下建立一個Web服務來使用者管理：

Sr. No.	URI	HTTP 方法	POST body	結果
1	/users/	GET	empty	顯示所有使用者的列表
2	/users/addUser	POST	JSON String	新增新的使用者的詳細資訊
3	/users/:id	GET	empty	使用者的檢視詳細

獲取所有使用者資訊

首先，讓我們更新使用者的樣本基於JSON的資料庫。

更新JSON檔案名為user.json在 D:\>yiibai_worksp\nodejs\firstApplication.

File: user.json

{
   "user1" : {
      "name" : "mahesh",
	  "password" : "password1",
	  "profession" : "teacher",
	  "id": 1
   },
   "user2" : {
      "name" : "suresh",
	  "password" : "password2",
	  "profession" : "librarian",
	  "id": 2
   },
   "user3" : {
      "name" : "ramesh",
	  "password" : "password3",
	  "profession" : "clerk",
	  "id": 3
   }
}

當用戶端傳送GET請求/使用者，伺服器應該傳送一個包含所有使用者的響應。更新使用者的路由處理，users.js

更新 users.js 在 D:\>yiibai_worksp\nodejs\firstApplication\routes.

File: users.js

/* GET users listing. */
router.get('/', function(req, res) {
   res.send({ title: 'Users',users:users });
});

新增新的使用者的詳細資訊

當用戶端傳送一個POST請求 /users/addUser 包含JSON字串，伺服器應該傳送一個響應宣告狀態。更新使用者的路由處理users.js

更新 users.js 在 D:\>Nodejs_WorkSpace\firstApplication\routes.

File: users.js

/*add a user*/
router.post('/addUser', function(req, res, next) { 
    var body = '';
    req.on('data', function (data) {
        body += data;
    });
    req.on('end', function () {        
	   var json = JSON.parse(body);	   
       users["user"+json.id] = body;
	   res.send({ Message: 'User Added'});      
    });   	   
});

顯示新使用者的詳細資訊

當用戶端傳送GET請求到/users並帶有id，伺服器響應返回包含該使用者的詳細資訊。更新使用者的路由處理程式：users.js

更新 users.js 在 D:\>yiibai_worksp\nodejs\firstApplication\routes，如下：

File: users.js

router.get('/:id', function(req, res, next) {  
   var user = users["user" + req.params.id] 
   if(user){
      res.send({ title: 'User Profile', user:user});
   }else{
      res.send({ Message: 'User not present'});
   }   
});

完整的users.js 程式碼

File: users.js

var express = require('express');
var router = express.Router();

var users = require('../users.json');
/* GET users listing. */
router.get('/', function(req, res) {
   res.send({ title: 'Users',users:users });
});

router.get('/:id', function(req, res, next) {
   console.log(req.params)
   var user = users["user" + req.params.id] 
   if(user){
      res.send({ title: 'User Profile', user:user});
   }else{
      res.send({ Message: 'User not present'});
   }   
});

router.post('/addUser', function(req, res, next) { 
    var body = '';
    req.on('data', function (data) {
        body += data;
    });
    req.on('end', function () {        
	   var json = JSON.parse(body);	   
       users["user"+json.id] = body;
	   res.send({ Message: 'User Added'});      
    });   	   
});

module.exports = router;

輸出

我們使用一個Chrome瀏覽器的掃外掛：Postman, 來測試我們編寫的 webservices，安裝Postman需要到以下網址下載（可能需要翻牆）：https://chrome.google.com/webstore/detail/postman-interceptor/aicmkgpgakddgnaphhhpliifpcfhicfo 安裝好這個外掛後，開啟後顯示如下圖：

 

現在執行app.js看到的結果：

D:\yiibai_worksp\nodejs\firstApplication> node app

驗證輸出。伺服器已經啟動

Express server listening on port 8891

提出一個請求到firstApplication獲取所有使用者的資訊列表。把 http://localhost:8891/users 到POSTMAN 位址列中，並使用GET請求，看到下面的結果。

發出一個請求到 firstApplication 以新增一個新使用者。把 http://localhost:8891/users/addUser 放入到POSTMAN中並使用POST方式提交，看看下面的結果。

新增JSON資料格式，並選擇POST方法。

{"name":"rakesh","password":"password4","profession":"teacher","id":5}

發出一個請求 firstApplication 獲得使用者。把 http://localhost:8891/users/1 在POSTMAN中找開啟並用GET請求，看看下面的結果。

Node.js - 縮放應用

Node是在單執行緒模式下執行，它使用事件驅動的模式來處理並行。它還有助於建立子進程來利用併行處理在多核CPU的系統。

子進程始終有三個流child.stdin，child.stdout和child.stderr ，可以與父進程共用標准輸入輸出流。它們能夠通過一個單獨的流物件管道輸送。

主要有三種方法來建立子進程。

• exec - child_process.exec方法在shell/控制台執行一個命令並緩衝輸出。

• spawn - child_process.spawn由給定的命令啟動一個新的進程

• fork - child_process.fork方法是spawn() 建立Node進程的一個特例。

exec() 方法

child_process.exec方法在shell執行一個命令並緩衝輸出。它簽名如下：

child_process.exec(command[, options], callback)

• command String要執行的命令，用空格分隔引數

• options 物件

  • cwd 當前工作目錄子進程的字串

  • env 物件環境鍵值對

  • encoding 字串（預設：'utf8'')

  • shell 字串Shell來執行（預設命令：在UNIX上在“/bin/sh”，在Windows為cmd.exe“，在shell中應該知道在Windows或UNIX/S/C-c開關。在Windows中，命令列解析應與cmd.exe相容）

  • timeout 數位（預設值: 0）

  • maxBuffer 數位(預設值: 200*1024)

  • killSignal 字串(預設值: 'SIGTERM')

  • uid 數位設定進程的使用者身份

  • gid 數位設定進程的組標識

• callback 當進程終止函式呼叫輸出

  • error Error

  • stdout Buffer

  • stderr Buffer

• Return:ChildProcess物件

exec() 返回一個緩衝器的最大尺寸，並等待該進程結束，並試圖在一次返回所有緩衝的資料

範例

建立兩個JS檔案名為worker.js和master.js在 D:\>yiibai_worksp\nodejs

File: worker.js

console.log("Child Process "+ process.argv[2] +" executed." );

File: master.js

const fs = require('fs');
const child_process = require('child_process');

for(var i=0; i<3; i++) {
   var workerProcess = child_process.exec('node worker.js '+i,
      function (error, stdout, stderr) {
         if (error) {
            console.log(error.stack);
            console.log('Error code: '+error.code);
            console.log('Signal received: '+error.signal);
         }
         console.log('stdout: ' + stdout);
         console.log('stderr: ' + stderr);
      });

      workerProcess.on('exit', function (code) {
      console.log('Child process exited with exit code '+code);
   });
}

現在執行master.js看到的結果：

D:\yiibai_worksp\nodejs> node master.js

驗證輸出。伺服器已經啟動

Child process exited with exit code 0
stdout: Child Process 1 executed.

stderr:
Child process exited with exit code 0
stdout: Child Process 0 executed.

stderr:
Child process exited with exit code 0
stdout: Child Process 2 executed.

spawn() 方法

child_process.spawn方法由給定的命令啟動一個新的進程。它具有以下簽名

child_process.spawn(command[, args][, options])

• command 字串 - 要執行的命令

• args 字串引數陣列列表

• options 物件

  • cwd 當前工作目錄子進程的字串

  • env 物件環境鍵值對

  • stdio 陣列|子字串的標準輸入輸出組態

  • customFds Array不推薦檔案描述符由子進程使用標准輸入輸出

  • detached boolean值 - 子進程是一個行程群組頭進程

  • uid 數位設定進程的使用者身份

  • gid Number設定進程的組標識

• Return: ChildProcess物件

spawn() 返回流（標準輸出與標準錯誤），並會使用當該過程返回巨量資料量。spawn()即開始接收到響應進程開始執行。

範例

建立兩個JS檔案名為worker.js和master.js在  D:\>yiibai_worksp\nodejs

File: worker.js

console.log("Child Process "+ process.argv[2] +" executed." );

File: master.js

const fs = require('fs');
const child_process = require('child_process');
 
for(var i=0; i<3; i++) {
   var workerProcess = child_process.spawn('node', ['worker.js', i]);

   workerProcess.stdout.on('data', function (data) {
      console.log('stdout: ' + data);
   });

   workerProcess.stderr.on('data', function (data) {
      console.log('stderr: ' + data);
   });

   workerProcess.on('close', function (code) {
      console.log('child process exited with code ' + code);
   });
}

現在執行master.js看到的結果：

D:\yiibai_worksp\nodejs> node master.js

驗證輸出。伺服器已經啟動

stdout: Child Process 0 executed.

child process exited with code 0
stdout: Child Process 2 executed.

child process exited with code 0
stdout: Child Process 1 executed.

child process exited with code 0

fork 方法

child_process.fork方法是spawn() 的一個特例用來建立Node進程。它具有以下簽名

child_process.fork(modulePath[, args][, options])

• modulePath 字串- 模組執行所在的子進程

• args 字串引數陣列列表

• options 物件

  • cwd 當前工作目錄子進程的字串

  • env 物件環境鍵值對

  • execPath 字串可執行用於建立子進程

  • execArgv 傳遞給程式的可執行字串引數陣列列表（預設值：process.execArgv）

  • silent Boolean如果為true，stdin, stdout, 和 stderr 的標準錯誤將被輸送到父進程，否則它們將繼承自父，詳情參見“管道”和“繼承” 選項spawn()的標準輸入輸出（預設為false）

  • uid 數位設定進程的使用者身份

  • gid 數位設定進程的組標識

• Return: ChildProcess 物件

fork返回物件有內建的通訊通道，除了具有正常的ChildProcess範例的所有方法。

範例

建立兩個JS檔案名為 worker.js 和 master.js 在 D:\>yiibai_worksp\nodejs

File: worker.js

console.log("Child Process "+ process.argv[2] +" executed." );

File: master.js

const fs = require('fs');
const child_process = require('child_process');
 
for(var i=0; i<3; i++) {
   var worker_process = child_process.fork("worker.js", [i]);	

   worker_process.on('close', function (code) {
      console.log('child process exited with code ' + code);
   });
}

現在執行master.js看到的結果：

D:\yiibai_worksp> node master.js

驗證輸出。伺服器已經啟動

Child Process 0 executed.
Child Process 1 executed.
Child Process 2 executed.
child process exited with code 0
child process exited with code 0
child process exited with code 0