Http模块

标签：

一、http对象的属性和方法

  1、http.STATUS_CODES　　//A collection of all the standard HTTP response status codes, and the short description of each

  2、http.METHODS　　//A list of the HTTP methods that are supported by the parser.

  3、http.get(options[, callback])　　//封装了的http.request()方法，实现了req.end()方法，源码如下：

exports.get = function(options, cb) {
  var req = exports.request(options, cb);
  req.end();
  return req;
};

  4、http.globalAgent　　//超全局的代理实例，是http客户端的默认请求。

  5、http.request(options[, callback])　　//返回一个http.ClientRequest对象。options可以是一个对象或一个字符串。如果options是一个字符 串, 它将自动使用url.parse()解析。使用http.request()方法时都必须总是调用req.end()以表明这个请求已经完成，即使响应body里没有任何数据。如果在请求期间发生错误（DNS解析、TCP级别的错误或实际HTTP解析错误

），在返回的请求对象会触发一个‘error‘事件。

  有一些特殊的标题应该注意:

• 发送 ‘Connection: keep-alive‘将会告知Node保持连接直到下一个请求发送
• 发送 ‘Content-length‘ 头将会禁用默认的 chunked 编码
• 发送 ‘Expect‘报头会立即发送请求报头. 通常当发送 ‘Expect: 100-continue‘时，你会同时发送一个超时和监听继续的事件。 查看 RFC2616 第 8.2.3 章节获得更多信息
• 发送一个授权报头将会覆盖使用 auth 选项来完成基本授权

二、http.ClientRequest类

  1、实现方式：http.request(options,callback)||http.request.get(options,callback)　　//处理服务器返回的响应时调用callback函数  回调函数的唯一参数是IncomingMessage对象

  2、该对象实现了Writeable流

  3、创建ClientRequest对象时，可以指定的options选项

  4、ClientRequest对象提供的事件

   5、ClientRequest对象的方法

• request.abort()：终止当前请求
• request.end([data][, encoding][, callback])：把可选的数据写入请求正文，然后刷新Writeable流并终止该请求
• request.flushHeaders()：刷新请求头
• request.setNoDelay([noDelay])：禁用在发送数据之前缓冲数据的Node算法
• request.setSocketKeepAlive([enable][, initialDelay])：启用和禁用客户机请求的保持活动功能
• request.setTimeout(timeout[, callback])：为轻汽油设置套接字超时时间
• request.write(chunk[, encoding][, callback])：把一个正文数据块写入请求。

三、http.ServerResponse对象

  1、描述：这是一个由HTTP服务器内部创建的对象（不是由用户自行创建）。它将作为第二个参数传递到‘request‘事件中。

  2、ServerResponse对象提供的事件

  3、ServerResponse对象的方法和属性

 四、http.IncomingMessage对象

  1、事件：

• close：当底层套接字被关闭时发出

  2、方法和属性

• message.destroy([error])：If error is provided, an ‘error‘ event is emitted and error is passed as an argument to any listeners on the event.
• message.headers：包含了随请求/回应发送的标头的一个对象
• message.httpVersion：指定用于构建客户端请求/响应的HTTP版本
• message.method：指定用于请求/响应的方法
• message.rawHeaders：The raw request/response headers list exactly as they were received.
• message.rawTrailers：The raw request/response trailer keys and values exactly as they were received. Only populated at the ‘end‘ event.
• message.setTimeout(msecs, callback)：设置连接的以毫秒为单位的套接字超时时间，连同一个如果发生超时时被执行的回调函数
• message.statusCode：指定来自服务器的3位数状态码。此属性只在处理服务器响应的HTTP客户端上有效
• message.statusMessage：
• message.socket：这是一个指向net.Socket对象的句柄，用来与客户端/服务器通信
• message.trailers：The request/response trailers object. Only populated at the ‘end‘ event.
• message.url：发送到服务器的URL字符串，只在处理服务器中有效

五、http.Server对象

  1、描述：提供了实现HTTP服务器的基本框架。实现了EventEmitterl类

  2、创建对象：var server=http.createServer([requestListener]);

  2、该对象的事件

   3、该对象的方法

• server.close([callback])：服务器停止已经开始的监听
• server.listen(port[, hostname][, backlog][, callback]):
• port:指定监听的端口
• hostname:指定主机名
• backlog:指定被允许进行排队的最大待处理连接数。默认是511。
• callback:指定改服务器已经开始在指定的端口上监听时，要执行的回调处理函数
• server.listen(handle[, callback])和server.listen(path[, callback])：监听文件系统的连接。第一个是监听已打开文件描述句柄，第二个是要监听一个文件的路径

六、http.Agent类

  1、基本用法：

• HTTP Agent 是用于把套接字做成资源池，用于HTTP客户端请求。
• HTTP Agent 也把客户端的请求默认为使用Connection:keep-alive。如果没有HTTP请求正在等待成为空闲的套接字的话，那么套接字将关闭。这意味着Node的资源池在负载的情况下对keep-alive有利，但是仍然不需要开发人员使用KeepAlive来手动关闭HTTP客户端。
• 如果你选择使用HTTP KeepAlive，那么你可以创建一个标志设为true的Agent对象。然后，Agent将会在资源池中保持未被使用的套接字，用于未来使用。它们将会被显式标记，以便于不保持Node进程的运行。但是当KeepAlive agent没有被使用时，显式地destroy() KeepAlive agent仍然是个好主意，这样套接字们会被关闭。
• 当套接字触发了close事件或者特殊的agentRemove事件的时候，套接字们从agent的资源池中移除
• 你可以直接使用agent:false选择完全停用资源池。

  2、构造函数

  3、属性

  4、方法

Http模块

标签：

原文地址：http://www.cnblogs.com/realsoul/p/5625396.html