Node.js学习笔记(五) http模块

这篇文章我们将会学习 Node 的内置模块 http，http 模块主要用于 搭建 HTTP 服务端和客户端

1、http 服务端

（1）创建服务

http 服务端通过 http.Server 实现，我们可以通过以下两种方法创建一个 http.Server

const http = require('http')
// 方法一
var server = new http.Server()
// 方法二
var server = http.createServer()

（2）绑定事件

http.Server 是一个 基于事件 的服务器，我们需要为不同的事件指定相应的处理函数，即可完成功能

最常用的事件莫过于 request，当服务器获取到请求时，就会触发该事件

事件处理函数接收两个参数，分别对应 http.IncomingMessage 和 http.ServerResponse

server.on('request', function(message, response) {
    console.log(message instanceof http.IncomingMessage) // true
    console.log(response instanceof http.ServerResponse) // true
    console.log('收到请求')
})

（3）属性方法

http.Server 还有一些常用的属性和方法，介绍如下：

  • listen()：监听连接
  • close()：关闭连接
  • setTimeout()：设置超时时间
  • listening：是否正在监听连接
  • maxHeadersCount：传入的最大报头数，默认为 2000
  • timeout：套接字超时前的等待时间，默认为 0 ms
  • headersTimeout：接收到完整报头前的等待时间，默认为 60000 ms
  • keepAliveTimeout：在写入最后一个响应之后且在套接字销毁之前的等待时间，默认为 5000 ms
server.listen(8888, '127.0.0.1', function() {
    console.log('server running at http://127.0.0.1:8888')
})

（4）http.IncomingMessage 和 http.ServerResponse

http.IncomingMessage 表示接收到的数据对象，常用的属性和方法如下：

属性和方法 描述
aborted 请求是否已经终止
complete 是否已接收到完整信息并成功解析
rawHeaders 原始请求头列表
headers 请求头对象
url URL 字符串
httpVersion HTTP 版本
method 请求方法
statusCode 状态代码
statusMessage 状态信息

http.ServerResponse 表示要发送的响应对象，常用的属性和方法如下：

属性和方法 描述
hasHeader(name) 是否具有特定的响应头
getHeader(name) 获取指定的响应头
getHeaders() 获取所有响应头
getHeaderNames() 获取所有响应头的名称
setHeader(name, value) 设置响应头
removeHeader(name) 删除响应头
setTimeout(msecs[, callback]) 设置超时时间
writeHead(statusCode[, statusMessage][, headers]) 发送响应头
write(chunk[, encoding][, callback]) 发送响应体
end([data[, encoding]][, callback]) 所有数据已经发送完毕
headersSent 是否已经发送响应头
statusCode 状态代码，默认为 200
statusMessage 状态信息，默认使用状态代码的标准信息

（5）一个完整的例子

// server.js
const http = require('http')
const path = require('path')
const fs = require('fs')
const server = http.createServer()
server.on('request', function(message, response) {
    let url = message.url
    if (url === '/') url = '/index.html'
    fs.readFile(path.join(__dirname, url), function(error, data) {
        if (error) {
            response.writeHead(404, {'Content-Type': 'plain/html'})
        }
        else {
            response.writeHead(200, {'Content-Type': 'text/html'})
            response.write(data)
        }
        response.end()
    })
})
server.listen(8888, '127.0.0.1', function() {
    console.log('server running at http://127.0.0.1:8888')
})

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Index</title>
</head>
<body>
    <p>Index Page</p>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>About</title>
</head>
<body>
    <p>About Page</p>
</body>
</html>

2、http 客户端

（1）创建服务

http 客户端用于发送 HTTP 请求，它是基于 http.request 实现的，创建方法的签名如下：

http.request(options[, callback])
http.request(url[, options][, callback])
  • url：请求地址，类型为 string 或 URL
  • options：请求参数，类型为 object，常用的属性如下：
    • headers<object>：请求头
    • maxHeaderSize<number>：请求头的最大长度，默认为 8192 Bytes
    • method<string>：请求方法，默认为 GET
    • protocol<string>：网络协议，默认为 http:
    • host<string>：请求的域名或者 IP 地址，默认为 localhost
    • hostname<string>：host 的别名，并且 hostname 的优先级高于 host
    • port<number>：请求端口，默认如果有设置 defaultPort，则为 defaultPort，否则为 80
    • path<string>：请求路径，默认为 /
    • timeout<number>：超时时间
  • callback：回调函数
const http = require('http')
let url = 'http://127.0.0.1:8888/index.html'
let request = http.request(url)

http.request 方法返回 http.ClientRequest 对象

（2）绑定事件

http.ClientRequest 对象也是基于事件的，常用的事件如下：

  • 如果请求发送成功，那么依次触发以下事件：socket -> response(data -> end) -> close
  • 如果请求发送失败，那么依次触发以下事件：socket -> error -> close
request.on('response', function(message) {
    console.log(message instanceof http.IncomingMessage) // true
    console.log('收到响应')
})
request.on('error', function(error) {
    console.log(error instanceof Error) // true
    console.log('发生错误')
})

（3）属性方法

http.ClientRequest 对象常用的属性和方法如下：

  • abort()：标志请求被终止
  • getHeader(name)：获取请求头
  • setHeader(name, value)：设置请求头
  • removeHeader(name)：删除请求头
  • setTimeout(timeout[, callback])：设置超时时间
  • write(chunk[, encoding][, callback])：发送请求体
  • end([data[, encoding]][, callback])：所有数据已经发送完毕
// 发送数据
const querystring = require('querystring')
request.write(querystring.stringify({
    username: 'wsmrzx',
    password: '123456'
}))
// 发送结束标志
request.end()

（4）一个完整的例子

const http = require('http')
let url = 'http://127.0.0.1:8888/index.html'
let request = http.request(url)
request.on('response', function(message) {
    let html = ''
    message.on('data', function(chunk) {
        html += chunk
    })
    message.on('end', function() {
        console.log(html)
    })
})
request.on('error', function(error) {
    console.log(error.message)
})
request.end()

【 阅读更多 Node.js 系列文章，请看 Node.js学习笔记 】

posted @ 2020-01-29 22:25  半虹  阅读(200)  评论(0)  编辑  收藏  举报