Nodejs -> http 初探

1. 创建简单服务

const http = require('http')

http.createServer( (req, res) => {
  res.write('hello world')
  res.end()
} ).listen( 3000, () => {
  console.log('server is running...')
} )

2. res 和 req 对象

  • req
    req 是 request 的简称,代表的是客户端的请求对象。下面是 req 对象的继承关系。
    req => IncomingMessage => Stream.Readable
    可以看到,req 继承自 InComingMessage,其上的方法和属性可在 Nodejs 官网看到。

http.IncomingMessage 类
IncomingMessage 对象是由 http.Server 或者 http.ClientRequest 创建,并且作为第一个参数传递给 'request' 和 'response' 事件。可用于访问应用状态,消息头,以及数据等。

API 描述 备注
aborted 事件 当请求中止时出发
close 当底层连接关闭时触发
message.aborted 当请求被中止时,为 true。否则为 false
meaage.complete 如果已接受并且成功的解析了 HTTP 消息,则为 true,否则为 false 可用来检测当连接关闭时,数据流是否传递完毕
message.destory([error]) 在接收到的 IncomingMessage 套接字上使用 destory() 如果提供了 error ,则会触发 'error'事件,并将 error 作为参数传递给事件监听函数
message.headers 请求或者响应的消息头对象 消息头的名称和值的键值对,消息头的名称都是小写
message.httpVersion 在服务器的请求中,表示的是客户端发送的 HTTP 版本
message.method 表示客户端 http 动词('GET') 仅对 http.Server 获取的请求有效
message.rawHeaders 表示原始请求头/响应头,与接收到的完全一致。 键值对位于一个数组中,奇数元素表示键,偶数元素表示值
message.statusCode 获取响应的状态码 仅在 http.ClientRequest 的响应中可以获取到
message.statusMessage 获取响应的状态信息,如 OK 仅在 http.ClientRequest 的响应中可以获取到
message.url 获取请求的路径,如 '/status?p=1' 仅在Http.Server 的 req 中可以访问的到

流(stream)会在后面的文章中介绍。

  • res

res 是 response 的简称,是 http.Server 的响应对象,下面是它的继承关系。
res => ServerResponse => OutgoingMessage => stream
很明显,ServerResponse 的方法和属性,就是 res 所具备的属性和方法。

http.ServerResponse
此对象由 HTTP 对象内部创建,不需要用户自建。并作为 http.Server 的 'request' 事件的第二个参数。

API 描述 备注
close 事件 底层连接被关闭时触发
finish 事件 响应发送后触发 当响应头和主体的最后一段已经切换到操作系统以通过网络传输时,触发该事件。 这并不意味着客户端已收到任何信息。
response.end([data[, encoding[,callback]]]) 此方法向服务器发送信号,表明以发送所有响应头和主体。这时,服务器会视为请求已经发送完毕。 必须为在每个响应调用 response.end()。如果指定了 data,则相当于调用 response.write(data, encoding)后,再调用 response.end()。如果指定了 callback,则会在响应流完成后调用它。
response.finish 如果调用了 response.end()则此属性为 true
response.flushHeader() 刷新响应头 可参阅request.flushHeaders()
response.getHeader(name) 读出以排队,但未发送的响应头 该名称不区分大小写。返回值的类型取决于提供给 response.setHeader() 的参数
response.getHeaderNames() 获取所有响应头键值数组 所有键都是小写
response.getHeaders() 获取所有响应头的键值对集合 键都是小写
response.hasHeader(name) 响应头中包含此头信息时返回 true 响应头不区分大小写
response.headerSent 只读布尔值,响应头已发送为 true,否则为 false
response.removeHeader(name) 移除队列中等待的对应响应头 响应头不区分大小写
response.sendDate 为 true时。Date 会自动生成并包含在响应头中 一般不做更改
response.setHeader(name, value) 为隐式响应头设置单个响应头的值。 如果此响应头已存在于待发送的响应头中,则其值将被替换。 在这里可以使用字符串数组来发送具有相同名称的多个响应头。 非字符串值将被原样保存。 因此 response.getHeader() 可能返回非字符串值。 但是非字符串值将转换为字符串以进行网络传输。
response.setTimeout(ms[,callback]) 将套接字的超时时间设置为 ms。 如果提供了回调函数,则将其添加到响应对象的 'timeout' 事件监听器上
response.scoket 指向底层套接字。通常不需要用户直接调用
response.statusCode 当没有调用 response.writeHeader()设置时,可以进行赋值 默认值是 200。响应头发送到客户端后,表示的是已经发送的状态码
response.statusMessage 直接赋值改变发送到客户端的响应信息 用于隐式改变,显式时使用 response.writeHeader()。当没有改变是,默认是 'Not Found'
response.writableFinished 如果在触发 'finish' 之前,所有数据都已经刷新到底层,则为 true
response.write(chunk[,encoding[,callback]]) 这回发送一块影响体。可以提供连续的响应体。 如果在调用此方法之前未调用 response.writeHeader() ,则将切换到隐式响应头模式并刷新隐式响应头
response.writeHead(statusCode[,statusMessage[],headers]) 向请求发送响应头 返回对 ServerResponse 的引用,以便可以链式调用。此方法只能在消息上调用一次,并且必须在调用 response.end() 之前调用。

总结

res 和 req 是请求和响应的基础,本文的以上部分来自 node 官网,有不懂的或者不全的部分,需要自行学习。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,635评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,628评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,971评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,986评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,006评论 6 394
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,784评论 1 307
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,475评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,364评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,860评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,008评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,152评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,829评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,490评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,035评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,156评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,428评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,127评论 2 356

推荐阅读更多精彩内容