安裝express框架
備注:這個(gè)需要root權(quán)限
npm install -g express-generator 全局安裝express框架
express -V可查詢express是否安裝成功
express -h 選項(xiàng)可列出所有可用的命令行選項(xiàng)
express建項(xiàng)目
在你想要生成項(xiàng)目的文件夾中執(zhí)行命令:
express myapp
創(chuàng)建項(xiàng)目時(shí)生成的文件及文件夾
然后cd進(jìn)入新建項(xiàng)目的目錄,安裝所有依賴包(主要是根據(jù)package.json這個(gè)文件里面的包進(jìn)行搜索安裝)
cd myapp
npm install
安裝的過程可能會(huì)比較緩慢,這個(gè)主要看網(wǎng)速了...不過我一下子就好了
然后cd進(jìn)入項(xiàng)目中bin目錄,啟動(dòng)項(xiàng)目
./www
如果在項(xiàng)目外可執(zhí)行./bin/www
最后在瀏覽器中輸入你當(dāng)前服務(wù)器ip地址以及端口號(hào)3000,便可以訪問...
express生成的應(yīng)用目錄結(jié)構(gòu)
|-- app.js
|-- bin
| I__ www
|-- package.json
|-- public
| I__ images
| I__ javascripts
| I__ stylesheets
| I__style.css
I__ views
|-- index.jade
I-- error.jade
I-- layout.jade
目錄詳細(xì)介紹
目錄結(jié)構(gòu)
bin 存放啟動(dòng)項(xiàng)目的腳本文件
node_modules 項(xiàng)目所有依賴的庫(kù),以及存放
package.json中安裝的模塊,添加依賴的模塊并安
裝后,存放在這個(gè)文件夾下
public 靜態(tài)文件(css,js,img)
routes 路由文件(mvc中cotroller)
views 頁(yè)面文件(jade模板) 可以更換模板e(cuò)js
package.json 存儲(chǔ)著工程的信息及模塊依賴
app.js 應(yīng)用核心配置文件(入口文件)
package.json文件
package.json用于項(xiàng)目依賴配置及開發(fā)者信
息,scripts屬性時(shí)用于定義操作命令,可以非常方便
的添加啟動(dòng)命令,比如默認(rèn)的start,用npm start代表
執(zhí)行node ./bin/www命令.擋在dependencies中添
加依賴的模塊時(shí),運(yùn)行npm install,npm會(huì)檢查當(dāng)前
目錄下的package.json,并自動(dòng)安裝所有指定的模塊
app.js 核心文件,也是項(xiàng)目入口文件
var express = require('express');
//用于處理目錄的對(duì)象,提高開發(fā)效率
var path = require('path');
//用于加載圖標(biāo)
var favicon = require('serve-favicon');
/在控制臺(tái)中,顯示req請(qǐng)求的信息
var logger = require('morgan');
//加載cooike模塊,用于獲取web瀏覽器發(fā)送的cookie中的內(nèi)容
var cookieParser = require('cookie-parser');
//解析客戶端請(qǐng)求的body中的內(nèi)容,內(nèi)部使用json編碼處理,url編碼處理以及對(duì)于文件的上傳處理
var bodyParser = require('body-parser');
var routes = require('./routes/index');
var users = require('./routes/users');
//生成一個(gè)express實(shí)例app
var app = express();
// view engine setup
//設(shè)置views文件夾,__dirname是node.js里面的全局變量,取得執(zhí)行js所在的路徑
app.set('views', path.join(__dirname, 'views'));
//視圖引擎設(shè)置
app.set('view engine', 'jade');
// uncomment after placing your favicon in /public
//定義icon圖標(biāo),參數(shù)為圖標(biāo)的路勁,如果不指明,則用默認(rèn)的express圖標(biāo)
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));
//加載日志中間件,定義日志和輸出級(jí)別
app.use(logger('dev'));
//加載解析json的中間件,接收json請(qǐng)求
app.use(bodyParser.json());
//加載解析urlencodeed請(qǐng)求體的中間件
app.use(bodyParser.urlencoded({ extended: false }));
//加載cookie的中間件
app.use(cookieParser());
//靜態(tài)文件目錄設(shè)置,設(shè)置public文件夾為存放靜態(tài)文件的目錄
app.use(express.static(path.join(__dirname, 'public')));
//路由控制器
app.use('/', routes);
app.use('/users', users);
//捕捉404錯(cuò)誤,并轉(zhuǎn)發(fā)到錯(cuò)誤處理器
// 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
//開發(fā)環(huán)境下的500錯(cuò)誤處理器,將錯(cuò)誤信息渲染error模板并顯示到瀏覽器中
// 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
});
});
}
//生產(chǎn)環(huán)境下的錯(cuò)誤處理器,將錯(cuò)誤信息渲染error模板并顯示到瀏覽器中
// 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: {}
});
});
//導(dǎo)出app實(shí)例供其他模塊調(diào)用
module.exports = app;
bin/www文件
www文件內(nèi)容:這里擁有著http服務(wù)器基本配置,www文件也是一個(gè)node腳本,用于分離配置和啟動(dòng)程序時(shí)用,代碼如下:
edwin@edwinxdf:~/express_demo/myapp/bin$ vim www
//表明是node可執(zhí)行文件
#!/usr/bin/env node
/**
* Module dependencies.
*/
//引入上面導(dǎo)出的app實(shí)例
var app = require('../app');
//引入debug模塊,打印調(diào)試日志
var debug = require('debug')('myapp:server');
var http = require('http');
/**
* Get port from environment and store in Express.
*/
//定義啟動(dòng)端口
var port = normalizePort(process.env.PORT || '3000');
app.set('port', port);
/**
* Create HTTP server.
*/
var server = http.createServer(app);
/**
* Listen on provided port, on all network interfaces.
*/
server.listen(port);
server.on('error', onError);
server.on('listening', onListening);
/**
* Normalize a port into a number, string, or false.
*/
//端口標(biāo)準(zhǔn)化函數(shù)
function normalizePort(val) {
var port = parseInt(val, 10);
if (isNaN(port)) {
// named pipe
return val;
}
if (port >= 0) {
// port number
return port;
}
return false;
}
/**
* Event listener for HTTP server "error" event.
*/
//HTTP異常事件處理函數(shù)
function onError(error) {
if (error.syscall !== 'listen') {
throw error;
}
var bind = typeof port === 'string'
? 'Pipe ' + port
: 'Port ' + port;
// handle specific listen errors with friendly messages
switch (error.code) {
case 'EACCES':
console.error(bind + ' requires elevated privileges');
process.exit(1);
break;
case 'EADDRINUSE':
console.error(bind + ' is already in use');
process.exit(1);
break;
default:
throw error;
}
}
/**
* Event listener for HTTP server "listening" event.
*/
//事件綁定函數(shù)
function onListening() {
var addr = server.address();
var bind = typeof addr === 'string'
? 'pipe ' + addr
: 'port ' + addr.port;
debug('Listening on ' + bind);
}
routes
生成一個(gè)路由實(shí)例用來捕獲訪問主頁(yè)的get請(qǐng)求,導(dǎo)出這個(gè)路由并在app.js中通過app.use("/",routes);加載,這樣當(dāng)訪問主頁(yè)時(shí),就會(huì)調(diào)用res.render("index",{'title':'Express'});渲染views/index.jade模板并顯示到瀏覽器中
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;
關(guān)于路由,路由中有兩個(gè)常用功能:
app.route()函數(shù),創(chuàng)建可連接的途徑處理程序的路由路徑
express.Router類,創(chuàng)建模塊化安裝路徑的處理程序
app.Route方法會(huì)返回一個(gè)Route實(shí)例,它可以繼續(xù)使用所有的HTTP方法,包括get,post,all,put,delete,head等
app.route('/users')
.get(function(req,res,next){})
.post(function(req,res,next){})
express.Router類,則可以幫助我們更好的組織代碼結(jié)構(gòu),在app.js文件中,定義了app.use('/',routes);routes是指向了routes目錄下的index.js文件,./routes/index.js文件中,express.Router被定義使用,路徑/*處理都會(huì)由routes/index.js文件里的Router來處理,如果我們要管理不同的路口經(jīng),那么可以直接配置為多個(gè)不同的Router
1 app.use('/user', require('./routes/user').user);
2 app.use('/admin',require('./routes/admin').admin);
3 app.use('/', require('./routes'));
