DIV CSS 佈局教程網

 DIV+CSS佈局教程網 >> 網頁腳本 >> JavaScript入門知識 >> 關於JavaScript >> 零基礎搭建Node.js、Express、Ejs、Mongodb服務器及應用開發入門
零基礎搭建Node.js、Express、Ejs、Mongodb服務器及應用開發入門
編輯:關於JavaScript     

本文改自非魚的《【翻譯】前端開發人員入門指南,從零開始搭建Node.js, Express, Jade, Mongodb服務器》,之所以把Jade換成Ejs,是因為我覺得ejs更符合WEB編程人員的習慣,更確切說應該是更符合PHP、ASP程序員的使用習慣。好了,廢話不多說,直接開始教程。

第1部分 – 15分鐘安裝

如果你真的是從零開始學,那就花點時間先把環境搭建起來吧。這不難,我用的是Win8,所以這看上去跟那些用Mac和Ubuntu或者其它*nix系統的教程有點區別,不過大致是一樣的。

第1步 – 安裝Node.JS

這很容易,進入Node.js官方網站,點擊綠色的大Install按鈕,它會自動檢測你的系統並給你一個正確的安裝文件的下載。(如果沒有,點擊Download按鈕選擇你需要的下載)。運行安裝程序,這樣就好了。你已經裝上了Node.js,和NPM(Node包管理器)可以讓你很容易的安裝各種有用的包到Node裡。

第2步 – 安裝Express

現在我們已經讓Node跑起來了,我們還需要一些東西讓我們能夠實際創建一個可用的站點。下面我們需要安裝Express,這是一個把Node從一個原始的應用變成一個更像我們平時使用的Web服務器的框架。我們需要從Express開始,因為我們需要它提供的scaffolding功能。我們輸入這麼個命令:
代碼如下:
c:\node>npm install -g express

這樣Express就被正確的安裝到我們的Node裡了,並且已經設為全局可用的。你會在命令行窗口看到一堆輸出,大部分是http 304和GET請求,這是正常的。Express應該已經裝好並可用了。

第3步 – 創建一個Express項目

我們准備使用Express和Ejs,但是不是用來做CSS預處理的。我們會手寫一些CSS。我們要用Ejs或者其它的模板引擎來處理Node和Express的數據。如果你會HTML的話,Ejs並不難。只要記住你需要集中精神,否則事情可能很容易出錯。

現在在同一個命令行窗口中輸入:
代碼如下:
c:\node>express –sessions nodetest1

回車,你會看到這樣一堆東西:
代碼如下:
C:\node>express --sessions nodetest1
create : nodetest1
create : nodetest1/package.json
create : nodetest1/app.js
create : nodetest1/routes
create : nodetest1/routes/index.js
create : nodetest1/routes/user.js
create : nodetest1/views
create : nodetest1/views/index.ejs
create : nodetest1/public/images
create : nodetest1/public/javascripts
create : nodetest1/public
create : nodetest1/public/stylesheets
create : nodetest1/public/stylesheets/style.css

install dependencies:
$ cd nodetest1 && npm install

run the app:
$ node app

第4步 – 編輯依賴項

好了,我們現在有一些基本項目結構,但是還沒完。你會注意到express的安裝過程在你的nodetest1目錄裡創建了一個叫package.json的文件,用文本編輯器打開這個文件,它應該是長這樣的。
代碼如下:
{
    "name": "application-name",
    "version": "0.0.1",
    "private": true,
    "scripts": {
        "start": "node app.js"
    },
    "dependencies": {
        "express": "3.4.8",
        "ejs": "*"
    }
}

這是一個標准的JSON格式文件,表明了我們的應用和它的依賴。我們需要添加一點東西。比如對mongodb和Monk的調用。把dependencies部分改成這樣:
代碼如下:
"dependencies": {
    "express": "3.4.8",
    "ejs": "*",
    "mongodb": "*",
    "monk": "*"
}

第5步 – 安裝依賴

現在我們定義好了項目的依賴項。*號會告訴NPM“安裝最新版本”。回到命令行窗口,進入nodetest1目錄,輸入:
代碼如下:
C:\node\nodetest1>npm install

它會輸出一堆東西。這是因為它直接讀取我們修改過的JSON文件,識別其中的依賴項,並安裝必須的文件。當NPM安裝完成以後,你應該有了一個node_modules目錄,其中包含我們的項目所需要的所有依賴文件。

現在我們有了一個完整功能的App,並且可以運行了。我們試試看吧!確保你的當前目錄是nodetest1目錄,輸入:
代碼如下:
C:\node\nodetest1>node app.js

回車後你會看到:
代碼如下:
Express server listening on port 3000

太棒了。打開浏覽器,輸入http://localhost:3000,你應該能看到Express的一個歡迎頁面了。

現在你已經運行起了你自己的Node JS WebServer,帶有Express引擎和Ejs HTML模板引擎。不是很難啊,對吧?

第2部分 – 好了,我們來寫“Hello, World!”吧

打開你常用的文本編輯器或者其它IDE,我個人喜歡用Sublime Text。打開你的nodetest1目錄下的app.js,這個文件就是你的App的核心了。你應該會看到這樣的內容:
代碼如下:
var express = require('express');
var routes = require('./routes');
var user = require('./routes/user');
var http = require('http');
var path = require('path');

這個只是定義了一堆JavaScript變量並指向了一些包和依賴,node函數,和routes。Routes(路由)相當於MVC中Models和Controllers的集合,它負責轉發請求並且也包含一些處理邏輯。Express已經為我們創建好了所有這些東西,我們現在先忽略user route,開始寫最頂層的route(由routes\index.js控制)。

在上面的這個文件的最後寫上:
代碼如下:
var app = express();

