Express.JS使用詳解
安裝了node(下載)之后, 在你的機(jī)器上創(chuàng)建一個(gè)目錄，開始你的第一個(gè)應(yīng)用程序。
$ mkdir hello-world
在這個(gè)目錄中你將定義應(yīng)用程序“包”,這和任何其他node的包沒有什么不同。文件目錄中的json文件,明確定義了一個(gè)依賴項(xiàng)。你可以用npm命令獲取express最新版本,你喜歡這樣做,而不是安裝“3.x”以外的版本，以防止任何未知的驚喜。
{
"name": "hello-world",
"description": "hello world test app",
"version": "0.0.1",
"private": true,
"dependencies": {
"express": "3.x"
}
}
現(xiàn)在,您已經(jīng)有了一個(gè)包。json文件在這個(gè)目錄你可以使用npm(1)安裝這種依賴關(guān)系,在這種情況下只需要輸入:
$ npm install
一旦npm完成,你就會(huì)在/node_modules目錄中存有一個(gè)你依賴的Express 3.x。您可以用npm ls驗(yàn)證這一點(diǎn),就像以下代碼片段所展示的Express樹和自己的依賴關(guān)系。
$ npm ls hello-world@0.0.1 /private/tmp └─┬ express@3.0.0beta7 ├── commander@0.6.1 ├─┬ connect@2.3.9 │ ├── bytes@0.1.0 │ ├── cookie@0.0.4 │ ├── crc@0.2.0 │ ├── formidable@1.0.11 │ └── qs@0.4.2 ├── cookie@0.0.3 ├── debug@0.7.0 ├── fresh@0.1.0 ├── methods@0.0.1 ├── mkdirp@0.3.3 ├── range-parser@0.0.4 ├─┬ response-send@0.0.1 │ └── crc@0.2.0 └─┬ send@0.0.3 └── mime@1.2.6
現(xiàn)在來(lái)創(chuàng)建應(yīng)用程序本身!創(chuàng)建一個(gè)名為app.js或server.js文件,不論你喜歡哪一個(gè),引入express,然后用express()創(chuàng)建一個(gè)新的應(yīng)用程序:
var express = require('express');
var app = express();
新應(yīng)用程序?qū)嵗梢酝ㄟ^(guò)app.VERB()開始定義路線,在這種情況下,通過(guò)“Hello World”字符串回應(yīng)“GET/”請(qǐng)求。req和res是提供給您的完全相同的node對(duì)象,因此你可能會(huì)調(diào)用res.pipe(),req.on('data', callback) 和其他你會(huì)做的與Express無(wú)關(guān)的事情。
Express增強(qiáng)這些對(duì)象為你提供更高層次的接口如res.send(),除此之外為你添加內(nèi)容長(zhǎng)度:
app.get('/hello.txt', function(req, res){
res.send('Hello World');
});
現(xiàn)在為連接調(diào)用app.listen()方法綁定和監(jiān)聽,接受相同的參數(shù)作為節(jié)點(diǎn)的net.Server #listen():
var server = app.listen(3000, function() {
console.log('Listening on port %d', server.address().port);
});
使用express(1)來(lái)生成應(yīng)用程序
Express團(tuán)隊(duì)維護(hù)便捷的項(xiàng)目生成器,命名為express-generator(1)。如果你用npm全局安裝express-generator，那么你可以從你電腦的任何地方訪問(wèn)到它:
$ npm install -g express-generator
這個(gè)工具提供了一種簡(jiǎn)單的方法來(lái)得到一個(gè)應(yīng)用程序框架,但范圍有限,例如,它只支持幾個(gè)模板引擎，而Express自己事實(shí)上支持為node建立任何網(wǎng)站框架模板?？赏ㄟ^(guò)help查看:
Usage: express [options] Options: -h, --help output usage information -V, --version output the version number -e, --ejs add ejs engine support (defaults to jade) -H, --hogan add hogan.js engine support -c, --css add stylesheet support (less|stylus|compass) (defaults to plain css) -f, --force force on non-empty directory
如果你想生成一個(gè)任何情況都支持的應(yīng)用程序您只需要簡(jiǎn)單地執(zhí)行:：
$ express --css stylus myapp create : myapp create : myapp/package.json create : myapp/app.js create : myapp/public create : myapp/public/javascripts create : myapp/public/images create : myapp/public/stylesheets create : myapp/public/stylesheets/style.styl create : myapp/routes create : myapp/routes/index.js create : myapp/views create : myapp/views/index.jade create : myapp/views/layout.jade install dependencies: $ cd myapp && npm install run the app: $ DEBUG=myapp node app
像任何其他node的應(yīng)用程序,您必須安裝以下的依賴關(guān)系:
然后讓我們開始吧。
$ npm start
這是所有你需要讓一個(gè)簡(jiǎn)單的應(yīng)用程序啟動(dòng)并運(yùn)行。記住,Express不綁定到任何特定的目錄結(jié)構(gòu),這些只是給你一個(gè)指導(dǎo)。應(yīng)用程序結(jié)構(gòu)的選擇可在github庫(kù)中查看 示例 。
錯(cuò)誤處理
錯(cuò)誤處理中間件定義就像普通中間件,然而必須定義4個(gè)參數(shù)數(shù)量,這是函數(shù)簽名(err, req, res, next):
app.use(function(err, req, res, next){
console.error(err.stack);
res.send(500, 'Something broke!');
});
雖然強(qiáng)制的錯(cuò)誤處理中間件通常不是定義在最后,但在其他app.use()后，其調(diào)用如下所示:
var bodyParser = require('body-parser');
var methodOverride = require('method-override');
app.use(bodyParser());
app.use(methodOverride());
app.use(app.router);
app.use(function(err, req, res, next){
// logic
});
在這些中間件的響應(yīng)是完全任意的。您可能希望回應(yīng)一個(gè)HTML錯(cuò)誤頁(yè)面,一個(gè)簡(jiǎn)單的消息,一個(gè)JSON字符串,或任何其他你喜歡的回應(yīng)。
為構(gòu)建有組織的和更高層次的框架，你可以定義幾個(gè)這些錯(cuò)誤處理中間件,就像你會(huì)定義普通中間件。例如假設(shè)您想為XHR請(qǐng)求定義一個(gè)錯(cuò)誤處理器,除了這些之外,你可能會(huì)做的事如下:
var bodyParser = require('body-parser');
var methodOverride = require('method-override');
app.use(bodyParser());
app.use(methodOverride());
app.use(app.router);
app.use(logErrors);
app.use(clientErrorHandler);
app.use(errorHandler);
在更一般的logErrors可以寫請(qǐng)求和錯(cuò)誤信息到stderr,loggly,或類似的服務(wù):
function logErrors(err, req, res, next) {
console.error(err.stack);
next(err);
}
clientErrorHandler的定義如下所示，,注意,這個(gè)錯(cuò)誤將顯式地傳遞到下一個(gè)。
function clientErrorHandler(err, req, res, next) {
if (req.xhr) {
res.send(500, { error: 'Something blew up!' });
} else {
next(err);
}
}
以下errorHandler“全方位”實(shí)現(xiàn)可以定義為:
function errorHandler(err, req, res, next) {
res.status(500);
res.render('error', { error: err });
}
用戶在線計(jì)數(shù)
本節(jié)詳細(xì)完整講解一個(gè)(小)應(yīng)用程序,使用Redis跟蹤用戶在線數(shù)量。首先創(chuàng)建一個(gè)包。json文件包含兩個(gè)附件,一個(gè)用于redis客戶端,另一個(gè)用于Express自己。也確保你已包裝了redis并且通過(guò)$redis-server運(yùn)行。
{
"name": "app",
"version": "0.0.1",
"dependencies": {
"express": "3.x",
"redis": "*"
}
}
接下來(lái),你需要?jiǎng)?chuàng)建一個(gè)應(yīng)用程序,和一個(gè)到redis的連接:
var express = require('express');
var redis = require('redis');
var db = redis.createClient();
var app = express();
接下來(lái)的中間件跟蹤在線用戶。在這里我們將使用排序集,這樣我們通過(guò)可以redis查詢?cè)诰€用戶，僅需要N毫秒。我們通過(guò)時(shí)間戳作為成員的“在線標(biāo)準(zhǔn)”。注意, 這里我們使用user-agent字符串代替通常的用戶id。
app.use(function(req, res, next){
var ua = req.headers['user-agent'];
db.zadd('online', Date.now(), ua, next);
});
下一個(gè)中間件是在最后一刻使用zrevrangebyscore來(lái)獲取最大在線用戶數(shù)量，我們總是得到最近在線的用戶,他的上限是當(dāng)前時(shí)間戳減去60000毫秒。
app.use(function(req, res, next){
var min = 60 * 1000;
var ago = Date.now() - min;
db.zrevrangebyscore('online', '+inf', ago, function(err, users){
if (err) return next(err);
req.online = users;
next();
});
});
最后,我們通過(guò)一個(gè)url使用它,并綁定到一個(gè)端口!這就完了,在一個(gè)新瀏覽器訪問(wèn)這個(gè)應(yīng)用程序,您會(huì)看到在線人數(shù)增加。
app.get('/', function(req, res){
res.send(req.online.length + ' users online');
});
app.listen(3000);
Expree的反向代理
在反向代理背后使用Expree,如Varnish 或Nginx是微不足道的,然而它需要配置。通過(guò)啟用“信任代理”設(shè)置app.enable(“trust proxy”),Express有一些反向代理的技巧，X-Forwarded - *頭字段可能是可信的,否則他們可能很容易被欺騙。
啟用該設(shè)置有一些微妙的影響。第一個(gè)是X-Forwarded-Proto可能被反向代理設(shè)定，告訴app那是https或者只是簡(jiǎn)單的http。這個(gè)值由req.protocol反射。
第二個(gè)變化是req.ip和req.ips值將填充X-Forwarded-For地址的列表。
調(diào)試Express
Express內(nèi)部使用調(diào)試模塊記錄路徑匹配和應(yīng)用程序模式的信息。要看到這條信息,只要簡(jiǎn)單設(shè)置調(diào)試環(huán)境變量為express:*,當(dāng)啟動(dòng)應(yīng)用程序后，你將在控制臺(tái)看以調(diào)試信息。
$ DEBUG=express:* node ./bin/www
運(yùn)行這個(gè)hello world示例將打印以下內(nèi)容：
express:application booting in development mode +0ms express:router defined get /hello.txt +0ms express:router defined get /hello.txt +1ms
另外, 表達(dá)可執(zhí)行(生成器)生成的程序也使用調(diào)試模塊,默認(rèn)作用域是my-application調(diào)試命名空間。
你可以用以下命令啟用這些調(diào)試語(yǔ)句
$ DEBUG=my-application node ./bin/www
關(guān)于調(diào)試的更多信息,請(qǐng)參見調(diào)試 指南
相關(guān)文章
Node.js發(fā)送HTTP客戶端請(qǐng)求并顯示響應(yīng)結(jié)果的方法示例
這篇文章主要介紹了Node.js發(fā)送HTTP客戶端請(qǐng)求并顯示響應(yīng)結(jié)果的方法,結(jié)合完整實(shí)例形式分析了nodejs發(fā)送http請(qǐng)求及響應(yīng)的相關(guān)操作技巧,需要的朋友可以參考下2017-04-04
這篇文章主要介紹了nodejs 使用 js 模塊的方法，本文給大家介紹的非常詳細(xì)，具有一定的參考借鑒價(jià)值 ,需要的朋友可以參考下2018-12-12
Node.js中的EventEmitter類使用小結(jié)
EventEmitter 是 Node.js 中的一個(gè)核心模塊,它提供了一種實(shí)現(xiàn)事件驅(qū)動(dòng)編程的機(jī)制,它是一個(gè)基于觀察者模式的類,用于在應(yīng)用程序中處理事件和觸發(fā)事件,這篇文章主要介紹了Node.js中的EventEmitter類介紹,需要的朋友可以參考下2023-12-12
node.js中的http.response.writeHead方法使用說(shuō)明
這篇文章主要介紹了node.js中的http.response.writeHead方法使用說(shuō)明,本文介紹了http.response.writeHead的方法說(shuō)明、語(yǔ)法、接收參數(shù)、使用實(shí)例和實(shí)現(xiàn)源碼,需要的朋友可以參考下2014-12-12
Node.js通過(guò)配置?strict-ssl=false解決npm安裝卡住問(wèn)題
使用npm安裝依賴包是常見的任務(wù)之一,有時(shí)會(huì)遇到安裝卡住的問(wèn)題,本文就來(lái)介紹一下通過(guò)配置?strict-ssl=false解決npm安裝卡住問(wèn)題,感興趣的可以了解一下2024-12-12
這篇文章主要介紹了使用nvm安裝|更新|切換|nodejs的命令詳解,有了nvm就可以簡(jiǎn)單操作node版本的切換、安裝、查看等，需要的朋友可以參考下2022-07-07
在Node.js應(yīng)用中使用Redis的方法簡(jiǎn)介
這篇文章主要介紹了在Node.js應(yīng)用中使用Redis的方法,最簡(jiǎn)單的數(shù)據(jù)讀寫操作相關(guān),需要的朋友可以參考下2015-06-06
本文給大家介紹了nodejs 連接Mysql相關(guān)操作的示例代碼，主要用到的是sql語(yǔ)句，都是比較基礎(chǔ)的。2017-05-05
nodejs操作mongodb的填刪改查模塊的制作及引入實(shí)例
下面小編就為大家分享一篇nodejs操作mongodb的填刪改查模塊的制作及引入實(shí)例，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-01-01
nodejs express搭建服務(wù)并熱更新文件過(guò)程詳解
這篇文章主要為大家介紹了nodejs express搭建服務(wù)并熱更新文件過(guò)程詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-11-11