先给各位打个预防针,这篇博客比较长需要各位静下心来看。同时这片博客也是最重要的一个环节。服务和客户端的请求响应方式
HTTP服务器与客户端
Node.js 标准库提供了 http 模块,其中封装了一个高效的 HTTP 服务器和一个简易的HTTP客户端。http.Server 是一个基于事件的 HTTP服务器,它的核心由 Node.js 下层 C++部分实现,而接口由 JavaScript 封装,兼顾了高性能与简易性。 http.request 则是一个HTTP 客户端工具,用于向 HTTP 服务器发起请求,例如实现 Pingback或者内容抓取。
http服务器端
http.Server 是 http 模块中的 HTTP 服务器对象,用Node.js 做的所有基于 HTTP 协议的系统,如网站、社交应用甚至代理服务器,都是基于 http.Server 实现的。它提供了一套封装级别很低的 API,仅仅是流控制和简单的消息解析,所有的高层功能都要通过它的接口来实现。
http.Server 的事件
一、request:当客户端请求到来时,该事件被触发,提供两个参数 req 和res,分别是http.ServerRequest 和 http.ServerResponse 的实例,表示请求和响应信息。
二、connection:当 TCP 连接建立时,该事件被触发,提供一个参数 socket,为net.Socket 的实例。 connection 事件的粒度要大于 request,因为客户端在Keep-Alive 模式下可能会在同一个连接内发送多次请求。
三、close :当服务器关闭时,该事件被触发。注意不是在用户连接断开时。
除此之外还有 checkContinue、 upgrade、 clientError 事件,通常我们不需要关心,只有在实现复杂的 HTTP 服务器的时候才会用到。
还记得我们以前是怎么写服务了吗?http.createServer(fn)fn有两个参数分别是req和resp最后有监听端口号为3000的服务器。事实上我们创建服务还有一种显示实现方法。
例如:
var http=require(‘http’); var server =new http.Server(); server.on(‘request’,function(req,res){ res.writeHead(200,{‘Content-Type’:’text/html’}); res.write(‘<h1>Node.js</h1>’); res.end(‘<p>world</p>’) }) Server.listen(3000); Console.log(“http server is listening atport 3000”);
介绍这里我们就继续深入这个服务咯
http.ServerRequest
http.ServerRequest 是 HTTP 请求的信息。也是我们服务端最关心的内容。我们上边说了http.server有一个requiest。它一般有http.server的requiest事件发送,作为第一个参数,ServerRequest提供一些属性如下:
complete 客户端请求是否已经发送完成
httpVersion HTTP 协议版本,通常是 1.0 或 1.1
method HTTP 请求方法,如 GET、 POST、 PUT、 DELETE 等
url 原始的请求路径,例如/static/image/x.jpg 或 /user?name=byvoid
headers HTTP 请求头
trailers HTTP 请求尾(不常见)
connection 当前 HTTP 连接套接字,为 net.Socket 的实例
socket connection 属性的别名
client client 属性的别名
说了http。Serverrequest是http请求的信息了那httpp请求一般可以分两部分的噢噢。一个请求头一个请求体。作为请求体可能相对较长。但是我们请求不能等待好长时间啊,你受的了单用户受不了啊!!,所以http。Serverquest提供了三个事件来供我们控制请求体传输噢噢。
一、 data :当请求体数据到来时,该事件被触发。该事件提供一个参数 chunk,表示接收到的数据。如果该事件没有被监听,那么请求体将会被抛弃。该事件可能会被调用多次。
二、 end :当请求体数据传输完成时,该事件被触发,此后将不会再有数据到来。
三、 close: 用户当前请求结束时,该事件被触发。不同于end,如果用户强制终止了传输,也还是调用close。
获取 GET 请求内容
如果你是个开发人员就知道作为请求常用到的post和get两个对吧。但是http.serverrequest不像其他的java和php都有get和post方法噢噢,在这里你就问我了,那nodejs怎么做get请求呢?大家想想由于get是嵌入到url中,包括了?后边的部分,因此你可以手动解析后边的内容作为get请求的参数啊。你要把参数转化成对象,当然转化部分node已经为我们提供了parse模块了。例如
var http= require('http'); var url =require('url'); var util= require('util'); http.createServer(function(req,res) { res.writeHead(200,{'Content-Type': 'text/plain'}); res.end(util.inspect(url.parse(req.url,true))); }).listen(3000);
上边这段代码我就新加了两个方法util.inspect和url.parse第一个返回一个对象的字符串表现形式,第二个就是把字符串转发成json对象
在浏览器访问http://localhost:3000/user?name=’heimao’&age=23我们看下结果噢噢
Url {
protocol: null,
slashes: null,
auth: null,
host: null,
port: null,
hostname: null,
hash: null,
search:‘?name=%27heimao%27&age=12‘,
query: { name:‘\‘heimao\‘‘, age: ‘12‘ },
pathname: ‘/‘,
path:‘/?name=%27heimao%27&age=12‘,
href:‘/?name=%27heimao%27&age=12‘ }
接下来只是我们对字符串的处理咯当当当。。。。。。是不是很拽。query则是我们所谓的get请求的内容。而路径则是pathname。
获取 post 请求内容
上边我们介绍了get的请求方式。下边我们要介绍下第二个post请求内容的获取。还记得我上边说的吗http请求是分两部分一个是请求头一个是请求体。HTTP协议 1.1 版本提供了8种标准的请求方法,其中最常见的就是 GET 和 POST。Get我们就不说了就是将内容编码到url中。Post请求内容全部都在请求体中。http.serverrequest则没有一个请求体的属性。其原因是等待请求体传输是个耗时的工作。客户会受不了的。所以为了解决这个问题,Node是不会自己解析请求体的。当你需要的时候需要我们自己手动的去解析它。来看看示例我们将要如何解析post过来的请求体。
var http=require("http"); varquerystring=require("querystring"); var util=require("util"); http.createServer(function(req,res){ varpost=''; req.on('data',function(chunk){ post+=chunk; }) req.on('end',function(){ post=querystring.parse(post); res.end(util.inspect(post)); }) }).listen(3000)
通过上边的代码我们可以知道node并没有解析post请求过来的数据,而是通过chunk参数把数据缓存到了post变量里边最后通过触发end事件后通过queryString.Parse将post解析为真正的post请求格式。然后返回客户端。
回顾我们上边说的,我们只是说了下三个重要点一个是http.request的事件包括data,end,connect。还有rquest的常用的两个方法post和get的解析方式。当我们把请求的两种方法说完之后该说http.serverresponse响应方式了.
http.ServerResponse
http.ServerResponse 是返回给客户端的信息,决定了用户最终能看到的结果。它也是由 http.Server 的 request 事件发送的,作为第二个参数传递,一般简称为response 或 res
http.serverresponse有三个重要的成员函数,用于返回响应头,响应内容以及结束请求。
一、response.writeHead(statusCode, [headers]):向请求的客户端发送响应头。statusCode 是 HTTP 状态码,如 200 (请求成功)、 404 (未找到)等。 headers是一个类似关联数组的对象,表示响应头的每个属性。该函数在一个请求内最多只能调用一次,如果不调用,则会自动生成一个响应头。
二、response.write(data, [encoding]):向请求的客户端发送响应内容。 data 是一个 Buffer 或字符串,表示要发送的内容。如果 data 是字符串,那么需要指定encoding 来说明它的编码方式,默认是 utf-8。在 response.end 调用之前,response.write 可以被多次调用。
三、response.end([data], [encoding]):结束响应,告知客户端所有发送已经完成。当所有要返回的内容发送完毕的时候,该函数必须 被调用一次。它接受两个可选参数,意义和 response.write 相同。如果不调用该函数,客户端将永远处于等待状态。
说完了服务端所需的操作方法我们接下来就该了解客户端的一些方法了,接下来来看下我们客户端所需要的方法都有哪些、
http客户端
http模块为客户端提供了两个方法一个request和一个get,功能是作为客户端向http服务器发起请求。
http.request
一、http.request(options,callback)发起一个http请求,接受两个参数,option是一个关联数组的对象,表示请求参数,callback是请求的回调函数。
Option的详细配置项如下:
1) host :请求网站的域名或 IP 地址
2) port :请求网站的端口,默认80。
3) method :请求方法,默认是 GET。
4) path :请求的相对于根的路径,默认是“ /”。 QueryString 应该包含在其中。例如search?query=byvoid。
5) headers :一个关联数组对象,为请求头的内容。
6) callback 传递一个参数,为http.ClientResponse 的实例
7)
而http.request返回的是一个http.clientRequest的实例
下边是通过http.request发送post请求的代码
//httprequest.js //导入http模块 varhttp=require('http'); varquerystring=require('querystring'); varcontents=querystring.stringify({ name:"blackCat", email:"[email protected]", address:"河北邯郸那" }); varoption={ host:"www.heimao.com", path:"application/node/post.action", method:"post", headers:{ "Content-Type":"application/x-www-form-urlencoded", "Content-Length":contents.length } } varreq=http.request(option,function(res){ res.setEncoding('utf8'); res.on('data',function(data){ console.log(data); }) }); req.write(contents); req.end();
运行后结果如下:
array(3){
["name"]=>
string(6) "heimao"
["email"]=>
string(14) "[email protected]"
["address"]=>
string(10) "河北邯郸那"
}
当然除了客户端用post请求也可以用get请求的,也可以把option内的method方法写成get,但是呢node已经为我们准备了更简单的get请求方法。如下:
http.get
二、http.get(options,callback):它是 http.request 的简化版,唯一的区别在于http.get自动将请求方法设为了 GET 请求,同时不需要手动调用 req.end()
当然除了描述get方法我还得写个简单的demo更容易理解:demo如下:
varhttp=require("http"); http.get({ host:"www.heimao.com" },function(res){ res.setEncoding("utf8"); res.on("data",function(data){ console.log(data); }) })
我们在上边分别介绍了客户端的post和get请求,但是里边回调函数的参数和返回的对象还是有必要要跟大家说下,我们首先介绍下get和post返回的对象http。clientRequest。
http.clientRequest
http.ClientRequest 是由 http.request 或 http.get 返回产生的对象,表示一个已经产生而且正在进行中的 HTTP请求。它提供一个 response 事件,即 http.request或 http.get 第二个参数指定的回调函数的绑定对象。我们也可以显式地绑定这个事件的监听函数:
var http =require(‘http‘);
var req =http.get({host: ‘www.byvoid.com‘});
req.on(‘response‘, function(res) {
res.setEncoding(‘utf8‘);
res.on(‘data‘, function (data) {
console.log(data);
});
});
http.ClientRequest 像 http.ServerResponse一样也提供了 write 和 end 函数,用于向服务器发送请求体,通常用于 POST、 PUT 等操作。所有写结束以后必须调用 end函数以通知服务器,否则请求无效。 http.ClientRequest 还提供了以下函数
1. request.abort():终止正在发送的请求。
2. request.setTimeout(timeout, [callback]):设置请求超时时间,timeout 为毫秒数。当请求超时以后, callback 将会被调用。
3. 此外还有request.setNoDelay([noDelay])、request.setSocketKeepAlive([enable], [initialDelay]) 等函数,具体内容请参见Node.js 文档。
介绍完了http.get()和http.Request返回clientrequest的对象之后我们再说下http.get和http.Request的第二个参数回调函数的参数http.clientResponse
http.clientResponse
clientResponse与服务端的http.serverrequest相似,提供了三个事件date,end和close,分别是数据到达,传输结束和连接结束时触发,其中data事件传递一个参数chunk,表示接受到的数据。
http.ClientResponse也提供了一些属性,用于表示请求的结果状态,
1) statusCode: HTTP 状态码,如 200、 404、 500
2) httpVersion: HTTP 协议版本,通常是 1.0 或 1.1
3) headers: HTTP 请求头
4) trailers: HTTP 请求尾(不常见)
除了以上几个属性之外还停工了几个特殊的函数如下
1) response.setEncoding([encoding]):设置默认的编码,当data 事件被触发时,数据将会以 encoding 编码。默认值是 null,即不编码,以 Buffer 的形式存储。常用编码为 utf8。
2) response.pause():暂停接收数据和发送事件,方便实现下载功能。
3) response.resume():从暂停的状态中恢复。
更多的参考资料地址:
Node.js Manual & Documentation:http://nodejs.org/api/index.html。
Understanding process.nextTick():http://howtonode.org/understanding- processnext-tick。
揭秘Node.js事件: http://www.grati.org/?p=318