nodeJs.jpg

看好了
這是一盞《Node.js開(kāi)發(fā)指南》的讀書筆記烁焙。

Hello World

1. 程序文件的Hello World

   編輯一個(gè)helloworld.js文件，內(nèi)容為：

   console.log('Hello World.');
   

   保存到 ~/helloworld.js躏升。
   進(jìn)入控制臺(tái)，輸入：

   $ node helloworld.js
   Hello World.
   

2. 控制臺(tái)命令中的Hello World

   $ node -e "console.log('Hello World.');"
   Hello World.
   

3. REPL中的Hello World

   $ node
   > console.log('Hello World');
   Hello World
   undefined
   

   進(jìn)入REPL后狼忱，可以通過(guò)連續(xù)兩次 Ctrl+c 退出膨疏。

最小的HTTP服務(wù)器

1. 其它大部分語(yǔ)言的HTTP服務(wù)器架構(gòu)大都為“瀏覽器 - HTTP 服務(wù)器 - PHP 解釋器”的組織方式一睁。
2. Node.js將HTTP服務(wù)器這一層抽離,直接面向?yàn)g覽器用戶。

node.js價(jià)構(gòu)

建立一個(gè)app.js文件佃却，輸入以下內(nèi)容：

var http = require('http');
     
http.createServer(function(req, res) {
res.writeHead(200, {'Content-Type': 'text/html'});
res.write('<h1>Node.js</h1>');
res.end('<p>Hello World</p>');
}).listen(3000);

console.log("Http server is listening at port 3000.");

保存到 ~/app.js者吁。執(zhí)行：$ node ~/app.js。即可在瀏覽器中通過(guò)打開(kāi) http://127.0.0.1:3000 進(jìn)行查看饲帅。

異步同步以及事件觸發(fā)

1. 異步的文件讀取

   // readfile.js
   
   var fs = require('fs');
   
   console.log('first...');
   fs.readFile('tmp.txt', 'utf-8', function(err, data) {
       if (err) {
       console.error(err);
       }
       else {
       console.log(data);
       }
   });
   console.log('next...');
   

   以下是輸出：

   $ node readfile.js
   first...
   next...
   你是我的小呀小蘋果
   

   fs.readFile 調(diào)用時(shí)所做的工作只是將異步式 I/O 請(qǐng)求發(fā)送給了操作系統(tǒng),然后立即返回并執(zhí)行后面的語(yǔ)句复凳，執(zhí)行完以后進(jìn)入事件循環(huán)監(jiān)聽(tīng)事件。當(dāng) fs 接收到 I/O 請(qǐng)求完成的 事件時(shí)灶泵，事件循環(huán)會(huì)主動(dòng)調(diào)用回調(diào)函數(shù)以完成后續(xù)工作育八。因此我們會(huì)先看到 next...，再看到 tmp.txt 文件的內(nèi)容赦邻。

2. 同步的文件讀取

   // readfilesync.js
   
   var fs = require('fs');
   
   console.log('first...');
   
   var data = fs.readFileSync('tmp.txt', 'utf-8');
   console.log(data);
   
   console.log('next...');
   

   輸出結(jié)果：

   $ node readfilesync.js
   first...
   你是我的小呀小蘋果
   
   next...
   

3. 事件觸發(fā)

   // event.js
   
   var EventEmitter = require('events').EventEmitter;
   var event = new EventEmitter();
   
   event.on('some_event', function() {
       console.log('some_event occured.');
   });
   
   setTimeout(function() {
       event.emit('some_event');
   }, 1000);
   

   運(yùn)行這段代碼,1秒后控制臺(tái)輸出了 some_event occured.髓棋。其原理是 event 對(duì)象 注冊(cè)了事件 some_event 的一個(gè)監(jiān)聽(tīng)器,然后我們通過(guò) setTimeout 在1000毫秒以后向 event 對(duì)象發(fā)送事件some_event,此時(shí)會(huì)調(diào)用 some_event的監(jiān)聽(tīng)器。

模塊和包

