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.gitbook.net', 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
+-- express@4.11.2
  +-- accepts@1.2.3
  | +-- mime-types@2.0.8
  | | +-- mime-db@1.6.1
  | +-- negotiator@0.5.0
  +-- content-disposition@0.5.0
  +-- cookie@0.1.2
  +-- cookie-signature@1.0.5
  +-- debug@2.1.1
  | +-- ms@0.6.2
  +-- depd@1.0.0
  +-- escape-html@1.0.1
  +-- etag@1.5.1
  | +-- crc@3.2.1
  +-- finalhandler@0.3.3
  +-- fresh@0.2.4
  +-- media-typer@0.3.0
  +-- merge-descriptors@0.0.2
  +-- methods@1.1.1
  +-- on-finished@2.2.0
  | +-- ee-first@1.1.0
  +-- parseurl@1.3.0
  +-- path-to-regexp@0.1.3
  +-- proxy-addr@1.0.6
  | +-- forwarded@0.1.0
  | +-- ipaddr.js@0.1.8
  +-- qs@2.3.3
  +-- range-parser@1.0.2
  +-- send@0.11.1
  | +-- destroy@1.0.3
  | +-- mime@1.2.11
  | +-- ms@0.7.0
  +-- serve-static@1.8.1
  +-- type-is@1.5.6
  | +-- mime-types@2.0.8
  |   +-- mime-db@1.6.1
  +-- utils-merge@1.0.0
  +-- vary@1.0.0

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\expressexpress-generator@4.13.1 C:\Users\Administrator\AppData\Roaming\npm\node_modules
\express-generator
+-- sorted-object@1.0.0
+-- commander@2.7.1
+-- mkdirp@0.5.1 (minimist@0.0.8)

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

將看到以下的輸出：

debug@2.1.2 node_modules\debug
+-- ms@0.7.0

cookie-parser@1.3.4 node_modules\cookie-parser
+-- cookie-signature@1.0.6
+-- cookie@0.1.2

morgan@1.5.1 node_modules\morgan
+-- basic-auth@1.0.0
+-- depd@1.0.0
+-- on-finished@2.2.0 (ee-first@1.1.0)

serve-favicon@2.2.0 node_modules\serve-favicon
+-- ms@0.7.0
+-- fresh@0.2.4
+-- parseurl@1.3.0
+-- etag@1.5.1 (crc@3.2.1)

jade@1.9.2 node_modules\jade
+-- character-parser@1.2.1
+-- void-elements@2.0.1
+-- commander@2.6.0
+-- mkdirp@0.5.0 (minimist@0.0.8)
+-- transformers@2.1.0 (promise@2.0.0, css@1.0.8, uglify-js@2.2.5)
+-- with@4.0.1 (acorn-globals@1.0.2, acorn@0.11.0)
+-- constantinople@3.0.1 (acorn-globals@1.0.2)

express@4.12.2 node_modules\express
+-- merge-descriptors@1.0.0
+-- cookie-signature@1.0.6
+-- methods@1.1.1
+-- cookie@0.1.2
+-- fresh@0.2.4
+-- utils-merge@1.0.0
+-- range-parser@1.0.2
+-- escape-html@1.0.1
+-- parseurl@1.3.0
+-- vary@1.0.0
+-- content-type@1.0.1
+-- finalhandler@0.3.3
+-- serve-static@1.9.1
+-- content-disposition@0.5.0
+-- path-to-regexp@0.1.3
+-- depd@1.0.0
+-- qs@2.3.3
+-- on-finished@2.2.0 (ee-first@1.1.0)
+-- etag@1.5.1 (crc@3.2.1)
+-- proxy-addr@1.0.6 (forwarded@0.1.0, ipaddr.js@0.1.8)
+-- send@0.12.1 (destroy@1.0.3, ms@0.7.0, mime@1.3.4)
+-- accepts@1.2.4 (negotiator@0.5.1, mime-types@2.0.9)
+-- type-is@1.6.0 (media-typer@0.3.0, mime-types@2.0.9)

body-parser@1.12.0 node_modules\body-parser
+-- content-type@1.0.1
+-- bytes@1.0.0
+-- raw-body@1.3.3
+-- depd@1.0.0
+-- qs@2.3.3
+-- iconv-lite@0.4.7
+-- on-finished@2.2.0 (ee-first@1.1.0)
+-- type-is@1.6.0 (media-typer@0.3.0, mime-types@2.0.9)

在這裡，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