Berikut ialah artikel pengenalan yang baik tentang Node.js pengenalan nodejs yang hebat , yang akan memberi anda pengenalan yang sangat mudah kepada Node.js dan CouchDB, dan memberi anda contoh untuk melaksanakan perkhidmatan REST untuk Perform CRUD operasi pada penanda halaman, menggunakan CouchDB sebagai pangkalan data.
Artikel ini akan memperkenalkan cara memasang dan mula menggunakan Node.js di bawah Mac OS X. Proses ini akan mengambil masa kira-kira 30 minit Kami juga akan memasang CouchDB dan melaksanakan API REST berdasarkan CouchDB.
Artikel ini menganggap bahawa Git sudah dipasang pada mesin anda Jika tidak, sila rujuk artikel ini untuk memasangnya.
Pasang node.js dan npm
Cara paling mudah ialah pergi ke tapak web rasmi node.js melalui halaman bahagian muat turun nodejs dan pilih pemasang di bawah Mac, yang akan memasang Node.js dan npm (pengurus pakej nod
Selepas pemasangan berjaya, anda boleh menggunakan arahan nod dan npm.
Pasang CouchDB
Oleh kerana artikel ini memerlukan CouchDB untuk menyimpan objek, CouchDB juga perlu dipasang.Memasang CouchDB sedikit lebih menyusahkan, kerana kita perlu memuat turun kod sumber dan kemudian menyusunnya Sebelum itu, kita perlu memasang Homebrew Sila laksanakan arahan berikut:
git clone https://github.com/mxcl/homebrew.git cd homebrew/bin brew install autoconf automake libtool brew install couchdb
Nota penting: CouchDB sebelum ini melaporkan masalah yang mungkin menghalang anda daripada memasangnya Untuk menyelesaikan masalah ini, anda perlu mengedit fail ~/couch/homebrew/Library/Formula/couchdb.rb secara manual:
Sila ambil perhatian bahawa sumber dalam url perlu dipadamkan Hasil pengubahsuaian akhir adalah seperti berikut:
Untuk mendapatkan maklumat lanjut tentang memasang CouchDB pada Mac OS X, sila baca "Memasang CouchDB pada OSX".
Setelah CouchDB disusun, kami boleh melaksanakan ./couchdb secara manual untuk memulakannya Anda boleh membuka alamat http://127.0.0.1:5984/_utils dalam penyemak imbas anda untuk mengesahkan sama ada pemasangan CouchDB berjaya.
Muat Turun Tutorial
Sekarang perisian yang diperlukan telah dipasang, mari teruskan dengan contoh pengenalan Node.js.
Mula-mula kami menggunakan Git untuk mendapatkan kod sumber contoh
git klon https://github.com/indexzero/nodejs-intro.git
Cipta pangkalan data CouchDB
Sebelum memulakan tutorial, kita perlu mencipta pangkalan data CouchDB Mula-mula pastikan CouchDB telah dimulakan, dan kemudian gunakan arahan berikut untuk mencipta pangkalan data:
$ curl -X PUT http://127.0.0.1:5984/pinpoint-dev10
{"ok":true}
Anda boleh melawati http://127.0.0.1:5984/_utils dalam penyemak imbas anda untuk melihat pangkalan data yang baru dibuat.
Terdapat juga panduan hebat untuk CouchDB di sini.
Mulakan tutorial
Contoh nod js dibina dengan cara modular Direktori lib mengandungi banyak modul dan skrip pelayan berada dalam direktori bin.
Sebagai contoh, jika kita ingin memulakan tutorial CouchDB, kita boleh melaksanakan arahan berikut dalam direktori bin:
./server -t 02couchdb -s
Parameter -t membolehkan anda menentukan modul dalam direktori lib untuk dilaksanakan, dan parameter -s digunakan untuk menetapkan pangkalan data pinpoint-dev yang baru kami buat.
sys - gunakan perubahan
Bergantung pada versi Node.js, anda mungkin melihat ralat atau amaran berikut:
Untuk mengelakkan masalah ini, anda perlu menggantikan semua panggilan `require("sys")` dengan `require("util")`
Node v0.6.14 tidak akan membuang mesej ralat, tetapi akan menggesa amaran:
Jalankan tutorial
Apabila anda menjalankan tutorial, beberapa ralat akan digesa:
该教程包含很多依赖,我们需要使用 npm 来下载这些依赖的包。
安装 node 包
Node packages (dependencies) 可通过 npm 命令来安装,例如:
$ npm install optimist npm http GET https://registry.npmjs.org/optimist npm http 200 https://registry.npmjs.org/optimist npm http GET https://registry.npmjs.org/optimist/-/optimist-0.2.8.tgz npm http 200 https://registry.npmjs.org/optimist/-/optimist-0.2.8.tgz npm http GET https://registry.npmjs.org/wordwrap npm http 200 https://registry.npmjs.org/wordwrap npm http GET https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgz npm http 200 https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgz optimist@0.2.8 ../node_modules/optimist └── wordwrap@0.0.2
这些包将被安装到 node_modules 文件夹中:
$ ls -l ../node_modules/ total 0 drwxr-xr-x 10 ddewaele staff 340 Apr 1 18:54 optimist
本文需要安装如下的 node 包:
npm install winston npm install cradle npm install journey npm install optimist
运行教程
进入 bin 目录,通过下面命令来运行教程:
$ ./server -t 02couchdb -s The "sys" module is now called "util". It should have a similar interface. Pinpoint demo server listening for 02couchdb on http://127.0.0.1:8000
然后打开浏览器访问 http://127.0.0.1:8000/bookmarks ,将会看到如下的结果:
这表示服务已经启动并运行,为了在 CouchDB 中添加点测试数据,我们可以使用 http-console 控制台来访问 CouchDB 的 REST 服务。
安装 http-console
有一个非常棒的工具可以帮助你调试服务,该工具名为 http-console ,你可使用 npm 来安装:
sudo npm install -g http-console
然后就可以在命令行中执行该工具,不幸的是当我们执行该命令时报错了:
$ http-console node.js:201 throw e; // process.nextTick error, or 'error' event on first tick ^ Error: require.paths is removed. Use node_modules folders, or the NODE_PATH environment variable instead. at Function. (module.js:378:11) at Object. (/usr/local/lib/node_modules/http-console/bin/http-console:6:8) at Module._compile (module.js:441:26) at Object..js (module.js:459:10) at Module.load (module.js:348:31) at Function._load (module.js:308:12) at Array.0 (module.js:479:10) at EventEmitter._tickCallback (node.js:192:40)
很麻烦,我们还需要手工编辑 /usr/local/lib/node_modules/http-console/bin/http-console 文件,然后删除下面这一行:
现在 http-console 就可以启动了,无需任何参数,它将连接到 http://localhost:8080 ,如果你需要指定服务器和端口,把它作为第一个参数传递给 http-console 即可。
请注意我们这里使用了 \json 命令用来设置正确的 content-type:
$ http-console http://127.0.0.1:8000 The "sys" module is now called "util". It should have a similar interface. > http-console 0.6.1 > Welcome, enter .help if you're lost. > Connecting to 127.0.0.1 on port 8000. http://127.0.0.1:8000/> \json http://127.0.0.1:8000/>
在 http-console 中,要执行 GET 请求只需要输入 GET /bookmarks 即可:
http://127.0.0.1:8000/> GET /bookmarks HTTP/1.1 200 OK Date: Sun, 01 Apr 2012 17:23:27 GMT Server: journey/0.4.0 Content-Type: application/json;charset=utf-8 Content-Length: 16 Connection: keep-alive { bookmarks: [] }
你也可以使用 JSON 的片段来执行 POST 请求:
http://127.0.0.1:8000/> POST /bookmarks ... { "url": "http://nodejs.org" } HTTP/1.1 200 OK Date: Thu, 05 Apr 2012 11:45:55 GMT Server: journey/0.4.0 Content-Type: application/json;charset=utf-8 Content-Length: 91 Connection: keep-alive { bookmark: { _id: 'WD-G-1', resource: 'Bookmark', url: 'http://nodejs.org' } }
然后再次执行 GET 请求,你就可以看到新插入的数据了:
http://127.0.0.1:8000/> GET /bookmarks HTTP/1.1 200 OK Date: Sun, 01 Apr 2012 17:23:27 GMT Server: journey/0.4.0 Content-Type: application/json;charset=utf-8 Content-Length: 16 Connection: keep-alive { bookmarks: [ { _rev: '1-cfced13a45a068e95daa04beff562360', _id: 'WD-G-1', resource: 'Bookmark', url: 'http://nodejs.org' } ] }