Node.js 究竟能做什麼、在哪些領域應用廣泛,或許每個人都有自己的答案。本文記錄了作者業餘時間用 Node.js 搭建一個網站及其後台管理的完整過程,並總結了實踐中遇到的種種問題。核心體會是:喜歡一項技術可以拿來玩,但要真正用於項目,就必須花時間去解決大量實際問題。
本項目使用的技術棧為:
jade 支持 include,可以引入局部視圖(類似 asp.net 的用戶控件):
include ./includes/header
支持 extends 繼承母版頁:
extends ../layout
for 循環也非常簡潔:
each item in userList
tr
td #{item.username}
td #{item.telephone}
td #{item.email}
作者特別喜歡 append,它會把腳本和樣式全部放到母版頁 head 之後:
extends ../admin_layout
append head
link(rel='stylesheet', href='/stylesheets/font-awesome.css')
script(src='/javascripts/bootstrap.js')
block content
sequelize 支持 sqlite、mysql、mongodb 等多種數據庫。定義一個文章模型:
var Article = sequelize.define('Article',{
title:{ type:Sequelize.STRING, validate:{} },
content:{type:Sequelize.STRING,validate:{}},
icon:{type:Sequelize.STRING,validate:{}},
iconname:{type:Sequelize.STRING},
sequencing:{type:Sequelize.STRING,validate:{}}
},{
classMethods:{
getCountAll:function(objFun){ } // 文章分類統計
}
});
Article.belongsTo(Category); // 每篇文章都有一個分類
作者把分頁相關方法寫進了 sequelize 初始化時的 define 配置中,這樣每個模型都會自帶這些方法:
var sequelize = new Sequelize('database', 'username', 'password', {
dialect: 'sqlite',
storage: config.sqlitePath,
define:{
classMethods:{
pageOffset:function(pageNum){
if(isNaN(pageNum) || pageNum < 1){ pageNum = 1; }
return (pageNum - 1) * this.pageLimit();
},
pageLimit:function(){ return 10; }, // 每頁顯示 10 條
totalPages:function(totalNum){
var total = parseInt((totalNum + this.pageLimit() - 1) / this.pageLimit()),
arrayTotalPages = [];
for(var i=1; i<= total; i++){ arrayTotalPages.push(i); }
return arrayTotalPages;
}
}
}
});
使用分頁查詢:
Article.findAndCountAll({include:[Category],offset:Article.pageOffset(req.query.pageNum), limit:Article.pageLimit()}).success(function(row){
res.render('article_list', {
title: '文章管理',
articleList : row.rows,
pages:{
totalPages:Article.totalPages(row.count),
currentPage:req.query.pageNum,
router:'article'
}
});
});
獲取文件名時,作者最初用截取字符串的方式實現,但不同操作系統的分隔符不同(Mac 用 '/',Windows 用 '\\'),部署後才發現問題。後來改用 path.basename(files.icon.path) 一行搞定,例如 /a/b/aa.txt 直接得到 aa.txt。這也讓他對 Node.js 的好感再添一分。
對於經常查詢但很少變化的數據(如文章分類統計),可以借助 redis 緩存,命中緩存就直接返回,未命中再查數據庫並寫回緩存:
getCountAll:function(objFun){
redis.get('articles_getCountAll', function(err,reply){
if(err){ console.log(err); return; }
if(reply === null){
db.all('SELECT count(articles.CategoryId) as count,categories.name,categories.id FROM articles left join categories on articles.categoryID = categories.id group by articles.CategoryId ', function(err,row){
redis.set('articles_getCountAll',JSON.stringify(row));
objFun(row);
});
}else{
objFun(reply);
}
});
}
這個方法定義在 model 層。由於項目採用 express,作者盡量以 MVC 方式組織代碼,其中 route 實際承擔了 controller 層的功能。