Restify实践

在项目里面，我网站用的是2层结构：UI + WebService(REST API)，这样的好处是UI和后端可以完全分离。UI我用的是expressJs，后端Service层用的也是expressJs。今天看到一个轻量级的、专为REST API定制的框架，restify(详细文档：http://mcavage.github.io/node-restify)。restify应该是基于connect的，和expressJs用法也差不多，只不过，有少许区别，好处是，他支持server、client两种！server可以是一个http server、json server、string server（区别是返回的body类型是application/plain, application/json, ...）。而且他还支持带version支持的RESTFUL API（使用header: accept-version: ~1控制）。下面就是使用代码：

var restify = require('restify')  , routes = require('./routes');var server = restify.createServer({    name: 'CER Web Service',    versions: ['1.0.0']});server.use(restify.pre.userAgentConnection());          // work around for curlserver.use(restify.acceptParser(server.acceptable));server.use(restify.queryParser());server.use(restify.bodyParser());// static files: /, /index.html, /images...server.get(/^\/((.*)(\.)(.+))*$/, restify.serveStatic({ directory: 'public', default: "index.html" }));// testing the serviceserver.get('/test', function (req, res, next) {    res.send("testing...");    next();});server.get('/products', routes.product_list);server.get('/sendEmail', routes.sendEmail);server.get('/:productId/top_crash/week/:weekId', routes.top_crash);server.get('/:productId/weekly_crash/week/:weekId', routes.weekly_crash);server.get('/:productId/weekly_crash_per_user/week/:weekId', routes.weekly_crash_per_user);server.get('/:productId/related_products', routes.related_product_list);server.get('/:productId/weeks', routes.week_list);server.get('/:productId/fix_rate/week/:weekId', routes.fix_rate);server.get('/:productId/os_breakdown/week/:weekId', routes.os_breakdown);server.get('/:productId/bucket/week/:weekId', routes.bucket);server.listen(8080, function () {    console.log('%s listening at %s', server.name, server.url);});

第一步是创建server对象，你可以传入你所支持的版本数组，versions！（不用使用version属性，因为有bug，在调用server.toString()的时候，会crash）。接着就是一些中间件：

1. pre.userAgentConnection()：这个是为处理keep-alive的curl命令的。

2. acceptParser()：返回支持信息，比如json, plain等。

接下来就是路由功能了：

1. serveStatic：这个需要讲一下，和expressJs不同，对于静态文件的获取，expressJs是调用use()，并传入一个static()中间件的，但是restify要求，一定要映射到一个路径上去，所以只能使用get。

2. 最后一个参数next()不能省略。

3. 之后的一些get，都和expressJs一模一样了，完全相同。

从expressJs移植到restify很方便，对于我来说，只是修改了app.js，然后删除了一些无用的目录即可。

接下来看看client端，以前我是使用http.get()来访问页面的，现在可以使用restify提供的client类：

var http = require('http')  , util = require('util')  , assert = require('assert')  , restify = require('restify');var jsonClient = restify.createJsonClient({    url: "http://localhost:8080",    version: "1.0.0"});module.exports = {    host: "http://localhost:8080",    products: "/products",    relatedProducts: "/{productId}/related_products",    weeks: "/{productId}/weeks",    weeklyCrashCount: "/{productId}/weekly_crash/week/{weekId}",    weeklyCrashCountPerUser: "/{productId}/weekly_crash_per_user/week/{weekId}",    topCrashCommands: "/{productId}/top_crash/week/0",    fixRate: "/{productId}/fix_rate/week/{weekId}",    osBreakdown: "/{productId}/os_breakdown/week/{weekId}",    bucket: "/{productId}/bucket/week/{weekId}",    getRequestUrl: function (url, keyValues) {        for (var key in keyValues) { url = url.replace("{" + key + "}", keyValues[key]); }        return url;    },    getCall: function (url, callback) {        jsonClient.get(url, function (err, req, res, obj) {            if (err) {                console.log(err);                callback(err, res.statusCode);            }            else {                callback(undefined, obj);            }        });    }};

我先是创建了一个jsonClient，然后告诉他，版本是1.0.0，当然也可以传入*表示所有版本通吃。在getCall()里面，我调用jsonClient.get()，其callback的最后一个参数会传给我一个对象，哈哈，这个就是json对象！方便吧！

其实，你看看restify的实现，也超简单的，就是从服务器端拿到数据，然后用JSON.parse()将他转换成js的对象而已。