标签：

• HTTP
  • Class: http.Agent
    • new Agent([options])
    • agent.destroy()
    • agent.freeSockets
    • agent.getName(options)
    • agent.maxFreeSockets
    • agent.maxSockets
    • agent.requests
    • agent.sockets
  • Class: http.ClientRequest
    • Event: ‘abort‘
    • Event: ‘connect‘
    • Event: ‘continue‘
    • Event: ‘response‘
    • Event: ‘socket‘
    • Event: ‘upgrade‘
    • request.abort()
    • request.end([data][, encoding][, callback])
    • request.flushHeaders()
    • request.setNoDelay([noDelay])
    • request.setSocketKeepAlive([enable][, initialDelay])
    • request.setTimeout(timeout[, callback])
    • request.write(chunk[, encoding][, callback])
  • Class: http.Server
    • Event: ‘checkContinue‘
    • Event: ‘clientError‘
    • Event: ‘close‘
    • Event: ‘connect‘
    • Event: ‘connection‘
    • Event: ‘request‘
    • Event: ‘upgrade‘
    • server.close([callback])
    • server.listen(handle[, callback])
    • server.listen(path[, callback])
    • server.listen(port[, hostname][, backlog][, callback])
    • server.maxHeadersCount
    • server.setTimeout(msecs, callback)
    • server.timeout
  • Class: http.ServerResponse
    • Event: ‘close‘
    • Event: ‘finish‘
    • response.addTrailers(headers)
    • response.end([data][, encoding][, callback])
    • response.finished
    • response.getHeader(name)
    • response.headersSent
    • response.removeHeader(name)
    • response.sendDate
    • response.setHeader(name, value)
    • response.setTimeout(msecs, callback)
    • response.statusCode
    • response.statusMessage
    • response.write(chunk[, encoding][, callback])
    • response.writeContinue()
    • response.writeHead(statusCode[, statusMessage][, headers])
  • http.IncomingMessage
    • Event: ‘close‘
    • message.headers
    • message.httpVersion
    • message.method
    • message.rawHeaders
    • message.rawTrailers
    • message.setTimeout(msecs, callback)
    • message.statusCode
    • message.statusMessage
    • message.socket
    • message.trailers
    • message.url
  • http.METHODS
  • http.STATUS_CODES
  • http.createClient([port][, host])
  • http.createServer([requestListener])
  • http.get(options[, callback])
  • http.globalAgent
  • http.request(options[, callback])

HTTP

通过require("http")来使用HTTP的客户端和服务端。

Node.js中的HTTP接口用于提供对传统协议中难以使用的特性的支持。 尤其是那些庞大或者是块编码的信息。该接口不会缓冲整个请求或者响应——用户可以自己使用流来处理数据。

HTTP头信息会被以如下的对象格式来表示：

{ ‘content-length‘: ‘123‘,
  ‘content-type‘: ‘text/plain‘,
  ‘connection‘: ‘keep-alive‘,
  ‘host‘: ‘mysite.com‘,
  ‘accept‘: ‘*/*‘ }

键都是小写的。值没有被修改。

为了尽可能的支持HTTP应用的全部范围，Node.js的API是很低级的。 它只会处理流和信息的解析。它只是将一个信息解析成HTTP头或者HTTP体但是不会去解析实际的HTTP头或HTTP体。

想了解如何处理重复的http头的细节请参考message.headers。

原生的http头被保留在rawHeaders属性中，并以[key, value, key2, value2, ...]的数组形式呈现。比如, 之前的信息头对象就含有一个如下形式的rawHeaders列表：

[ ‘ConTent-Length‘, ‘123456‘,
  ‘content-LENGTH‘, ‘123‘,
  ‘content-type‘, ‘text/plain‘,
  ‘CONNECTION‘, ‘keep-alive‘,
  ‘Host‘, ‘mysite.com‘,
  ‘accepT‘, ‘*/*‘ ]

Class: http.Agent

HTTP代理用于作为一个HTTP客户端请求的socket池。

HTTP代理默认对客户端请求使用keep-alive连接。如果一个空闲的socket没有待定处理的http请求，那么这个socket会被关闭。这意味着当服务器处于低负荷状态时开发者不需要去关闭每一个使用KeepAlive的连接，这是一个好消息。

如果你选择使用KeepAlive，你可以将设置一个标识设置为true来创建一个代理对象(详细信息参考constructor options)。然后，代理对象会在池中保存空闲的socket用于以后来使用。他们会被打上明确的标记所以Node.js的进程不会一直处于运行状态。无论如何，当不需要再使用KeepAlive代理时用destroy()来取消它不失为一个好主意，那样所有的sockets也会被关闭。

socket会被从代理池中移除当socket发生一个‘close‘事件或者一个特殊的‘agentRemove‘事件。这意味着如果你试图去维持一个HTTP请求一段时间而又不愿意将其放入池中，你可以像下面这样来处理：

http.get(options, function(res) {
  // Do stuff
}).on("socket", function (socket) {
  socket.emit("agentRemove");
});

又或者，你可以选择使用agent:false来完全脱离池：

http.get({
  hostname: ‘localhost‘,
  port: 80,
  path: ‘/‘,
  agent: false  // create a new agent just for this one request
}, function (res) {
  // Do stuff with response
})

new Agent([options])

当这些属性被设置为各自的默认值并被http.request()使用时，默认的 http.globalAgent 才会被使用。

配置其中的任何一个值，你必须创建一个自己的http.Agent对象。

var http = require(‘http‘);
var keepAliveAgent = new http.Agent({ keepAlive: true });
options.agent = keepAliveAgent;
http.request(options, onResponseCallback);

agent.destroy()

销毁任何一个正在被agent使用的sockets。

通常情况下并不需要这么做。不管怎么说，如果你正在使用开启了keepAlive的agent，最好明确的关闭一个即将不被使用的agent。除此以外，sockets会维持一段时间直到服务器关闭他们。

agent.freeSockets

当使用HTTP KeepAlive时，agent.freeSockets对象会包含一个当前空闲的sockets数组。不要修改它。

nodejs 5.2.0文档自翻译——HTTP模块

标签：

原文地址：http://www.cnblogs.com/A-dam/p/5043324.html