Node.js創(chuàng)建HTTP文件服務(wù)器的使用示例
HelloWorld示例只有演示意義,這次我們來搞一個實際的例子:文件服務(wù)器。我們使用Node.js創(chuàng)建一個HTTP協(xié)議的文件服務(wù)器,你可以使用瀏覽器或其它下載工具到文件服務(wù)器上下載文件。
為了讀取文件,我們會用到File System模塊(名字是”fs”),Stream,我們還要分析URL,區(qū)別HTTP方法,還會用到EventEmitter。
文件服務(wù)器FileServer的代碼
先上代碼吧,依然是簡單的:
// 引入http模塊
var http = require("http");
var fs = require("fs");
// 創(chuàng)建server,指定處理客戶端請求的函數(shù)
http.createServer(
function(request, response) {
//判斷HTTP方法,只處理GET
if(request.method != "GET"){
response.writeHead(403);
response.end();
return null;
}
//此處也可使用URL模塊來分析URL(https://nodejs.org/api/url.html)
var sep = request.url.indexOf('?');
var filePath = sep < 0 ? request.url : request.url.slice(0, sep);
console.log("GET file: " + filePath);
//當(dāng)文件存在時發(fā)送數(shù)據(jù)給客戶端,否則404
var fileStat = fs.stat("."+filePath,
function(err, stats){
if(err) {
response.writeHead(404);
response.end();
return null;
}
//TODO:Content-Type應(yīng)該根據(jù)文件類型設(shè)置
response.writeHead(200, {"Content-Type": "text/plain", "Content-Length": stats.size});
//使用Stream
var stream = fs.createReadStream("."+filePath);
stream.on('data',function(chunk){
response.write(chunk);
});
stream.on('end',function(){
response.end();
});
stream.on('error',function(){
response.end();
});
}
);
}
).listen(8000);
console.log("Hello World start listen on port 8000");
最大的變化,就在傳遞給createServer方法的參數(shù)了。
我們根據(jù)request.method作了判斷,不是GET就返回403。如果是呢,就判斷文件是否存在,不存在,返回404,存在就讀取數(shù)據(jù)寫給客戶端。邏輯就是這么簡單。下面我們來介紹用到的新知識。
File System
要使用FileSystem,得用require引入fs模塊,就如前面代碼里那樣。File System的API老長老長了,看這里吧:https://nodejs.org/api/fs.html。我們只說用到的特性。
獲取文件狀態(tài)
在我們的FileServer里,收到和客戶端請求時先通過fs.stat()方法獲取文件狀態(tài)。fs.stat()方法原型如下:
fs.stat(path, callback)
第一個參數(shù)是文件路徑,第二個參數(shù)是回調(diào)函數(shù)。fs.stat()方法是異步的,結(jié)果通過回調(diào)函數(shù)callback返回。callback的原型如下:
function(err, stats)
第一個參數(shù)指示是否出現(xiàn)了錯誤,第二個參數(shù)是一個對象,類型是fs.Stats,保存了文件的狀態(tài)信息,比如大小、創(chuàng)建時間、修改時間等。
FileServer的代碼獲取到文件狀態(tài)后,讀取大小,調(diào)用http.ServerResponse的writeHead方法,設(shè)置HTTP狀態(tài)碼為200,還設(shè)置了Content-Length頭部。代碼如下:
ReadStream
接下來呢,我們調(diào)用fs.createReadStream創(chuàng)建了一個ReadStream對象。ReadStream是Stream,也是EventEmitter。
fs.createReadStream方法原型如下:
fs.createReadStream(path[, options])
第一個參數(shù)是文件路徑,第二個參數(shù)是可選的JSON對象,用來指定打開文件的一些選項,默認(rèn)值如下:
{ flags: ‘r',
encoding: null,
fd: null,
mode: 0666,
autoClose: true
}
autoClose屬性默認(rèn)為true,讀完文件或讀取出錯時,文件會被自動關(guān)閉。fd屬性可以關(guān)聯(lián)一個已有的文件描述符,這樣就會忽略path,根據(jù)一個已經(jīng)打開的文件來創(chuàng)建流。options還可以有start和end項,指定起、止位置,讀取文件的特定區(qū)域。如果我們要實現(xiàn)斷點續(xù)傳,就需要這個了,用法類似這樣:
fs.createReadStream('sample.mp4', {start: 1000, end: 10000});
encoding用來指定文件的編碼,這對于文本文件有特殊的意義,目前支持'utf8'、'ascii'和'base64'。
ReadStream讀取數(shù)據(jù)是異步的,一塊一塊的讀,讀到一部分就發(fā)送一個data事件,數(shù)據(jù)呢,會傳遞給與事件關(guān)聯(lián)的listener(實際上是一個回調(diào)方法)。在我們的代碼里,僅僅是調(diào)用response.write把數(shù)據(jù)寫給客戶端。注意,可能會多次調(diào)用response.write哦。又因為我們設(shè)置了Content-Length,所以不會采用chunked編碼方式。如果我們不設(shè)置Content-Length,那默認(rèn)會啟用chunked方式。
ReadStream讀完文件時會發(fā)射end事件,出錯時會發(fā)射error事件,我們監(jiān)聽這兩個事件,簡單的終止響應(yīng)。
我們在示例代碼中看到了stream.on這種代碼,下面來解釋吧。
EventEmitter
Node.js基于V8引擎實現(xiàn)的事件驅(qū)動IO,是其最大最棒的特色之一。有了事件機制,就可以充分利用異步IO突破單線程編程模型的性能瓶頸,使得用JavaScript作后端開發(fā)有了實際意義。
EventEmitter的基本用法
events.EventEmitter是一個簡單的事件發(fā)射器的實現(xiàn),具有addListener、on、once、removeListener、emit等方法,開發(fā)者可以很方便的調(diào)用這些API監(jiān)聽某個事件或者發(fā)射某個事件。
我們在示例中用到的fs.ReadStream就是一個EventEmitter,它實現(xiàn)了stream.Readable接口,而stream.Readable具有data、error、end、close、readable等事件。
通常我們使用EventEmitter的on或addListener來監(jiān)聽一個事件,這個時間可能會多次觸發(fā),每次觸發(fā),我們提供的回調(diào)方法都會被調(diào)用。我們示例中的代碼就是這樣:
stream.on('data',function(chunk){
response.write(chunk);
});
Node.js的事件機制,會給某個事件關(guān)聯(lián)一個回調(diào)方法列表,這樣多個關(guān)注者就可以監(jiān)聽同一個事件。每個事件發(fā)射時,可能會帶有數(shù)據(jù)和狀態(tài),這些數(shù)據(jù)是通過回調(diào)方法的參數(shù)傳遞出來的。那某一個特定的事件,它對應(yīng)的回調(diào)方法的參數(shù)是什么樣子的,則由事件定義的那個類(實例)來決定。EventEmitter的emit方法原型如下:
emitter.emit(event[, arg1][, arg2][, ...])
這個原型說明一個事件的回調(diào)方法可以有一個或多個參數(shù),也可以沒有參數(shù)。要想知道某個事件的回調(diào)方法是否有參數(shù)、每個參數(shù)的含義,只好去找相關(guān)的API文檔。stream.Readable的data事件的參數(shù)是chunk,Buffer類型,代表讀到的數(shù)據(jù)。
如果我們只想監(jiān)聽某個事件一次,則可以調(diào)用EventEmitter的once方法。要想移除一個事件監(jiān)聽器,可以調(diào)用removeListener,想移除所有,則可以調(diào)用removeAllListener。
自定義事件
Node.js的很多模塊都繼承自Event模塊。我們自己也可以通過繼承EventEmitter來實現(xiàn)自己的對象,添加自己的自定義事件。
這里有個簡單的例子:
var util=require("util");
var events = require("events");
function Ticker() {
var self = this;
events.EventEmitter.call(this);
setInterval(function(){
self.emit("tick")
},
1000
);
}
util.inherits(Ticker, events.EventEmitter);
var ticker = new Ticker();
ticker.on("tick", function() {
console.log("tick event");
});
在這個簡單的例子里,我們定義了Ticker對象,通過全局方法setInterval開啟了一個定時器,每隔1000毫秒發(fā)射一個名為“tick”的事件。
Node.js的工具模塊封裝了繼承的方法,我們調(diào)用它來的inherits方法來完成Ticker對events.EventEmitter的繼承。
自定義事件的使用方法,和Node.js內(nèi)置模塊提供的事件的用法完全一樣。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
在NodeJS中啟用ECMAScript 6小結(jié)(windos以及Linux)
ECMAScript 6 是JavaScript的下一代標(biāo)準(zhǔn),其目標(biāo),是使得JavaScript可以用來編寫復(fù)雜的應(yīng)用程序、函數(shù)庫和代碼的自動生成器(code generator)。2014-07-07
node作為中間服務(wù)層如何發(fā)送請求(發(fā)送請求的實現(xiàn)方法詳解)
node作為中間服務(wù)層如何發(fā)送請求?下面小編就為大家分享一下發(fā)送請求的實現(xiàn)方法,具有很好的參考價值,希望對大家有所幫助2018-01-01
Node.js五大應(yīng)用性能技巧小結(jié)(必須收藏)
本篇文章主要介紹了Node.js五大應(yīng)用性能技巧小結(jié)(必須收藏),小編覺得挺不錯的,現(xiàn)在分享給大家2017-08-08
手把手教你使用TypeScript開發(fā)Node.js應(yīng)用
為了減少代碼編寫過程中出現(xiàn)的錯誤,以及更好的維護(hù)你的項目,本文將手把手教你配置一個簡單的開發(fā)環(huán)境來編寫Node.js的應(yīng)用程序,感興趣的小伙伴們可以參考一下2019-05-05
node環(huán)境下運行js代碼缺少window環(huán)境的原因以及解決方法
Node是一個基于Chrome?V8引擎的運行環(huán)境,讓JavaScript運行在服務(wù)端的開發(fā)平臺,這篇文章主要給大家介紹了關(guān)于node環(huán)境下運行js代碼缺少window環(huán)境的原因以及解決方法,需要的朋友可以參考下2023-11-11

