Restify —— 在Node.js中构建正确的REST Web服务

今天决定学一个叫做restify的Node.js模块。restify模块使得在Node.js中写正确的REST API变得容易了很多，而且它还提供了即装即用的支持，如版本控制、错误处理、CORS和内容协商。它大量地借鉴了Express（故意地），因为这或多或少是事实上的API来写在node.js上写web应用程序，将数据存储在MongoDB中。

Restify准备

Restify需要NodeJS和NPM包管理器，这个可以是随node.js安装时默认的。如果已经安装了node.js和NPM，就可以用NPM系统来安装Harp了。

此应用程序使用MongoDB作数据存储。

Restify安装

在任何方便的目录中的文件系统上创建一个新的目录：

$ mkdir myapp$ cd myapp

输入下面命令，安装restify模块：

$ npm install restify

使用MongoJS作为MongoDB的驱动程序，输入下面命令安装mongojs模块：

$ npm install mongojs

编写基于REST的API

现在已经安装了restify和mongojs创建一个名为app.js的新文件：

$ touch app.js

把下面内容粘贴进app.js：

var restify = require('restify');var mongojs = require("mongojs");

这是加载restify和mongojs模块，并给它们分配变量。

现在，创建一个使用restify API的新服务器：

var restify = require('restify');var mongojs = require("mongojs");var ip_addr = '127.0.0.1';var port    =  '8080';var server = restify.createServer({    name : "myapp"});server.listen(port ,ip_addr, function(){    console.log('%s listening at %s ', server.name , server.url);});

createServer() 函数接受一个选择对象，将myapp作为选择对象的服务器的名称传递给它，也可以在这份文档中查看选项的完整的选项列表。创建服务器实例之后，通过端口、ip地址和一个回调函数调用listen函数。

运行程序：

$ node app.js

然后会看见如下命令行：

myapp listening at http://127.0.0.1:8080

配置插件

restify模块有很多内置的插件，把下面内容复制并粘贴到app.js，应该加在server.listen() 函数前面。请参阅这份文档以了解所有被支持的插件。

server.use(restify.queryParser());server.use(restify.bodyParser());server.use(restify.CORS());

上述代码表示：

1. restify.queryParser() 插件是用来解析HTTP查询字符串（如 /jobs?skills=java,mysql），解析后的内容将会在req.query里可用。
2. restify.bodyParser() 会在服务器上自动将请求数据转换为JavaScript对象。
3. restify.CORS() 配置应用程序中的CORS支持。

MongoDB的配置

在添加路由之前，添加代码来连接到MyApp的MongoDB数据库：

var connection_string = '127.0.0.1:27017/myapp';var db = mongojs(connection_string, ['myapp']);var jobs = db.collection("jobs");

现在，已经连接到本地MongoDB实例。接下来，需要得到使用数据库对象的工作集合。

写CRUD API

现在，服务器和数据库已经准备了。仍然需要路由来定义API的行为，复制并粘贴以下代码到app.js文件中：

var PATH = '/jobs'server.get({path : PATH , version : '0.0.1'} , findAllJobs);server.get({path : PATH +'/:jobId' , version : '0.0.1'} , findJob);server.post({path : PATH , version: '0.0.1'} ,postNewJob);server.del({path : PATH +'/:jobId' , version: '0.0.1'} ,deleteJob);

上述代码执行以下操作：

1. 当用户发出一个GET请求到'/jobs'，findAllJobs回调函数将被调用。
2. 当用户发出一个GET请求到'/ jobs/123'，findJob回调函数将被调用。
3. 当用户发出POST请求'/jobs'，postNewJob回调函数将被调用。
4. 当用户删除请求'/ jobs/123'，deleteJob回调会被调用（此处原文有误）。

现在编写回调函数，复制并粘贴进app.js：

function findAllJobs(req, res , next){    res.setHeader('Access-Control-Allow-Origin','*');    jobs.find().limit(20).sort({postedOn : -1} , function(err , success){        console.log('Response success '+success);        console.log('Response error '+err);        if(success){            res.send(200 , success);            return next();        }else{            return next(err);        }    });}function findJob(req, res , next){    res.setHeader('Access-Control-Allow-Origin','*');    jobs.findOne({_id:mongojs.ObjectId(req.params.jobId)} , function(err , success){        console.log('Response success '+success);        console.log('Response error '+err);        if(success){            res.send(200 , success);            return next();        }        return next(err);    })}function postNewJob(req , res , next){    var job = {};    job.title = req.params.title;    job.description = req.params.description;    job.location = req.params.location;    job.postedOn = new Date();    res.setHeader('Access-Control-Allow-Origin','*');    jobs.save(job , function(err , success){        console.log('Response success '+success);        console.log('Response error '+err);        if(success){            res.send(201 , job);            return next();        }else{            return next(err);        }    });}function deleteJob(req , res , next){    res.setHeader('Access-Control-Allow-Origin','*');    jobs.remove({_id:mongojs.ObjectId(req.params.jobId)} , function(err , success){        console.log('Response success '+success);        console.log('Response error '+err);        if(success){            res.send(204);            return next();              } else{            return next(err);        }    })}

使用curl测试Web服务，输入下面命令创建一个“job”：

$ curl -i -X POST -H "Content-Type: application/json" -d '{"title":"NodeJS Developer Required" , "description":"NodeJS Developer Required" , "location":"Sector 30, Gurgaon, India"}' http://127.0.0.1:8080/jobs

找到所有的“jobs”：

$ curl -is http://127.0.0.1:8080/jobsHTTP/1.1 200 OKAccess-Control-Allow-Origin: *Content-Type: application/jsonContent-Length: 187Date: Sun, 24 Nov 2013 16:17:27 GMTConnection: keep-alive[{"title":"NodeJS Developer Required","description":"NodeJS Developer Required","location":"Sector 30, Gurgaon, India","postedOn":"2013-11-24T16:16:16.688Z","_id":"52922650aab6107320000001"}]

部署到云端

在应用程序部署到OpenShift之前，座以下几个设置：

1. 注册一个OpenShift帐户，它是完全免费的，可以分配给每个用户1.5 GB的内存和3 GB的磁盘空间。
2. 安装RHC客户端工具，需要有ruby 1.8.7或更新的版本，如果已经有ruby gem，输入 sudo gem install rhc ，确保它是最新版本。要更新RHC的话，执行命令 sudo gem update rhc，如需其他协助安装RHC命令行工具，请参阅该页面：https://www.openshift.com/developers/rhc-client-tools-install
3. 通过 rhc setup 命令设置您的OpenShift帐户，此命令将帮助你创建一个命名空间，并上传你的SSH keys到OpenShift服务器。

设置完成后，输入以下命令创建一个新的OpenShift应用程序：

$ rhc create-app day27demo nodejs-0.10 mongodb-2 --from-code https://github.com/shekhargulati/day27-restify-openshift-demo.git

它会完成所有的工作，从创建一个应用程序、建立公共DNS、创建私有的git仓库到最后使用代码从Github资源库部署应用程序。该应用程序可以在这里访问 http:// day27demo-{domain-name}.rhcloud.com//

今天就这些，欢迎反馈。