這一句至關重要。它實例化了Express並賦值給我們的app變量。接下來的內容都要使用這個變量來配置一堆Express的參數。繼續輸入:
代碼如下:
// all environments
app.set('port', process.env.PORT || 3000);
app.set('views', path.join(__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')));

這裡設置了端口,尋找views的目錄,用什麼模板引擎來處理這些views,和一些其它的東西。還要注意最後一行,它告訴Express把public/目錄下的靜態文件作為頂層目錄的文件來托管。比如你的圖片目錄存放在c:\node\nodetest1\public\images\裡,但是實際訪問地址是http://localhost:3000/images/。

注意:你需要把這一行
代碼如下:
app.use(express.bodyParser());

改成
代碼如下:
app.use(express.urlencoded());

這是為了忽略一些App運行過程中Node窗口裡面的警告信息。主要是一些Express和它的插件未來可能的修改。如果你不做這個修改,程序運行時你會收到一堆某某函數即將過期的警告。

然後增加:
代碼如下:
// development only
if ('development' == app.get('env')) {
  app.use(express.errorHandler());
}

這樣在開發過程中你可以做一些錯誤檢查。

繼續增加:
代碼如下:
app.get('/', routes.index);
app.get('/users', user.list);

這會告訴路由當一個URI請求到達時使用哪個Route來處理。注意user變量是在前面定義的,並被map到了/routes/user.js,我們會調用這個文件中定義的list函數。這裡可以顯示用戶列表。

繼續增加:
代碼如下:
http.createServer(app).listen(app.get('port'), function(){
  console.log('Express server listening on port ' + app.get('port'));
});

最後,創建一個http server並且啟動它。這樣就差不多了。

(以上內容在新的express生成的模板裡是完整的,不需要自己寫進去)

現在,我們寫點有用的。我們不會直接在我們的index頁面裡寫“Hello World!”,我們借這個機會學習一下如何使用route路由,同時學習一下Ejs引擎是如何工作的。在上面的app.js文件的app.get()這一段的後面添加一行:

app.get('/helloworld', routes.helloworld);
如果這時候你在命令行窗口按ctrl+C結束app.js進程再重啟,然後用浏覽器訪問http://localhost:3000/helloworld,你會得到一個很激動人心的node錯誤和命令行窗口中的一堆崩潰提示。這是因為我們還沒有修改路由去處理這個路徑。來做這個吧。在你的編輯器裡,進入routes目錄,找到index.js,打開它。它看上去應該是這樣的:
代碼如下:
/*
 * GET home page.
 */

exports.index = function(req, res){
  res.render('index', { title: 'Express' });
};

我們來添加一個新頁面。我比較喜歡給每一個一級目錄創建一個獨立的route文件,但是現在我們還不打算在views下面給helloworld建一個完整的目錄結構,所以我們暫時先使用index路由。在這個文件的最後添加:
代碼如下:
exports.helloworld = function(req, res){
  res.render('helloworld', { title: 'Hello, World!' });
};

它會負責處理這個URI請求,但是現在我們還沒有一個實際的頁面讓res.render去render,這是Ejs負責的工作。進入你的views目錄,打開index.ejs,把它另存為helloworld.ejs文件。現在它看上去應該是這樣的:
代碼如下:
<!DOCTYPE html>
<html>
<head>
<title><%= title %></title>
<link rel='stylesheet' href='/stylesheets/style.css' />
</head>
<body>
<h1><%= title %></h1>
<p>Welcome to <%= title %></p>
</body>
</html>

應該很容易理解。
保存文件。在命令行窗口中按ctrl+c中斷app.js,然後輸入node app.js重新啟動它。提示:當你修改一個ejs模板文件的時候,你不需要重啟服務器。但是當你改了一個js文件的時候,比如app.js或者一個路由js文件,就必須要重啟服務器才能看到效果了。

服務器啟動後,注服務器打開http://localhost:3000/helloworld,應該能看到這個漂亮的界面了:

好了!現在我們有了路由可以處理我們的模板,看到了我們想要的效果。接下來我們來做一些Model(數據層)。

第3部分 – 創建數據庫並讀取數據

第1步 – 安裝Mongodb

我們先關掉文本編輯器,回到命令行窗口。先用浏覽器,打開http://mongodb.org/,下載Mongo。點擊主菜單裡的下載鏈接,找到適合你的系統的版本。對於64位win8,下載64-bit *2008R2+版本。下載後是個zip文件,解壓到c:\mongo或者c:\program files\mongo或者隨便什麼地方,這不重要。我們把數據保存在我們的nodetest1目錄裡。

第2步 – 運行Mongod和mongo

在我們的nodetest1目錄裡創建一個子目錄data,然後在命令行窗口中進入你的mongodb目錄的bin目錄裡,輸入:
代碼如下:
mongod –dbpath c:\node\nodetest1\data

你會看到mongo服務器啟動了,第一次啟動需要一點時間,因為它需要預分配一些硬盤空間和一些其它的任務。當它提示”[initandlisten] waiting for connections on port 27017″的時候,就搞定了。沒有什麼別的需要做的了,服務器已經在運行了。現在你需要另外打開一個命令行窗口,進入mongo目錄的bin目錄中,輸入
代碼如下:
mongo

你會看到一些類似這種提示:
代碼如下:
c:\mongo>mongo
MongoDB shell version: 2.4.5
connecting to: test

這時候如果你看一下mongod的窗口,你會看到提示一個連接已接入。我們接下來會使用這個命令行的客戶端去手工處理一下我們的數據庫,不過這對我們的Web站點並不是必須的。

第3步 – 創建一個數據庫

不用擔心上面的連接到test的提示。那只是當你沒有指定數據庫時mongo默認的一個數據庫,它甚至不會創建這個名叫test的數據庫,除非你增加一條記錄進去。我們創建一個自己的數據庫吧。在mongo的命令行窗口中,輸入:
代碼如下:
use nodetest1

除非我們插入一些數據進去,否則它也不會創建這個數據庫。

第4步 – 添加一些數據

我最喜歡的MongoDB的特性就是它使用JSON作為數據結構,這就意味著我對此非常的熟悉。如果你不熟悉JSON,先去讀點相關資料吧,這超出了本教程的范圍。

我們添加一些數據到collection中。在這個教程裡,我們只有一個簡單的數據庫,留侯 username和email兩個字段。我們的數據看起來是這個樣子的:
代碼如下:
{
    "_id" : 1234,
    "username" : "cwbuecheler",
    "email" : "cwbuecheler@nospam.com"
}

你可以創建你自己的_id字段的值,不過我覺得最好還是讓mongo來做這件事。它會為每一條記錄創建一個唯一的值。我們看看它是怎麼工作的。在mongo的窗口中,輸入:
代碼如下:
db.usercollection.insert({ “username” : “testuser1″, “email” : “testuser1@testdomain.com” })

重要提示:db就是我們上面創建的nodetest1數據庫,usercollection就是我們的collection,相當於一張數據表。注意我們不需要提前創建這個collection,它會在第一次使用的時候自動創建。好了,按下回車。如果一切順利,你會看到……什麼也沒有。這可不太好,輸入:
代碼如下:
db.usercollection.find().pretty()

如果你好奇的話,pretty方法會格式化輸出內容,添加換行縮進。它應該會顯示:
代碼如下:
{
    "_id" : ObjectId("5202b481d2184d390cbf6eca"),
    "username" : "testuser1",
    "email" : "testuser1@testdomain.com"
}

當然,你得到ObjectID應該是不一樣的,mongo會自動生成一個。如果你以前使用過JSON接口的服務,現在是不是會覺得,哇,在web裡調用這個應該很簡單吧!嗯,你說對了。

提示:作為正式服務,你應該不希望所有的數據都存在最頂層。關於mongodb數據結構的設計,多看看Google吧。

現在我們有了一條數據,我們多添加點吧。在mongo窗口中輸入:
代碼如下:
newstuff = [{ "username" : "testuser2", "email" : "testuser2@testdomain.com" }, { "username" : "testuser3", "email" : "testuser3@testdomain.com" }]
db.usercollection.insert(newstuff);

注意,我們通過一個數據一次傳遞了多條數據到collection。多簡單!再使用上面的find命令你會看到這三條數據。

現在我們來整合前面搭建的web服務器和數據庫。

第5步 – 把mongo連接到node

現在我們來建立一個頁面,把數據庫裡的記錄顯示成一個漂亮的表格。這是我們准備生成的HTML內容:
代碼如下:
<ul>
    <li><a href="mailto:testuser1@testdomain.com">testuser1</a></li>
    <li><a href="mailto:testuser2@testdomain.com">testuser2</a></li>
    <li><a href="mailto:testuser3@testdomain.com">testuser3</a></li>
</ul>

我知道這不太科學,不過你理解就好。我們只是為了建立一個簡單的數據庫讀寫程序,不是為了建立一個完整的網站。首先,我們往app.js(我們的程序的心髒和靈魂)裡添加一點內容,這樣才能接連上mongodb。打開c:\node\nodetest1\app.js,在頂部你會看到:
代碼如下:
var express = require('express');
var routes = require('./routes');
var user = require('./routes/user');
var http = require('http');
var path = require('path');

在它下面添加:
代碼如下:
// New Code
var mongo = require('mongodb');
var monk = require('monk');
var db = monk('localhost:27017/nodetest1');

這幾行會告訴app我們需要連接MongoDB,我們用Monk來負責這個連接,我們數據庫位置是localhost:27017/nodetest1。注意27017是mongodb的默認端口,如果因為某些原因你修改了端口,記錄這裡也要跟著改。現在看文件的底部:
代碼如下:
app.get('/', routes.index);
app.get('/users', user.list);
app.get('/helloworld', routes.helloworld);

下面添加一行:
代碼如下:
app.get('/userlist', routes.userlist(db));

這一行告訴app當用戶訪問/userlist路徑的時候,我們需要把db變量傳遞到userlist路由。但是我們現在還沒有userlist路由,現在就去創建一個吧。

第6步 – 讀取mongo中的數據並顯示

用你的編輯器打開c:\node\nodetest1\routes\idnex.js,裡面有index和hello world兩個route,現在我們來添加第三個:
代碼如下:
exports.userlist = function(db) {
    return function(req, res) {
        var collection = db.get('usercollection');
        collection.find({},{},function(e,docs){
            res.render('userlist', {
                "userlist" : docs
            });
        });
    };
};

好吧,事情變得有點復雜了。這裡首先定義了一個function,接收我們傳過來的db變量,然後調用一個跟前面兩個route一樣的page render。我們告訴它需要讀取usercollection,做一個查找,返回的數據保存在docs變量中。一旦我們讀取到了內容,就調用render來渲染userlist模板頁面,把獲取到的docs變量作為模板引擎中的userlist變量傳遞進去。

接下來建立我們的Ejs模板。在views目錄下打開index.ejs,另存為userlist.ejs,然後把它的HTML修改成這樣:
代碼如下:
<!DOCTYPE html>
<html>
<head>
<title>USERLIST</title>
<link rel='stylesheet' href='/stylesheets/style.css' />
</head>
<body>
<h1>Userlist</h1>
<ul>
<%
for(var i in userlist){
%>
<li><a href=”mailto:<%=userlist[i].email%>”><%=userlist[i].username%></a></li>
<% } %>
</ul>
</body>
</html>

保存文件,重啟node服務器。希望你還記得怎麼重啟。打開浏覽器,訪問http://localhost:3000/userlist,你應該能看到這樣的界面:

點提交按鈕,你會看到一個“can't post to /adduser”的錯誤。我們來修正它。

第2步 – 創建你的數據庫處理函數

跟以前一樣,我們修改app.js,然後是route文件,然後是ejs模板。不過,這裡不需要ejs模板,因為我們post以後會跳轉。在app.js的app.get()這一段的後面添加一行:
代碼如下:
app.post('/adduser', routes.adduser(db));

注意這裡是app.post,不是app.get了。來設置route吧。回到routes/index.js,創建我們的數據庫插入函數。這個比較大,所以我建議你寫好注釋。
代碼如下:
exports.adduser = function(db) {
    return function(req, res) {

        // Get our form values. These rely on the "name" attributes
        var userName = req.body.username;
        var userEmail = req.body.useremail;

        // Set our collection
        var collection = db.get('usercollection');

        // Submit to the DB
        collection.insert({
            "username" : userName,
            "email" : userEmail
        }, function (err, doc) {
            if (err) {
                // If it failed, return error
                res.send("There was a problem adding the information to the database.");
            }
            else {
                // If it worked, set the header so the address bar doesn't still say /adduser
                res.location("userlist");
                // And forward to success page
                res.redirect("userlist");
            }
        });

    }
}

顯然在真正的項目裡你還需要做很多驗證,比如用戶名和email不允許重復,email地址必須符合一定的格式規則。不過現在我們先不管這些。你可以看到,當插入數據庫完成時,我們讓用戶跳轉回userlist頁面,他們應該在那裡看到新插入的數據。

這是最好的方式嗎?

第3步 – 連接數據庫,寫入數據

確保你的mongod在運行!然後重啟你的node服務器。用浏覽器打開http://localhost:3000/newuser。現在我們填入一些內容,點擊提交按鈕。如果順利,我們應該回到了userlist頁面,並且看到了剛剛添加的新數據。

現在我們正式的完成了使用Node.js,Exress,Ejs讀取和寫入Mongodb數據庫,我們已經是牛X的程序員了。

恭喜你,真的。如果你認真的看完了這篇教程,並且很認真的學習而不只是,你應該對routes, views,讀數據,寫入數據有了完整的概念。這是你用來開發任何其它完整的Web網站所需要的一切知識點!不管你怎麼想,我覺得這真挺酷的。

第5部分 – 下一步

現在開始,你擁有無限的可能。你可以看看Mongoose, 另一個處理MongoDB數據庫的Node包。它比Monk更大一些,功能也更豐富。你還可以看看Stylus,一個Express的CSS引擎。你可以Google一下Node Express Mongo Tutorial,看看接下來的內容。好好學習,天天向上。

我希望這篇教程能夠有所幫助,我寫這個是因為當我開始學習的時候我真的很需要這樣的東西,但是又真的找不到。如果你已經看到了這裡,非常感謝!

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved