一個簡單的Node.js應用,只需要如下兩行代碼即可構建。
let fn = (req,res)=>res.end('hellp');? ? let server = http.createServer(fn).listen(7000)
上面的代碼容易讓很多Node開發形而上學而忽略它的本質。
實際上由于Node在API設計上大量采用了facade模式,使得不少api的使用實際上只是調用另一個api而已。比如res.end('hello'),等價于res.write('hello')+res.end()。
開頭的那段代碼,在Node實際,內部上是個在request事件上掛載listener的模型。
let fn = (req,res)=>res.end();? ? let server = http.createServer()? ? server.on('request',fn)
在我專欄的上篇文章,我分享了如何采用Symbol來實現Promise。在文章寫完后,同事們的反饋是太過晦澀、對讀者的要求也比較高。所以這篇文章,我改進了分享形式,不采用代碼模式而采用圖形化數據結構來分享Node知識。
本文的主要知識點在于request和response對象。
我采用tree的結構展示了這兩個對象原型鏈中http_out_going、stream、eventEmitter等的繼承關系。
正文為request和response對象的樹狀數據結構,在這個tree中我只展示了public方法,私有方法并未列出,希望Node開發者在閱讀本文時有所甄別。
這篇文章的受眾是有Node開發經驗的讀者。
request對象
request
對象實現了Readable Stream的接口
|- IncomingMessage
|- |- client
|- |- socket (客戶端和server的request socket)
|- |- connection
|- |
|- |- headers
|- |- |- accept:'*/*'
|- |- |- host:'localhost:7000'
|- |- |- user-agent:'curl/7.43.0'
|- |
|- |- httpVersion:"1.1"
|- |
|- |- upgrade: false
|- |- url:"/"
|- |
|- |- |- 原型鏈 Readable
|- |- |-
|- |- |- constructor: Readable(options)
|- |- |- destroy(error)
|- |- |- read(n)
|- |- |- setTimeout(msecs, callback)
|- |- |
|- |- |- |- 原型鏈 Stream
|- |- |- |- addListener(event,fn)
|- |- |- |- on(event,fn)
|- |- |- |- pipe(dest, pipeOpts)
|- |- |- |- pause()
|- |- |- |- push(chunk, encoding)
|- |- |- |- read(n)
|- |- |- |- resume()
|- |- |- |- setEncoding(enc)
|- |- |- |- unpipe(dest)
|- |- |- |- unshift(chunk)
|- |- |- |- wrap(stream)
|- |- |- |
|- |- |- |- 原型鏈 EventEmitter
|- |- |- |- |- addListener(event,fn)
|- |- |- |- |- on(type, listener)
|- |- |- |- |- once(type, listener)
|- |- |- |- |- emit(type)
|- |- |- |- |- getMaxListners()
|- |- |- |- |- listenerCount(type)
|- |- |- |- |- listeners(type)
|- |- |- |- |- prependListener(type,listener)
|- |- |- |- |- prependOnceListener(type,listener)
|- |- |- |- |- removeAllListeners(type)
|- |- |- |- |- removeListener(type,listener)
|- |- |- |- |- setMaxListener(n)
response
response對象實現了Writable Stream的接口,但它并未繼承Writable Stream
|- ServerResponse
|- |- socket (客戶端和server的request socket)
|- |- connection
|- |
|- |- _headers:null
|- |
|- |- chunkEncoding:false
|- |
|- |- upgrading: false
|- |
|- |- useChunkedEncodingByDefault:true
|- |
|- |- writable:true
|- |
|- |- |- 原型鏈 OutgoingMessage
|- |- |
|- |- |- constructor: OutgoingMessage
|- |- |- writeHead(statusCode,reason,obj)
|- |- |- writeHeader()
|- |- |- writeContinue(cb)
|- |- |- statusCode:200
|- |- |- statusMessage:undefined
|- |- |- writeContinue(cb)
|- |- |
|- |- |- writeAble Stream的接口實現
|- |- |- |- addTrailers(headers)
|- |- |- |- destroy(error)
|- |- |- |- end(data, encoding, callback)
|- |- |- |- write(chunk, encoding, callback)
|- |- |- |- flush()
|- |- |- |- flushHeaders()
|- |- |- |- headerSent
|- |- |- |- removeHeader(name)
|- |- |- |- setHeader(name,value)
|- |- |- |- setTimeout(msecs, callback)
|- |- |- |- pipe(dest,options)
|- |- |- |
|- |- |- |- 原型鏈 EventEmitter
|- |- |- |- |- addListener(event,fn)
|- |- |- |- |- on(type, listener)
|- |- |- |- |- once(type, listener)
|- |- |- |- |- emit(type)
|- |- |- |- |- getMaxListners()
|- |- |- |- |- listenerCount(type)
|- |- |- |- |- listeners(type)
|- |- |- |- |- prependListener(type,listener)
|- |- |- |- |- prependOnceListener(type,listener)
|- |- |- |- |- removeAllListeners(type)
|- |- |- |- |- removeListener(type,listener)
|- |- |- |- |- setMaxListener(n)
結語
如上列出的數據結構即為request和response的依賴繼承關系,開發者可以對照這個數據結構表調用對應的方法構建你的Node.js應用。