HTTP服务器与客户端
Node.js的http模块,封装了一个高效的HTTP服务器和一个简易的HTTP客户端
http.server是一个基于事件的HTTP服务器,核心由Node.js下层C++部分实现,而接口是由JavaScript封装,兼顾了高性能与简易性。
http.request则是一个HTTP客户端工具,用于向HTTP服务器发起请求,例如实现Pingback或者内容抓取。
1.HTTP服务器
1.1http.Server是http模块中HTTP服务器对象,
用Node.js做的所有基于HTTP协议的系统,如网站、社交应用甚至代理服务器,都是基于http.Server实现的。
它提供了一套封装了级别很低的API,仅仅是流控制和简单的额消息解析,所有的高层功能都要通过它的接口来实现。
http.Server是一个基于事件的HTTP服务器,所有的请求都被封装为独立的事件,开发者只需要对它的事件编写响应函数即可实现HTTP服务器的所有功能。它继承自EventEmitter。
提供以下几个事件:
(1)request:当客户端请求到来时,该事件被触发。提供两个参数req和res,分别是http.ServerRequest和http.ServerResponse的实例,表示请求和响应信息。
(2)connection : 当TCP连接建立时,该事件被触发,提供一个参数socket,为net.Socket的实例。connection事件的粒度要大于request,因为客户端在Keep-Alice模式下可能会在同一个连接内发送多次请求。
(3)close : 当服务器关闭时,该事件被触发。注意不是在用户连接断开时。
1.2 http.ServerRequest是HTTP请求的信息,是后端开发者最关注的内容。
它一般由http.Server的request事件发送,作为第一个参数传递,通常简称为request或req。
HTTP请求一般都会分为两部分:请求头(Request Header)和请求体(Request Body)。
请求体由于可能相对较长,需要一定的事件传输,因此http.ServerRequest提供了以下3个事件用于控制请求体传输。
(1)data : 当请求体数据到来时,该事件被触发。该事件提供了一个参数chunk,表示接收到的数据。如果该事件没有被监听,那么请求体将会被抛弃。该事件可能会被调用多次。
(2)end: 当请求体数据传输完成时,该事件被触发,此后将不会再有数据到来。
(3)close: 用户当前请求结束时,该事件触发。不同于end,如果用户强制终止了传输,也还是会调用close。
1.3获取GET请求内容
由于GET请求直接被嵌入在路径中,URL是完整的请求路径,包括了"?"后面的部分,因此可以手动解析后面的内容作为GET请求的参数。
Node.js的url模块中的parse函数提供了这个功能。
1.4获取POST请求内容
POST请求的内容全部都在请求体中,Node.js默认是不会解析请求体的,原因是等待请求体传输可能是一件耗时的工作,所以很多时候我们可能并不需要理会请求体的内容,
恶意的POST请求会大大消耗服务器的资源。
如果一定需要POST请求的内容的话,需要手动来做。
var http = require("http"); var querystring = require("querystring"); var util = require("util"); http.createServer(function( req, res) { var post = ""; req.on('data',function( chunk ) { post += chunk; }) ; req.on('end',function() { post = querystring.parse(post); res.end(util.inspect(post)) }) }).listen(3000);
注:不要在真正的生产应用中使用上面这种简单的方法来获取POST请求,因为它有严重的效率问题和安全问题,这只是一个帮助你理解的示例。
1.5 http.ServerResponse
http.ServerResponse是返回给客户端的信息,决定了用户最终能看到的结果。它也是由http.Server的request事件发送的,作为第二个参数传递,一般简称为response或res.
http.ServerResponse有三个重要的成员函数,用于返回响应头、响应内容以及结束请求。
(1)reponse.writeHead(statusCode, [headers]) : 向请求的客户端发送响应头。该函数在一个依请求内最多只能调用一次,如果不调用,则会自动生成一个响应头。
statusCode是HTTP状态码,如200(请求成功),404(未找到)等。
headers 是一个类似关联数组的对象,表示响应头的每个属性。
(2)reponse.write(data,[encoding]): 向请求的客户端发送响应的内容。data是一个Buffer或字符串,表示要发送的内容。
如果data是字符串,那么需要制定encoding来说明它的编码方式,默认是utf-8,在response.end调用之前,response.write可以被多次调用。
(3)response.end([data],[encoding]) : 响应结束。告知客户端所有发送已经完成。当所有要返回的内容发送完毕的时候,该函数必须被调用一次。
它接受两个可选参数,意义和response.write相同。如果不调用该函数,客户端将永远处于等待状态。
2.HTTP客户端
http模块提供了两个函数http.request和http.get,功能是作为客户端向HTTP服务器发起请求。
(1)http.request(options, callback)发起HTTP请求。接受两个参数,option是一个类似关联数组的对象,表示请求的参数。
callback是请求的回调函数.
option常用的参数:
host :请求网站的域名或IP地址。
port :请求网站的端口,默认80.
method:请求方法,默认是GET。
path:请求的相对于根路径,默认是"/"。QueryString应该包含在其中,eg: /search?query=test.
headers: 一个关联数组对象,为请求头的内容。
callback传递一个参数,为http.ClientResponse的实例。
http.request返回一个http.ClientRequest的实例。
注:不要忘了通过req.end()结束请求,否则服务器将不会收到信息。
(2)http.get(options, callback )
是http模块提供可一个更加简便的方法用于处理GET处理,它是http.request的简化版,
唯一的区别在于http.get自动将请求方法(method)设置为了GET请求,同时不需要手动调用req.end()。
http.ClientRequest
它是由http.request或http.get返回产生的对象,表示一个已经产生而且正在进行中的HTTP请求。它提供了一个response事件,即http.request或http.get第二个参数指定的回调函数的绑定对象。
http.ClientRequest像http.ServerResponse一样也提供了write和end函数,用于向服务器发送请求体。通常用于POST、PUT等操作。
所有写结束以后必须调用end函数以通知服务器,否则请求无效。
http.ClientRequest还提供了以下函数:
(1)request.abort(): 终止正在发送的请求。
(2)request.setTimeout(timeout , [callback]) : 设置请求超时时间, timeout为毫秒数。当请求超时以后,callback将会被调用。
此外还有request.setNoDelay([noDelay])、request.setSocketKeepAlive([enable] , [initialDelay])等函数。
http.ClientResponse
http.ClientResponse与http.ServerRequest相似,提供了三个事件: data ,end , close, 分别在数据到达、传输结束、连接结束时触发。
其中data事件传递一个参数chunk,表示接收到的数据。
http.ClientResponse也提供了一些属性:
(1) statusCode : HTTP状态码。
(2) httpVersion : HTTP协议版本。通常是1.0或1.1。
(3)headers : HTTP请求头。
(4)trailers : HTTP请求尾。(不常见)
http.ClientResponse还提供了以下几个特殊的函数:
(1)response.setEncoding([encoding]): 设置默认的编码,当data事件被触发时,数据将会以encoding编码。
默认为null,即不编码,以Buffer的形式存储。常用编码为utf8.
(2)response.pause() : 暂停接收数据和发送事件,方便实现下载功能。
(3)response.resume() : 从暂停的状态中恢复。