NodeJS学习笔记之Http模块
一,开篇分析
首先“Http”这个概念大家应该比较熟悉了,它不是基于特定语言的,是一个通用的应用层协议,不同语言有不同的实现细节,但是万变不离其宗,思想是相同的,
NodeJS作为一个宿主运行环境,以JavaScript为宿主语言,它也有自己实现的一套标准,这篇文章我们就一起来学习一下“Http模块”。但是作为前提来说,
希望大家可以先阅读一下官网提供的api,有一个前置了解,这样就方便多了,以下是Http部分的api概览:
HTTP
http.STATUS_CODES
http.createServer([requestListener])
http.createClient([port],[host])
Class:http.Server
事件:"request"
事件:"connection"
事件:"close"
Event:"checkContinue"
事件:"connect"
Event:"upgrade"
Event:"clientError"
server.listen(port,[hostname],[backlog],[callback])
server.listen(path,[callback])
server.listen(handle,[callback])
server.close([callback])
server.maxHeadersCount
server.setTimeout(msecs,callback)
server.timeout
Class:http.ServerResponse
事件:"close"
response.writeContinue()
response.writeHead(statusCode,[reasonPhrase],[headers])
response.setTimeout(msecs,callback)
response.statusCode
response.setHeader(name,value)
response.headersSent
response.sendDate
response.getHeader(name)
response.removeHeader(name)
response.write(chunk,[encoding])
response.addTrailers(headers)
response.end([data],[encoding])
http.request(options,callback)
http.get(options,callback)
Class:http.Agent
newAgent([options])
agent.maxSockets
agent.maxFreeSockets
agent.sockets
agent.freeSockets
agent.requests
agent.destroy()
agent.getName(options)
http.globalAgent
Class:http.ClientRequest
Event"response"
Event:"socket"
事件:"connect"
Event:"upgrade"
Event:"continue"
request.write(chunk,[encoding])
request.end([data],[encoding])
request.abort()
request.setTimeout(timeout,[callback])
request.setNoDelay([noDelay])
request.setSocketKeepAlive([enable],[initialDelay])
http.IncomingMessage
事件:"close"
message.httpVersion
message.headers
message.rawHeaders
message.trailers
message.rawTrailers
message.setTimeout(msecs,callback)
message.method
message.url
message.statusCode
message.socket
让我们先从一个简单例子开始,创建一个叫server.js的文件,并写入以下代码:
varhttp=require("http");
varserver=http.createServer(function(req,res){
res.writeHeader(200,{
"Content-Type":"text/plain;charset=utf-8" //添加charset=utf-8
});
res.end("Hello,大熊!");
});
server.listen(8888);
console.log("httpserverrunningonport8888...");
(nodeserver.js)以下是运行结果:
二,细节分析实例
具体看一下这个小例子:
(1行):通过"require"引入NodeJS自带的"http"模块,并且把它赋值给http变量。
(2行):调用http模块提供的函数:"createServer"。这个函数会返回一个新的web服务器对象。
参数"requestListener"是一个函数,它将会自动加入到"request"事件的监听队列。
当一个request到来时,Event-Loop会将这个Listener回调函数放入执行队列,node中所有的代码都是一个一个从执行队列中拿出来执行的。
这些执行都是在工作线程上(EventLoop本身可以认为在一个独立的线程中,我们一般不提这个线程,而将node称呼为一个单线程的执行环境),
所有的回调都是在一个工作线程上运行。
我们在再来看一下"requestListener"这个回调函数,它提供了两个参数(request,response),
每次收到一个请求时触发。注意每个连接又可能有多个请求(在keep-alive的连接中)。
"request"是http.IncomingMessage的一个实例。"response"是http.ServerResponse的一个实例。
一个httprequest对象是可读流,而httpresponse对象则是可写流。
一个"IncomingMessage"对象是由http.Server或http.ClientRequest创建的,
并作为第一参数分别传递给"request"和"response"事件。
它也可以被用来访问应答的状态,头文件和数据。
它实现了"Stream"接口以及以下额外的事件,方法和属性。(具体参考api)。
(3行):“writeHeader”,使用"response.writeHead()" 函数发送一个Http状态200和Http头的内容类型(content-type)。
向请求回复响应头。"statusCode"是一个三位是的HTTP状态码,例如404。最后一个参数,"headers",是响应头的内容。
举个栗子:
注意:Content-Length是以字节(byte)计算,而不是以字符(character)计算。 之前的例子原因是字符串“HelloWorld!”只包含了单字节的字符。 如果body包含了多字节编码的字符,就应当使用Buffer.byteLength()来确定在多字节字符编码情况下字符串的字节数。 需要进一步说明的是Node不检查Content-Lenth属性和已传输的body长度是否吻合。 statusCode是一个三位是的HTTP状态码,例如:"404"。这里要说的是"http.STATUS_CODES",全部标准"Http"响应状态码的集合和简短描述都在里面。 如下是源码参考: 节选自,Nodejs源码”http.js“143行开始。 其实从客户端应答结果也不难看出: (6行):”response.end“------当所有的响应报头和报文被发送完成时这个方法将信号发送给服务器。服务器会认为这个消息完成了。 每次响应完成之后必须调用该方法。如果指定了参数“data”,就相当于先调用 “response.write(data,encoding)”之后再调用“response.end()”。 (8行):”server.listen(8888)“------服务器用指定的句柄接受连接,绑定在特定的端口。 以上就是一个比较详细的分析过程,希望有助于加深理解,代码虽然不多,但是重在理解一些细节机制,以便日后高效的开发NodeJS应用。 三,实例 除了可以使用"request"对象访问请求头数据外,还能把"request"对象当作一个只读数据流来访问请求体数据。 这是一个"POST"请求的例子: 下是一个完整的“Http”请求数据内容。 四,总结一下 (1),理解"Http"概念。
varbody="helloworld";
response.writeHead(200,{
"Content-Length":body.length,
"Content-Type":"text/plain"
});
varSTATUS_CODES=exports.STATUS_CODES={
100:"Continue",
101:"SwitchingProtocols",
102:"Processing", //RFC2518,obsoletedbyRFC4918
200:"OK",
201:"Created",
202:"Accepted",
203:"Non-AuthoritativeInformation",
204:"NoContent",
205:"ResetContent",
206:"PartialContent",
207:"Multi-Status", //RFC4918
300:"MultipleChoices",
301:"MovedPermanently",
302:"MovedTemporarily",
303:"SeeOther",
304:"NotModified",
305:"UseProxy",
307:"TemporaryRedirect",
400:"BadRequest",
401:"Unauthorized",
402:"PaymentRequired",
403:"Forbidden",
404:"NotFound",
405:"MethodNotAllowed",
406:"NotAcceptable",
407:"ProxyAuthenticationRequired",
408:"RequestTime-out",
409:"Conflict",
410:"Gone",
411:"LengthRequired",
412:"PreconditionFailed",
413:"RequestEntityTooLarge",
414:"Request-URITooLarge",
415:"UnsupportedMediaType",
416:"RequestedRangeNotSatisfiable",
417:"ExpectationFailed",
418:"I\"mateapot", //RFC2324
422:"UnprocessableEntity", //RFC4918
423:"Locked", //RFC4918
424:"FailedDependency", //RFC4918
425:"UnorderedCollection", //RFC4918
426:"UpgradeRequired", //RFC2817
500:"InternalServerError",
501:"NotImplemented",
502:"BadGateway",
503:"ServiceUnavailable",
504:"GatewayTime-out",
505:"HTTPVersionnotsupported",
506:"VariantAlsoNegotiates", //RFC2295
507:"InsufficientStorage", //RFC4918
509:"BandwidthLimitExceeded",
510:"NotExtended" //RFC2774
};
http.createServer(function(request,response){
varbody=[];
console.log(request.method);
console.log(request.headers);
request.on("data",function(chunk){
body.push(chunk);
});
request.on("end",function(){
body=Buffer.concat(body);
console.log(body.toString());
});
}).listen(8888);
POST/HTTP/1.1
User-Agent:curl/7.26.0
Host:localhost
Accept:*/*
Content-Length:11
Content-Type:application/x-www-form-urlencoded
HelloWorld
(2),熟练使用"Http"相关的api。
(3),注意细节的把控,比如:“POST,GET”之间的处理细节。
(4),"requestListener"的理解。
(5),强调一个概念:一个httprequest对象是可读流,而httpresponse对象则是可写流。相关文章