Node.js－學(xué)習(xí)使用外部模塊

學(xué)習(xí)使用外部模塊

目標(biāo)

建立一個 lesson2 項目，在其中編寫代碼。

當(dāng)在瀏覽器中訪問 http://localhost:3000/?q=alsotang 時，輸出 alsotang 的 md5 值，即 bdd5e57b5c0040f9dc23d430846e68a3。

挑戰(zhàn)

訪問 http://localhost:3000/?q=alsotang 時，輸出 alsotang 的 sha1 值，即 e3c766d71667567e18f77869c65cd62f6a1b9ab9。

知識點

1. 學(xué)習(xí) req.query 的用法
2. 學(xué)習(xí)建立 package.json 來管理 Node.js 項目。

課程內(nèi)容

臥槽，不寫 package.json 就寫項目我覺得好不爽啊，所以這個 lesson2 我就得跟大家介紹一下 package.json 這個文件的用法了。

簡單說來呢，這個 package.json 文件就是定義了項目的各種元信息，包括項目的名稱，git repo 的地址，作者等等。最重要的是，其中定義了我們項目的依賴，這樣這個項目在部署時，我們就不必將 node_modules 目錄也上傳到服務(wù)器，服務(wù)器在拿到我們的項目時，只需要執(zhí)行 npm install，則 npm 會自動讀取 package.json 中的依賴并安裝在項目的 node_modules 下面，然后程序就可以在服務(wù)器上跑起來了。

本課程的每個 lesson 里面的示例代碼都會帶上一份 package.json，大家可以去看看它的大概樣子。

我們來新建一個 lesson2 項目，并生成一份它的 package.json。

$ mkdir lesson2 && cd lesson2
$ npm init

OK，這時會要求我們輸入一些信息，亂填就好了，反正這個地方也不用填依賴關(guān)系。

npm init 這個命令的作用就是幫我們互動式地生成一份最簡單的 package.json 文件，init 是 initialize 的意思，初始化。

當(dāng)亂填信息完畢之后，我們的目錄下就會有個 package.json 文件了。

這時我們來安裝依賴，這次的應(yīng)用，我們依賴 express 和 utility 兩個模塊。

$ npm install express utility --save

這次的安裝命令與上節(jié)課的命令有兩點不同，一是沒有指定 registry，沒有指定的情況下，默認(rèn)從 npm 官方安裝，上次我們是從淘寶的源安裝的。二是多了個 --save 參數(shù)，這個參數(shù)的作用，就是會在你安裝依賴的同時，自動把這些依賴寫入 package.json。命令執(zhí)行完成之后，查看 package.json，會發(fā)現(xiàn)多了一個 dependencies 字段，如下圖：

這時查看 node_modules 目錄，會發(fā)現(xiàn)有兩個文件夾，分別是 express 和 utility

我們開始寫應(yīng)用層的代碼，建立一個 app.js 文件，復(fù)制以下代碼進去：

// 引入依賴
var express = require('express');
var utility = require('utility');

// 建立 express 實例
var app = express();

app.get('/', function (req, res) {
  // 從 req.query 中取出我們的 q 參數(shù)。
  // 如果是 post 傳來的 body 數(shù)據(jù)，則是在 req.body 里面，不過 express 默認(rèn)不處理 body 中的信息，需要引入 https://github.com/expressjs/body-parser 這個中間件才會處理，這個后面會講到。
  // 如果分不清什么是 query，什么是 body 的話，那就需要補一下 http 的知識了
  var q = req.query.q;

  // 調(diào)用 utility.md5 方法，得到 md5 之后的值
  // 之所以使用 utility 這個庫來生成 md5 值，其實只是習(xí)慣問題。每個人都有自己習(xí)慣的技術(shù)堆棧，
  // 我剛?cè)肼毎⒗锏臅r候跟著蘇千和樸靈混，所以也混到了不少他們的技術(shù)堆棧，僅此而已。
  // utility 的 github 地址：https://github.com/node-modules/utility
  // 里面定義了很多常用且比較雜的輔助方法，可以去看看
  var md5Value = utility.md5(q);

  res.send(md5Value);
});

app.listen(3000, function (req, res) {
  console.log('app is running at port 3000');
});

OK，運行我們的程序

$ node app.js

訪問 http://localhost:3000/?q=alsotang，完成。

題外話

如果直接訪問 http://localhost:3000/ 會拋錯

可以看到，這個錯誤是從 crypto.js 中拋出的。

這是因為，當(dāng)我們不傳入 q 參數(shù)時，req.query.q 取到的值是 undefined，utility.md5 直接使用了這個空值，導(dǎo)致下層的 crypto 拋錯。