• 模塊(Module)和包(Package)是 Node.js 最重要的支柱深纲。開(kāi)發(fā)一個(gè)具有一定規(guī)模的程序不可能只用一個(gè)文件,通常需要把各個(gè)功能拆分仲锄、封裝,然后組合起來(lái),模塊正是為了實(shí) 現(xiàn)這種方式而誕生的。在瀏覽器 JavaScript 中,腳本模塊的拆分和組合通常使用 HTML 的 script 標(biāo)簽來(lái)實(shí)現(xiàn)湃鹊。Node.js 提供了 require 函數(shù)來(lái)調(diào)用其他模塊,而且模塊都是基于 文件的,機(jī)制十分簡(jiǎn)單儒喊。
• 我們經(jīng)常把 Node.js 的模塊和包相提并論,因?yàn)槟K和包是沒(méi)有本質(zhì)區(qū)別的,兩個(gè)概念 也時(shí)常混用币呵。如果要辨析,那么可以把包理解成是實(shí)現(xiàn)了某個(gè)功能模塊的集合,用于發(fā)布 和維護(hù)怀愧。對(duì)使用者來(lái)說(shuō),模塊和包的區(qū)別是透明的,因此經(jīng)常不作區(qū)分。

模塊

模塊是 Node.js 應(yīng)用程序的基本組成部分,文件和模塊是一一對(duì)應(yīng)的余赢。

1. 創(chuàng)建一個(gè)簡(jiǎn)單的模塊

   //module.js
   
   var name;
   
   exports.setName = function(thyName) {
       name = thyName
   };
   
   exports.sayHello = function() {
       console.log('Hello' + name);
   };
   

   再在同目錄下創(chuàng)建調(diào)用模塊的主文件：

   //getmodule.js
   
   var myModule = require('./module');
   myModule.setName('Arthur');
   myModule.sayHello();
   

   運(yùn)行node getmodule.js便能輸出Hello Arthur芯义。
   *看起來(lái)很像類的調(diào)用有沒(méi)有？但不是的妻柒，這也只是像而已扛拨。在getmodule.js 中，不論執(zhí)行多少次 require('./module'); 獲得的模塊都是同一個(gè)举塔。

2. 類模塊

   //singleobject.js
   
   function Hello() {
       var name;
   
       this.setName = function(thyName) {
       name = thyName;
       };
   
       this.sayHello = function() {
       console.log('Hello ' + name);
       };
   };
   
   // 方式1.
   // exports.Hello = Hello;
   
   // 方式2.
   module.exports = Hello;
   

   在singleobject.js中绑警，如果采用已被注釋掉的方式1來(lái)導(dǎo)出對(duì)象的話，需要采用require('./singleobject').Hello來(lái)獲取對(duì)象央渣，比較冗余计盒。采用方式2來(lái)輸出，就可以采用下面的方式來(lái)直接獲取了：

   //getsingleobject.js
   
   var Hello = require('./singleobject');
   
   hello = new Hello();
   hello.setName('Arthur');
   hello.sayHello();
   

• 注意,模塊接口的唯一變化是使用 module.exports = Hello 代替了 exports.Hello= Hello芽丹。在外部引用該模塊時(shí)北启，其接口對(duì)象就是要輸出的 Hello 對(duì)象本身，而不是原先的 exports。
• 事實(shí)上咕村，exports 本身僅僅是一個(gè)普通的空對(duì)象场钉，即 {}，它專門用來(lái)聲明接口懈涛，本 質(zhì)上是通過(guò)它為模塊閉包1的內(nèi)部建立了一個(gè)有限的訪問(wèn)接口惹悄。因?yàn)樗鼪](méi)有任何特殊的地方，所以可以用其他東西來(lái)代替肩钠，譬如我們上面例子中的 Hello 對(duì)象。
• 不可以通過(guò)對(duì) exports 直接賦值代替對(duì) module.exports 賦值暂殖。 exports 實(shí)際上只是一個(gè)和 module.exports 指向同一個(gè)對(duì)象的變量, 它本身會(huì)在模塊執(zhí)行結(jié)束后釋放,但 module 不會(huì),因此只能通過(guò)指定 module.exports 來(lái)改變?cè)L問(wèn)接口价匠。

