这里有一篇很好的 Node.js 介绍文章 great nodejs intro ,它将给你一个非常方便的介绍 Node.js 和 CouchDB,并给出一个实例实现 REST 的服务用于执行书签的 CRUD 操作,使用 CouchDB 作为数据库。
本文将介绍在 Mac OS X 下安装并开始使用 Node.js ,这个过程大概需要 30 分钟左右的时间,其中我们还将安装 CouchDB,并实现基于 CouchDB 的 REST API。
本文假设你机器上已经装有Git,如果还没有,请参考此文进行安装。
安装 node.js 和 npm
最简单的方法是在 node.js 的官网上通过 页面并选择 Mac 下的安装程序,它将在你的机器上安装 Node.js 和 npm (node package manager).
安装成功后你就可以使用 node 和 npm 命令了。
安装 CouchDB
因为本文需要使用 CouchDB 来存储对象,因此还需要安装 CouchDB.
安装 CouchDB 稍微麻烦一些,因为我们需要下载源码然后编译I,在此之前需要先安装 Homebrew ,请执行以下命令:
git clone https://github.com/mxcl/homebrew.git cd homebrew/bin brew install autoconf automake libtool brew install couchdb
重要的提示:CouchDB 之前报出一个问题可能会阻止你安装,要修复这个问题需要手工编辑 ~/couch/homebrew/Library/Formula/couchdb.rb 文件,编辑内容如下:
复制代码 代码如下:
require 'formula'
class Couchdb < Formula
url 'http://www.apache.org/dyn/closer.cgi?path=couchdb/source/1.1.1/apache-couchdb-1.1.1.tar.gz'
homepage "http://couchdb.apache.org/"
md5 'cd126219b9cb69a4c521abd6960807a6'
请注意需要将 url 中的 source 删除,最终修改结果如下:
复制代码 代码如下:
require 'formula'
class Couchdb < Formula
url 'http://www.apache.org/dyn/closer.cgi?path=couchdb/1.1.1/apache-couchdb-1.1.1.tar.gz'
homepage "http://couchdb.apache.org/"
md5 'cd126219b9cb69a4c521abd6960807a6'
如果安装过程被挂起了,你需要 CTRL-C 终止并执行下面命令重试:
复制代码 代码如下:
./brew install -v couchdb
更多关于 Mac OS X 上安装 CouchDB 的信息请阅读 "Installing CouchDB on OSX".
一旦 CouchDB 编译完成,我们可以手工执行 ./couchdb 来启动它,你可以在浏览器中打开 :5984/_utils 这个地址以验证 CouchDB 安装是否成功。
下载教程
现在所需的软件都已经安装完成,我们接下来继续 Node.js 的介绍实例。
首先我们使用 Git 来获取实例源码
git clone https://github.com/indexzero/nodejs-intro.git
创建 CouchDB 数据库
在开始教程之前我们需要创建一个 CouchDB 数据库,先确保 CouchDB 已经启动,然后使用如下命令创建数据库:
$ curl -X PUT :5984/pinpoint-dev10
{"ok":true}
你可以在浏览器中访问 :5984/_utils 就可以看到新创建的数据库。
这里还有一个非常棒的 CouchDB 的指南。
开始教程
node js 实例使用模块化的方式构建,lib 目录包含很多模块,而服务器脚本在 bin 目录下。
例如,我们要启动 CouchDB 教程,可以在 bin 目录下执行下面命令:
./server -t 02couchdb -s
其中 -t 参数允许你指定要执行的 lib 目录下的模块,-s 参数用以设置我们刚建立的 pinpoint-dev 数据库。
sys - util 变化
根据 Node.js 的版本不同,你可能会看到如下的错误或者是警告:
复制代码 代码如下:
$ node -v
v0.7.7-pre
$ ./server -t 02couchdb -s
node.js:247
throw e; // process.nextTick error, or 'error' event on first tick
^
Error: The "sys" module is now called "util".
at sys.js:1:69
at NativeModule.compile (node.js:572:5)
at Function.require (node.js:540:18)
at Function._load (module.js:297:25)
at Module.require (module.js:357:17)
at require (module.js:373:17)
at Object. (/home/ubuntu/nodejs-intro/bin/server:3:11)
at Module._compile (module.js:444:26)
at Object..js (module.js:462:10)
at Module.load (module.js:351:32)
为了避免这个问题,你需要将所有调用 `require("sys")` 替换成 `require("util")`
Node v0.6.14 不会抛出错误信息,但会提示警告:
复制代码 代码如下: