restify Server API

Server API
原文：http://mcavage.me/node-restify/#server-api
最准系统响应服务器：

var restify = require('restify');function respond(req, res, next) {  res.send('hello ' + req.params.name);  next();}var server = restify.createServer();server.get('/hello/:name', respond);server.head('/hello/:name', respond);server.listen(8080, function() {  console.log('%s listening at %s', server.name, server.url);});

试着打用下面的 curl 命令来感受RESTify将会把它转换成什么：

$ curl -is http://localhost:8080/hello/mark -H 'accept: text/plain'HTTP/1.1 200 OKContent-Type: text/plainContent-Length: 10Date: Mon, 31 Dec 2012 01:32:44 GMTConnection: keep-alivehello mark$ curl -is http://localhost:8080/hello/markHTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 12Date: Mon, 31 Dec 2012 01:33:33 GMTConnection: keep-alive"hello mark"$ curl -is http://localhost:8080/hello/mark -X HEAD -H 'connection: close'HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 12Date: Mon, 31 Dec 2012 01:42:07 GMTConnection: close

请注意，在默认情况下，curl 使用 Connection：keep-alive。为了使头部的方法立即返回，你就需要通过 Connection：close。

由于curl 通常与REST API一起使用，RESTify提供一个插件来解决围绕这个特质的 curl。该插件检查是否用户代理是curl。如果是，它设置连接头为“close”，并删除“的Content-Length”头。

server.pre(restify.pre.userAgentConnection());

看 pre 方法，以获取更多信息。

创建一个服务
创建服务器很简单，你只需调用createServer API，它带有一个对象选项，下面列出的选项（并且 listen() 采用相同的参数作为node 的 http.Server.listen）：

var restify = require('restify');var server = restify.createServer({  certificate: ...,  key: ...,  name: 'MyApp',});server.listen(8080);

选项 类型 描述 certificate String 如果你想创建一个HTTPS服务器，通过PEM编码的证书和密钥 key Stirng 如果你想创建一个HTTPS服务器，通过PEM编码的证书和密钥 formatters Object 用户响应格式化程序res.send() log Object 您可以选择通过用 bunyan 实例;不是必需 name String 默认情况下，这将设置服务器响应头，默认为的RESTify spdy Object 被node-spdy接受的任何选项 version String 默认版本为所有的路由设置 handleUpgrades Boolean 顶升级事件来自node HTTP服务器，推送连接：升级请求，通过定期请求处理链;默认为false httpServerOptions Object 通过node-HTTPS服务器接受的任何选项。如果提供了以下的RESTify服务器选项将被忽略：spdy,ca,certificate,key,passphrase,rejectUnauthorized,requestCert和ciphers; 然而所有这些可以在httpsServerOptions被指定。