前言
这篇文章我们将会学习 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]) |
发送响应体 |
ata[, 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 客户端用于发送 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()
文章知识点与官方知识档案匹配,可进一步学习相关知识