包

Node.js 的包是一個(gè)目錄，其中包含一個(gè) JSON 格式的包說(shuō)明文件 package.json呛每。

1. 作為文件夾的模塊
   創(chuàng)建一個(gè)somepackage 的文件夾踩窖，在其中創(chuàng)建 index.js ：

   //somepackage/index.js
   
   exports.hello = function() {
       console.log('Hello.');
   };
   

   在somepackage之外建立getpackage.js：

   //getpackage.js
   
   var somePackage = require('./somepackage');
   
   somePackage.hello();
   

   運(yùn)行node getpackage.js 可得到Hello.

   我們使用這種方法可以把文件夾封裝為一個(gè)模塊，即所謂的包晨横。包通常是一些模塊的集 合洋腮，在模塊的基礎(chǔ)上提供了更高層的抽象，相當(dāng)于提供了一些固定接口的函數(shù)庫(kù)手形。通過(guò)定制 package.json啥供，我們可以創(chuàng)建更復(fù)雜、更完善库糠、更符合規(guī)范的包用于發(fā)布伙狐。

2. package.json

   package.json 是 CommonJS 規(guī)定的用來(lái)描述包的文件，完全符合規(guī)范的 package.json 文 件應(yīng)該含有以下字段瞬欧。

   • name: 包的名稱贷屎，必須是唯一的，由小寫英文字母艘虎、數(shù)字和下劃線組成唉侄，不能包含空格。
   • description: 包的簡(jiǎn)要說(shuō)明野建。
   • version: 符合語(yǔ)義化版本識(shí)別規(guī)范的版本字符串属划。
   • keywords: 關(guān)鍵字?jǐn)?shù)組，通常用于搜索贬墩。
   • maintainers: 維護(hù)者數(shù)組榴嗅，每個(gè)元素要包含 name、email (可選)陶舞、web (可選)字段嗽测。
   • contributors: 貢獻(xiàn)者數(shù)組，格式與maintainers相同。包的作者應(yīng)該是貢獻(xiàn)者數(shù)組的第一個(gè)元素唠粥。
   • bugs: 提交bug的地址疏魏，可以是網(wǎng)址或者電子郵件地址。
   • licenses: 許可證數(shù)組晤愧，每個(gè)元素要包含 type (許可證的名稱)和 url (鏈接到許可證文本的地址)字段大莫。
   • repositories: 倉(cāng)庫(kù)托管地址數(shù)組，每個(gè)元素要包含 type(倉(cāng)庫(kù)的類型官份，如 git )只厘、 url (倉(cāng)庫(kù)的地址)和 path (相對(duì)于倉(cāng)庫(kù)的路徑，可選)字段舅巷。
   • dependencies: 包的依賴,一個(gè)關(guān)聯(lián)數(shù)組羔味，由包名稱和版本號(hào)組成。

一個(gè)合乎Common.JS規(guī)范的package.json文件如下：

{
"name": "mypackage",
"description": "Sample package for CommonJS. This package demonstrates the required
       elements of a CommonJS package.",
    "version": "0.7.0",
    "keywords": [
"package",
"example" ],
    "maintainers": [
       {
          "name": "Bill Smith",
          "email": "bills@example.com",
       }
    ],
    "contributors": [
       {
          "name": "BYVoid",
          "web": "http://www.byvoid.com/"
} ],
    "bugs": {
       "mail": "dev@example.com",
       "web": "http://www.example.com/bugs"
    },
    "licenses": [
       {
          "type": "GPLv2",
          "url": "http://www.example.org/licenses/gpl.html"
} ],
    "repositories": [
       {
          "type": "git",
          "url": "http://github.com/BYVoid/mypackage.git"
       }
    ],
    "dependencies": {
       "webkit": "1.2",
       "ssl": {
          "gnutls": ["1.0", "2.0"],
          "openssl": "0.9.8"
       }
} }