從零開(kāi)始nodejs系列文章
從零開(kāi)始nodejs系列文章,將介紹如何利javascript做為服務(wù)端腳本,通過(guò)Nodejs框架web開(kāi)發(fā)。Nodejs框架是基于V8的引擎,是目前速度最快的Javascript引擎。Chrome瀏覽器就基于V8,同時(shí)打開(kāi)20-30個(gè)網(wǎng)頁(yè)都很流暢。Nodejs標(biāo)準(zhǔn)的web開(kāi)發(fā)框架ExPRess,可以幫助我們迅速建立web站點(diǎn),比起php的開(kāi)發(fā)效率更高,而且學(xué)習(xí)曲線更低。非常適合小型網(wǎng)站,個(gè)性化網(wǎng)站,我們自己的Geek網(wǎng)站!!
此文重點(diǎn)介紹Express3.0的開(kāi)發(fā)框架,其中還會(huì)涉及到Mongoose,Ejs,Bootstrap等相關(guān)內(nèi)容。Express已經(jīng)升級(jí)到4.x,請(qǐng)同時(shí)參考文章,Node.js開(kāi)發(fā)框架Express4.x
建立工程目錄結(jié)構(gòu)Express3.0配置文件Ejs模板使用Bootstrap界面框架路由功能session使用頁(yè)面提示頁(yè)面訪問(wèn)控制Win7旗艦版 64bit
MonogoDB: v2.4.3
Tue May 14 09:24:50.118 [initandlisten] MongoDB starting : pid=1716 port=27017 dbpath=./data 64-bit host=PC201304202140Tue May 14 09:24:50.119 [initandlisten] db version v2.4.3Tue May 14 09:24:50.119 [initandlisten] git version: fe1743177a5ea03e91e0052fb5e2cb2945f6d95fTue May 14 09:24:50.119 [initandlisten] build info: windows sys.getwindowsversion(major=6, minor=1, build=7601, platform=2, service_pack='Service Pack 1') BOOST_LIB_VERSION=1_49Tue May 14 09:24:50.119 [initandlisten] allocator: systemTue May 14 09:24:50.119 [initandlisten] options: { dbpath: "./data" }Tue May 14 09:24:50.188 [initandlisten] journal dir=./data/journalTue May 14 09:24:50.189 [initandlisten] recover : no journal files present, no recovery neededTue May 14 09:24:50.441 [initandlisten] preallocateIsFaster=true 3.26Tue May 14 09:24:50.778 [initandlisten] preallocateIsFaster=true 5.88Tue May 14 09:24:51.827 [initandlisten] waiting for connections on port 27017Tue May 14 09:24:51.827 [websvr] admin web console waiting for connections on port 28017nodejs: v0.10.5, npm 1.2.19
node -vv0.10.5npm -v1.2.191. 建立工程
進(jìn)入工程目錄
cd D:/workspace/project全局安裝express,express作為命令被安裝到了系統(tǒng)中
npm install -g express查看express版本
express -V3.2.2使用express命令創(chuàng)建工程,并支持ejs
D:/workspace/project>express -e nodejs-democreate : nodejs-democreate : nodejs-demo/package.jsoncreate : nodejs-demo/app.jscreate : nodejs-demo/publiccreate : nodejs-demo/public/javascriptscreate : nodejs-demo/public/imagescreate : nodejs-demo/public/stylesheetscreate : nodejs-demo/public/stylesheets/style.CSScreate : nodejs-demo/routescreate : nodejs-demo/routes/index.jscreate : nodejs-demo/routes/user.jscreate : nodejs-demo/viewscreate : nodejs-demo/views/index.ejsinstall dependencies:$ cd nodejs-demo && npm installrun the app:$ node app根據(jù)提示,下載依賴包
cd nodejs-demo && npm installexpress@3.2.2 node_modules/express├── methods@0.0.1├── fresh@0.1.0├── buffer-crc32@0.2.1├── range-parser@0.0.4├── cookie-signature@1.0.1├── cookie@0.0.5├── qs@0.6.3├── commander@0.6.1├── debug@0.7.2├── mkdirp@0.3.4├── send@0.1.0 (mime@1.2.6)└── connect@2.7.8 (pause@0.0.1, bytes@0.2.0, formidable@1.0.13)模板項(xiàng)目建立成功,啟動(dòng)模板項(xiàng)目。
D:/workspace/project/nodejs-demo>node app.jsExpress server listening on port 3000本地的3000端口被打開(kāi),通過(guò)瀏覽器訪問(wèn): localhost:3000
通過(guò)node啟動(dòng)程序,每次代碼修改都需要重新啟動(dòng)。 有一個(gè)工具supervisor,每次修改代碼后會(huì)自動(dòng)重啟,會(huì)我們開(kāi)發(fā)省很多的時(shí)間。
npm install supervisor再啟動(dòng)服務(wù)
D:/workspace/project/nodejs-demo>supervisor app.jsDEBUG: Running node-supervisor withDEBUG: program 'app.js'DEBUG: --watch '.'DEBUG: --ignore 'undefined'DEBUG: --extensions 'node|js'DEBUG: --exec 'node'DEBUG: Starting child process with 'node app.js'DEBUG: Watching directory 'D:/workspace/project/nodejs-demo' for changes.Express server listening on port 3000
2. 目錄結(jié)構(gòu)
D:/workspace/project/nodejs-demo>dir
2013/05/14 09:42 877 app.js2013/05/14 09:48 <DIR> node_modules2013/05/14 09:42 184 package.json2013/05/14 09:42 <DIR> public2013/05/14 09:42 <DIR> routes2013/05/14 09:42 <DIR> views
目錄介紹:
node_modules, 存放所有的項(xiàng)目依賴庫(kù)。(每個(gè)項(xiàng)目管理自己的依賴,與Maven,Gradle等不同)package.json,項(xiàng)目依賴配置及開(kāi)發(fā)者信息app.js,程序啟動(dòng)文件public,靜態(tài)文件(css,js,img)routes,路由文件(MVC中的C,controller)Views,頁(yè)面文件(Ejs模板)3. Express3.0配置文件
打開(kāi)app.js文件
/*** 模塊依賴*/var express = require('express'), routes = require('./routes'), user = require('./routes/user'), http = require('http'), path = require('path');var app = express();//環(huán)境變量app.set('port', process.env.PORT || 3000);app.set('views', __dirname + '/views');app.set('view engine', 'ejs');app.use(express.favicon());app.use(express.logger('dev'));app.use(express.bodyParser());app.use(express.methodOverride());app.use(app.router);app.use(express.static(path.join(__dirname, 'public')));// 開(kāi)發(fā)模式if ('development' == app.get('env')) {app.use(express.errorHandler());}// 路徑解析app.get('/', routes.index);app.get('/users', user.list);// 啟動(dòng)及端口http.createServer(app).listen(app.get('port'), function(){console.log('Express server listening on port ' + app.get('port'));});
4. Ejs模板使用
讓ejs模板文件,使用擴(kuò)展名為html的文件。
修改:app.js
app.engine('.html', ejs.__express);app.set('view engine', 'html');// app.set('view engine', 'ejs');修改后,ejs變量沒(méi)有定義,supervisor的程序會(huì)一直報(bào)錯(cuò)
ReferenceError: ejs is not definedat Object. (D:/workspace/project/nodejs-demo/app.js:17:21)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:901:3DEBUG: Program node app.js exited with code 8在app.js中增加ejs變量
var express = require('express'), routes = require('./routes'), user = require('./routes/user'), http = require('http'), path = require('path'), ejs = require('ejs');訪問(wèn)localhost:3000,程序報(bào)錯(cuò)
Error: Failed to lookup view "index"at Function.app.render (D:/workspace/project/nodejs-demo/node_modules/express/lib/application.js:495:17)at ServerResponse.res.render (D:/workspace/project/nodejs-demo/node_modules/express/lib/response.js:756:7)at exports.index (D:/workspace/project/nodejs-demo/routes/index.js:7:7)at callbacks (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:161:37)at param (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:135:11)at pass (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:142:5)at Router._dispatch (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:170:5)at Object.router (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:33:10)at next (D:/workspace/project/nodejs-demo/node_modules/express/node_modules/connect/lib/proto.js:190:15)at Object.methodOverride [as handle] (D:/workspace/project/nodejs-demo/node_modules/express/node_modules/connect/lib/middleware/methodOverride.js:37:5)GET / 500 26ms重命名:views/indes.ejs 為 views/index.html
訪問(wèn)localhost:3000正確
5. 增加Bootstrap界面框架
其實(shí)就是把js,css文件復(fù)制到項(xiàng)目中對(duì)應(yīng)該的目錄里。 包括4個(gè)文件:
復(fù)制到public/stylesheets目錄
bootstrap.min.cssbootstrap-responsive.min.css復(fù)制到public/javascripts目錄
bootstrap.min.jsjquery-1.9.1.min.js接下來(lái),我們把index.html頁(yè)面切分成3個(gè)部分:header.html, index.html, footer.html
header.html, 為html頁(yè)面的頭部區(qū)域index.html, 為內(nèi)容顯示區(qū)域footer.html,為頁(yè)面底部區(qū)域
header.html
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><title><%=: title %></title><!-- Bootstrap --><link href="/stylesheets/bootstrap.min.css" rel="stylesheet" media="screen"><!-- <link href="css/bootstrap-responsive.min.css" rel="stylesheet" media="screen"> --></head><body screen_capture_injected="true">index.html
<% include header.html %><h1><%= title %></h1><p>Welcome to <%= title %></p><% include footer.html %>注:express3.0時(shí),ejs嵌入其他頁(yè)面時(shí)使用include,express2.x用法不一樣。
footer.html
<script src="/javascripts/jquery-1.9.1.min.js"></script><script src="/javascripts/bootstrap.min.js"></script></body></html>訪問(wèn)localhost:3000正確。
我們已經(jīng)成功的使用了EJS模板的功能,把公共的頭部和底部從頁(yè)面中分離出來(lái)了。
并已經(jīng)引入了bootstrap界面框架,后面講到“登陸界面”的時(shí)候,就會(huì)看到bootstrap界面效果了。
6. 路由功能
我們?cè)O(shè)計(jì)一下用戶登陸業(yè)務(wù)需求。
訪問(wèn)路徑:/,頁(yè)面:index.html,不需要登陸,可以直接訪問(wèn)。訪問(wèn)路徑:/home,頁(yè)面:home.html,必須用戶登陸后,才可以訪問(wèn)。訪問(wèn)路徑:/login,頁(yè)面:login.html,登陸頁(yè)面,用戶名密碼輸入正確,自動(dòng)跳轉(zhuǎn)到home.html訪問(wèn)路徑:/logout,頁(yè)面:無(wú),退出登陸后,自動(dòng)回到index.html頁(yè)面打開(kāi)app.js文件,在增加路由配置
app.get('/', routes.index);app.get('/login', routes.login);app.post('/login', routes.doLogin);app.get('/logout', routes.logout);app.get('/home', routes.home);注:get為get請(qǐng)求,post為post請(qǐng)求,all為所有針對(duì)這個(gè)路徑的請(qǐng)求
我們打開(kāi)routes/index.js文件,增加對(duì)應(yīng)的方法。
exports.index = function(req, res){res.render('index', { title: 'Index' });};exports.login = function(req, res){res.render('login', { title: '用戶登陸'});};exports.doLogin = function(req, res){var user={username:'admin',passWord:'admin'}if(req.body.username===user.username && req.body.password===user.password){res.redirect('/home');}res.redirect('/login');};exports.logout = function(req, res){res.redirect('/');};exports.home = function(req, res){var user={username:'admin',password:'admin'}res.render('home', { title: 'Home',user: user});};創(chuàng)建views/login.html和views/home.html兩個(gè)文件
login.html
<% include header.html %><div class="container-fluid"><form class="form-horizontal" method="post"><fieldset><legend>用戶登陸</legend><div class="control-group"><label class="control-label" for="username">用戶名</label><div class="controls"><input type="text" class="input-xlarge" id="username" name="username"></div></div><div class="control-group"><label class="control-label" for="password">密碼</label><div class="controls"><input type="password" class="input-xlarge" id="password" name="password"></div></div><div class="form-actions"><button type="submit" class="btn btn-primary">登陸</button></div></fieldset></form></div><% include footer.html %>
注:使用了bootstrap界面框架,效果還不錯(cuò)吧.
home.html
<% include header.html %><h1>Welcome <%= user.username %>, 歡迎登陸!!</h1><a claa="btn" href="/logout">退出</a><% include footer.html %>修改index.html,增加登陸鏈接index.html
<% include header.html %><h1>Welcome to <%= title %></h1><p><a href="/login">登陸</a></p><% include footer.html %>路由及頁(yè)面我們都寫好了,快去網(wǎng)站上試試吧。
7. Session使用
從剛來(lái)的例子上面看,執(zhí)行exports.doLogin時(shí),如果用戶名和密碼正確,我們使用redirect方法跳轉(zhuǎn)到的home
res.redirect('/home');執(zhí)行exports.home時(shí),我們又用render渲染頁(yè)面,并把user對(duì)象傳給home.html頁(yè)面
res.render('home', { title: 'Home',user: user});為什么不能在doLogin時(shí),就把user對(duì)象賦值給session,每個(gè)頁(yè)面就不再傳值了。
session這個(gè)問(wèn)題,其實(shí)是涉及到服務(wù)器的底層處理方式。
像Java的web服務(wù)器,是多線程調(diào)用模型。每用戶請(qǐng)求會(huì)打開(kāi)一個(gè)線程,每個(gè)線程在內(nèi)容中維護(hù)著用戶的狀態(tài)。
像PHP的web服務(wù)器,是交行CGI的程序處理,CGI是無(wú)狀態(tài)的,所以一般用cookie在客戶的瀏覽器是維護(hù)用戶的狀態(tài)。但cookie在客戶端維護(hù)的信息是不夠的,所以CGI應(yīng)用要模仿用戶session,就需要在服務(wù)器端生成一個(gè)session文件存儲(chǔ)起來(lái),讓原本無(wú)狀態(tài)的CGI應(yīng)用,通過(guò)中間文件的方式,達(dá)到session的效果。
Nodejs的web服務(wù)器,也是CGI的程序無(wú)狀態(tài)的,與PHP不同的地方在于,單線程應(yīng)用,所有請(qǐng)求都是異步響應(yīng),通過(guò)callback方式返回?cái)?shù)據(jù)。如果我們想保存session數(shù)據(jù),也是需要找到一個(gè)存儲(chǔ),通過(guò)文件存儲(chǔ),redis,Mongdb都可以。
接下來(lái),我將演示如何通過(guò)mongodb來(lái)保存session,并實(shí)現(xiàn)登陸后用戶對(duì)象傳遞。
app.js文件
var express = require('express'), routes = require('./routes'), user = require('./routes/user'), http = require('http'), path = require('path'), ejs = require('ejs'), SessionStore = require("session-mongoose")(express);var store = new SessionStore({url: "mongodb://localhost/session",interval: 120000});....app.use(express.favicon());app.use(express.logger('dev'));app.use(express.bodyParser());app.use(express.methodOverride());app.use(express.cookieParser());app.use(express.cookieSession({secret : 'fens.me'}));app.use(express.session({secret : 'fens.me',store: store,cookie: { maxAge: 900000 }}));app.use(function(req, res, next){res.locals.user = req.session.user;next();});app.use(app.router);app.use(express.static(path.join(__dirname, 'public')));注:app.js文件有順序要求,一定要注意!!!
安裝session-mongoose依賴庫(kù)
D:/workspace/project/nodejs-demo>npm install session-mongooseD:/workspace/project/nodejs-demo/node_modules/session-mongoose/node_modules/mongoose/node_modules/mongodb/node_modules/bson>node "D:/toolkit/nodejs/node_modules/npm/bin/node-gyp-bin//../../node_modules/node-gyp/bin/node-gyp.js" rebuildC:/Program Files (x86)/MSBuild/Microsoft.Cpp/v4.0/Microsoft.Cpp.InvalidPlatform.Targets(23,7): error MSB8007: 項(xiàng)目“kerberos.vcxproj”的平臺(tái)無(wú)效。平臺(tái)為“x64”。您會(huì)看到此消息的可能原因是,您嘗試在沒(méi)有解決方案文件的情況下生成項(xiàng)目,并且為oose/node_modules/mongoose/node_modules/mongodb/node_modules/bson/build/bson.vcxproj]session-mongoose@0.2.2 node_modules/session-mongoose└── mongoose@3.6.10 (mpath@0.1.1, ms@0.1.0, hooks@0.2.1, sliced@0.0.3, muri@0.3.1, mpromise@0.2.1, mongodb@1.3.3)安裝有錯(cuò)誤但是沒(méi)關(guān)系。
訪問(wèn):http://localhost:3000/login,正常
修改routes/index.js文件
exports.doLogin方法
exports.doLogin = function(req, res){var user={username:'admin',password:'admin'}if(req.body.username===user.username && req.body.password===user.password){req.session.user=user;return res.redirect('/home');} else {return res.redirect('/login');}};exports.logout方法
exports.logout = function(req, res){req.session.user=null;res.redirect('/');};exports.home方法
exports.home = function(req, res){res.render('home', { title: 'Home'});};這個(gè)時(shí)候session已經(jīng)起作用了,exports.home的user顯示傳值已經(jīng)被去掉了。 是通過(guò)app.js中app.use的res.locals變量,通過(guò)框架進(jìn)行的賦值。
app.use(function(req, res, next){res.locals.user = req.session.user;next();});注:這個(gè)session是express3.0的寫法,與express2.x是不一樣的。原理是在框架內(nèi)每次賦值,把我們剛才手動(dòng)傳值的過(guò)程,讓框架去完成了。
8. 頁(yè)面提示
登陸的大體我們都已經(jīng)講完了,最后看一下登陸失敗的情況。
我們希望如果用戶登陸時(shí),用戶名或者密碼出錯(cuò)了,會(huì)給用戶提示,應(yīng)該如何去實(shí)現(xiàn)。
打開(kāi)app.js的,增加res.locals.message
app.use(function(req, res, next){res.locals.user = req.session.user;var err = req.session.error;delete req.session.error;res.locals.message = '';if (err) res.locals.message = '<div class="alert alert-error">' + err + '</div>';next();});修改login.html頁(yè)面,<%- message %>
<% include header.html %><div class="container-fluid"><form class="form-horizontal" method="post"><fieldset><legend>用戶登陸</legend><%- message %><div class="control-group"><label class="control-label" for="username">用戶名</label><div class="controls"><input type="text" class="input-xlarge" id="username" name="username" value="admin"></div></div><div class="control-group"><label class="control-label" for="password">密碼</label><div class="controls"><input type="password" class="input-xlarge" id="password" name="password" value="admin"></div></div><div class="form-actions"><button type="submit" class="btn btn-primary">登陸</button></div></fieldset></form></div><% include footer.html %>修改routes/index.js,增加req.session.error
exports.doLogin = function(req, res){var user={username:'admin',password:'admin'}if(req.body.username===user.username && req.body.password===user.password){req.session.user=user;return res.redirect('/home');} else {req.session.error='用戶名或密碼不正確';return res.redirect('/login');}};讓我們來(lái)看看效果: http://localhost:3000/login 輸入錯(cuò)誤的和密碼, 用戶名:adminfe,密碼:12121

