大熊君大话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
        new Agent([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的文件,并写入以下代码:

1 var http = require(‘http‘) ;
2 var server = http.createServer(function(req,res){
3 res.writeHeader(200,{
4     ‘Content-Type‘ : ‘text/plain;charset=utf-8‘  // 添加charset=utf-8
5 }) ;
6 res.end("Hello,大熊!") ;
7 }) ;
8 server.listen(8888) ;
9 console.log("http server running on port 8888 ...") ;

node server.js)以下是运行结果:

 

二,细节分析实例

具体看一下这个小例子:

(1行):通过"require"引入NodeJS自带的"http"模块,并且把它赋值给http变量。

(2行):调用http模块提供的函数:"createServer" 。这个函数会返回一个新的web服务器对象。

  参数 "requestListener" 是一个函数,它将会自动加入到 "request" 事件的监听队列。

  当一个request到来时,Event-Loop会将这个Listener回调函数放入执行队列, node中所有的代码都是一个一个从执行队列中拿出来执行的。

  这些执行都是在工作线程上(Event Loop本身可以认为在一个独立的线程中,我们一般不提这个线程,而将node称呼为一个单线程的执行环境),

  所有的回调都是在一个工作线程上运行。

  我们在再来看一下"requestListener"这个回调函数,它提供了两个参数(request,response),

  每次收到一个请求时触发。注意每个连接又可能有多个请求(在keep-alive的连接中)。

  "request"http.IncomingMessage的一个实例。"response"http.ServerResponse的一个实例。

  一个http request对象是可读流,而http response对象则是可写流。

  一个"IncomingMessage"对象是由http.Serverhttp.ClientRequest创建的,

  并作为第一参数分别传递给"request""response"事件。

  它也可以被用来访问应答的状态,头文件和数据。

  它实现了 "Stream" 接口以及以下额外的事件,方法和属性。(具体参考api)。

(3行):“writeHeader”,使用 "response.writeHead()"  函数发送一个Http状态200和Http头的内容类型(content-type)。

  向请求回复响应头。"statusCode"是一个三位是的HTTP状态码,例如 404 。最后一个参数,"headers",是响应头的内容。

  举个栗子:

1 var body = ‘hello world‘ ;
2 response.writeHead(200, {
3      ‘Content-Length‘: body.length,
4      ‘Content-Type‘: ‘text/plain‘
5 }) ;

 注意:Content-Length 是以字节(byte)计算,而不是以字符(character)计算

  之前的例子原因是字符串 “Hello World !” 只包含了单字节的字符。

  如果body包含了多字节编码的字符,就应当使用Buffer.byteLength()来确定在多字节字符编码情况下字符串的字节数。

  需要进一步说明的是Node不检查Content-Lenth属性和已传输的body长度是否吻合。

 statusCode是一个三位是的HTTP状态码, 例如:"404" 。这里要说的是 "http.STATUS_CODES" ,全部标准"Http"响应状态码的集合和简短描述都在里面。

 如下是源码参考:

  

 1 var STATUS_CODES = exports.STATUS_CODES = {
 2   100 : ‘Continue‘,
 3   101 : ‘Switching Protocols‘,
 4   102 : ‘Processing‘,                 // RFC 2518, obsoleted by RFC 4918
 5   200 : ‘OK‘,
 6   201 : ‘Created‘,
 7   202 : ‘Accepted‘,
 8   203 : ‘Non-Authoritative Information‘,
 9   204 : ‘No Content‘,
10   205 : ‘Reset Content‘,
11   206 : ‘Partial Content‘,
12   207 : ‘Multi-Status‘,               // RFC 4918
13   300 : ‘Multiple Choices‘,
14   301 : ‘Moved Permanently‘,
15   302 : ‘Moved Temporarily‘,
16   303 : ‘See Other‘,
17   304 : ‘Not Modified‘,
18   305 : ‘Use Proxy‘,
19   307 : ‘Temporary Redirect‘,
20   400 : ‘Bad Request‘,
21   401 : ‘Unauthorized‘,
22   402 : ‘Payment Required‘,
23   403 : ‘Forbidden‘,
24   404 : ‘Not Found‘,
25   405 : ‘Method Not Allowed‘,
26   406 : ‘Not Acceptable‘,
27   407 : ‘Proxy Authentication Required‘,
28   408 : ‘Request Time-out‘,
29   409 : ‘Conflict‘,
30   410 : ‘Gone‘,
31   411 : ‘Length Required‘,
32   412 : ‘Precondition Failed‘,
33   413 : ‘Request Entity Too Large‘,
34   414 : ‘Request-URI Too Large‘,
35   415 : ‘Unsupported Media Type‘,
36   416 : ‘Requested Range Not Satisfiable‘,
37   417 : ‘Expectation Failed‘,
38   418 : ‘I\‘m a teapot‘,              // RFC 2324
39   422 : ‘Unprocessable Entity‘,       // RFC 4918
40   423 : ‘Locked‘,                     // RFC 4918
41   424 : ‘Failed Dependency‘,          // RFC 4918
42   425 : ‘Unordered Collection‘,       // RFC 4918
43   426 : ‘Upgrade Required‘,           // RFC 2817
44   500 : ‘Internal Server Error‘,
45   501 : ‘Not Implemented‘,
46   502 : ‘Bad Gateway‘,
47   503 : ‘Service Unavailable‘,
48   504 : ‘Gateway Time-out‘,
49   505 : ‘HTTP Version not supported‘,
50   506 : ‘Variant Also Negotiates‘,    // RFC 2295
51   507 : ‘Insufficient Storage‘,       // RFC 4918
52   509 : ‘Bandwidth Limit Exceeded‘,
53   510 : ‘Not Extended‘                // RFC 2774
54 };

节选自,Nodejs源码 ”http.js“ 143行开始。

其实从客户端应答结果也不难看出:

(6行):”response.end“------当所有的响应报头和报文被发送完成时这个方法将信号发送给服务器。服务器会认为这个消息完成了。

  每次响应完成之后必须调用该方法。如果指定了参数 “data” ,就相当于先调用  “response.write(data, encoding) ” 之后再调用 “response.end()” 。

(8行):”server.listen(8888)“ ------ 服务器用指定的句柄接受连接,绑定在特定的端口。

以上就是一个比较详细的分析过程,希望有助于加深理解,代码虽然不多,但是重在理解一些细节机制,以便日后高效的开发NodeJS应用。

三,实例赏心

除了可以使用"request"对象访问请求头数据外,还能把"request"对象当作一个只读数据流来访问请求体数据。

这是一个"POST"请求的例子:

 1 http.createServer(function (request, response) {
 2     var body = [];
 3     console.log(request.method) ;
 4     console.log(request.headers) ;
 5     request.on(‘data‘, function (chunk) {
 6         body.push(chunk);
 7     }) ;
 8     request.on(‘end‘, function () {
 9         body = Buffer.concat(body) ;
10         console.log(body.toString()) ;
11     });
12 }).listen(8888) ;

下是一个完整的“Http”请求数据内容。

1 POST / HTTP/1.1
2 User-Agent: curl/7.26.0
3 Host: localhost
4 Accept: */*
5 Content-Length: 11
6 Content-Type: application/x-www-form-urlencoded
7 Hello World

四,总结一下

(1),理解 "Http" 概念。

(2),熟练使用 "Http" 相关的api。

(3),注意细节的把控,比如:“POST,GET” 之间的处理细节。

(4),"requestListener"的理解。

(5),强调一个概念:一个http request对象是可读流,而http response对象则是可写流 。

                 哈哈哈,本篇结束,未完待续,希望和大家多多交流够沟通,共同进步。。。。。。呼呼呼……(*^__^*)             

时间: 2024-08-04 15:13:27

大熊君大话NodeJS之------Http模块的相关文章

大熊君大话NodeJS之------Net模块

一,开篇分析 从今天开始,我们来深入具体的模块学习,这篇文章是这个系列(大熊君大话NodeJS)文章的第三篇,前两篇主要是以理论为主,相信大家在前两篇的学习中, 对NodeJS也有一个基本的认识,没事!!!趁热打铁,让我们继续将NodeJS进行到底,好了废话不多说,直接进入今天的主题 “Net模块” ,那么”Net“应该如何理解那? 它是做什么用的那?(Net模块可用于创建Socket服务器或Socket客户端. NodeJS 的数据通信,最基础的两个模块是 Net 和 Http,前者是基于 T

大熊君大话NodeJS之------Stream模块

一,开篇分析 流是一个抽象接口,被 Node 中的很多对象所实现.比如对一个 HTTP 服务器的请求是一个流,stdout 也是一个流.流是可读,可写或兼具两者的. 最早接触Stream是从早期的unix开始的, 数十年的实践证明Stream 思想可以很简单的开发出一些庞大的系统. 在unix里,Stream是通过 "|" 实现的.在node中,作为内置的stream模块,很多核心模块和三方模块都使用到. 和unix一样,node stream主要的操作也是.pipe(),使用者可以使

大熊君大话NodeJS之------MongoDB模块(额外篇)

一,开篇分析 这篇属于扩展知识篇,因为在下面的文章中会用到数据库操作,所以今天就来说说它(Mongodb模块). (1),简介 MongoDB是一个基于分布式文件存储的数据库.由C++语言编写.旨在为WEB应用提供可扩展的高性能数据存储解决方案. MongoDB是一个高性能,开源,无模式的文档型数据库,是当前NoSql数据库中比较热门的一种. MongoDB是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的.他支持的数据结构非常松散,是类似json的bj

大熊君大话NodeJS之------Buffer模块

一,开篇分析 所谓缓冲区Buffer,就是 "临时存贮区" 的意思,是暂时存放输入输出数据的一段内存. JS语言自身只有字符串数据类型,没有二进制数据类型,因此NodeJS提供了一个与String对等的全局构造函数Buffer来提供对二进制数据的操作.除了可以读取文件得到Buffer的实例外,还能够直接构造,例如: var buffer = new Buffer([ 0x68, 0x65, 0x6c, 0x6c, 0x6f ]) ; Buffer与字符串类似,除了可以用.length属

大熊君大话NodeJS之------基于Connect中间件的小应用(Bigbear记事本应用之第一篇)

一,开篇分析 大家好哦,大熊君又来了,昨天因为有点个人的事没有写博客,今天又出来了一篇,这篇主要是写一个记事本的小应用,前面的文章, 我也介绍过“Connect”中间件的使用以及“Mongodb”的用法,今天就结合这两个中间件,写个实际的例子,不断完善和重构,已达到 充分学习的目的.好了,废话不说了,直接进入主题. 二,需求分析 (1),用户注册,登录功能(没有涉及很复杂的交互场景,注册时会有用户判断是否已存在). (2),用户登录成功,进入笔记管理系统的后台(笔记模块的增删改查功能). (3)

大熊君大话NodeJS之开篇------Why NodeJS(将Javascript进行到底)

一,开篇分析 大家好啊,大熊君又来啦(*^__^*) 嘻嘻……,之前我写过一系列关于JS(OOP与设计模式)方面的文章,反响还好,其实这也是对我本人最大的鼓励,于是我决定我要将JavaScript进行到底 准备写一个NodeJS方面的系列文章,由浅入深,循序渐进,秉承的理念是重思想,多实践,勤能补拙,贵在坚持. 我们先来看看NodeJS官网上的介绍: 其特点为: 1,它是一个Javascript运行环境 2,依赖于Chrome V8引擎进行代码解释 3,事件驱动 4, 非阻塞I/O 5, 轻量.

大熊君大话NodeJS之------FS文件模块

一,开篇分析 文件系统模块是一个简单包装的标准 POSIX 文件 I/O 操作方法集.可以通过调用 require("fs") 来获取该模块.文件系统模块中的所有方法均有异步和同步版本. (1),文件系统模块中的异步方法需要一个完成时的回调函数作为最后一个传入形参. (2),回调函数的构成由调用的异步方法所决定,通常情况下回调函数的第一个形参为返回的错误信息. (3),如果异步操作执行正确并返回,该错误形参则为null或者undefined.如果使用的是同步版本的操作方法,一旦出现错误

大熊君大话NodeJS之------(Url,QueryString,Path)模块

一,开篇分析 这篇文章把这三个模块拿来一起说,原因是它们各自的篇幅都不是很长,其次是它们之间存在着依赖关系,所以依次介绍并且实例分析.废话不多说了,请看下面文档: (1),"Url模块" 来个小栗子: 1 var url = require('url'); 2 var queryUrl = "http://localhost:8888/bb?name=bigbear&memo=helloworld" ; 3 console.log(typeof url.pa

大熊君大话NodeJS之------Global Objects全局对象

一,开篇分析 在上个章节中我们学习了NodeJS的基础理论知识,对于这些理论知识来说理解是至关重要的,在后续的章节中,我们会对照着官方文档逐步学习里面的各部分模块,好了该是本文主角登台亮相的时候了,Global  让我们来看一下官方的定义: Global Objects全局对象 These objects are available in all modules. Some of these objects aren't actually in the global scope but in t