9. 頁(yè)面訪問(wèn)控制
網(wǎng)站登陸部分按照我們的求已經(jīng)完成了,但網(wǎng)站并不安全。
localhost:3000/home,頁(yè)面本來(lái)是登陸以后才訪問(wèn)的,現(xiàn)在我們不要登陸,直接在瀏覽器輸入也可訪問(wèn)。
頁(yè)面報(bào)錯(cuò)了,提示<%= user.username %> 變量出錯(cuò)。
GET /home?user==a 500 15msTypeError: D:/workspace/project/nodejs-demo/views/home.html:21| <% include header.html %>>> 2| <h1>Welcome <%= user.username %>, 歡迎登陸!!</h1>3| <a claa="btn" href="/logout">退出</a>4| <% include header.html %>Cannot read property 'username' of nullat eval (eval at <anonymous> (D:/workspace/project/nodejs-demo/node_modules/ejs/lib/ejs.js:at eval (eval at <anonymous> (D:/workspace/project/nodejs-demo/node_modules/ejs/lib/ejs.js:at D:/workspace/project/nodejs-demo/node_modules/ejs/lib/ejs.js:249:15at Object.exports.render (D:/workspace/project/nodejs-demo/node_modules/ejs/lib/ejs.js:287:at View.exports.renderFile [as engine] (D:/workspace/project/nodejs-demo/node_modules/ejs/lat View.render (D:/workspace/project/nodejs-demo/node_modules/express/lib/view.js:75:8)at Function.app.render (D:/workspace/project/nodejs-demo/node_modules/express/lib/applicatiat ServerResponse.res.render (D:/workspace/project/nodejs-demo/node_modules/express/lib/resat exports.home (D:/workspace/project/nodejs-demo/routes/index.js:36:8)at callbacks (D:/workspace/project/nodejs-demo/node_modules/express/lib/router/index.js:161這個(gè)頁(yè)面被打開(kāi)發(fā),因?yàn)闆](méi)有user.username參數(shù)。我們避免這樣的錯(cuò)誤發(fā)生。
還記錄路由部分里說(shuō)的get,post,all的作用嗎?我現(xiàn)在要回到路由配置中,再做點(diǎn)事情。
修改app.js文件
app.all('/login', notAuthentication);app.get('/login', routes.login);app.post('/login', routes.doLogin);app.get('/logout', authentication);app.get('/logout', routes.logout);app.get('/home', authentication);app.get('/home', routes.home);訪問(wèn)控制:
/ ,誰(shuí)訪問(wèn)都行,沒(méi)有任何控制/login,用all攔截所有訪問(wèn)/login的請(qǐng)求,先調(diào)用authentication,用戶登陸檢查/logout,用get攔截訪問(wèn)/login的請(qǐng)求,先調(diào)用notAuthentication,用戶不登陸檢查/home,用get攔截訪問(wèn)/home的請(qǐng)求,先調(diào)用Authentication,用戶登陸檢查修改app.js文件,增加authentication,notAuthentication兩個(gè)方法
function authentication(req, res, next) {if (!req.session.user) {req.session.error='請(qǐng)先登陸';return res.redirect('/login');}next();}function notAuthentication(req, res, next) {if (req.session.user) {req.session.error='已登陸';return res.redirect('/');}next();}配置好后,我們未登陸,直接訪問(wèn)localhost:3000/home時(shí),就會(huì)跳到/login頁(yè)面

如果你也出現(xiàn)圖片顯示的內(nèi)容,那么恭喜你了。
Nodejs使用Express3.0框架的第一步你已經(jīng)完成了,并且還使用了ejs,bootstrap,mongoose庫(kù)的使用。
希望此文對(duì)大家有所幫助。
Express已經(jīng)升級(jí)到4.x,請(qǐng)同時(shí)參考文章,Node.js開(kāi)發(fā)框架Express4.x
轉(zhuǎn)載自:http://blog.fens.me/nodejs-express3/
新聞熱點(diǎn)
疑難解答
圖片精選