NodeJs简明教程(3)

本文是NodeJs简明教程的第三篇,将介绍NodeJs自带HTTP模块服务器相关的基本操作。

HTTP模块介绍

以下是官方原文[1]:

The HTTP interfaces in Node.js are designed to support many features of the protocol which have been traditionally difficult to use. In particular, large, possibly chunk-encoded, messages. The interface is careful to never buffer entire requests or responses — the user is able to stream data.

大致意思就是:

NodeJs的HTTP模块旨在支持传统上HTTP协议难以使用的许多功能,让这些功能或者特性能够使用简单的API进行调用。

HTTP模块服务器开发

代码示例

以下是NodeJs最简单的HTTP服务器示例:

  1. 新建index.js
  2. 编码

    1
    2
    3
    4
    5
    6
    7
    8
    const http = require('http');

    const server = http.createServer((req, res) => {
    console.log('%s %s', req.method, req.url)
    res.end(JSON.stringify(req.headers))
    })

    server.listen(8080, () => console.log('listen on 8080'))
  3. 打开终端或者控制台,执行 node index.js,终端或控制台会输出listen on 8080,此时HTTP服务器已经启动,如果启动失败,可以在下方留言

  4. 打开浏览器访问 http://localhost:8080,笔者输出如下:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    {
    "host": "localhost:8080",
    "connection": "keep-alive",
    "cache-control": "max-age=0",
    "upgrade-insecure-requests": "1",
    "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36",
    "dnt": "1",
    "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
    "accept-encoding": "gzip, deflate, br",
    "accept-language": "zh-CN,zh;q=0.9,en;q=0.8,zh-TW;q=0.7",
    }

代码说明

  1. NodeJs采用 CommonJs模块系统require 用来加载模块,本例中加载了NodeJs自带的http模块以使用其中的功能
  2. http.createServer函数创建了一个 HTTP服务器,并配置了请求回调函数,在本系列的第一篇文章中说到事件驱动是需要回调函数进行监听的。
  3. server.listen是监听系统端口,第二个参数是监听成功的回调函数

req对象

服务器收到的HTTP请求对象,以下是常用的属性或方法:

  1. req.url 本次请求的路径(不包含域名)
  2. req.headers 本次请求的请求头
  3. req.httpVersion 本次请求的HTTP协议版本号
  4. req.method 本次请求的请求方法,有GET/POST/PUT等等
  5. on() 监听请求体数据 POST/PUT/PATCH方法会有请求体

res对象

res对象是req请求对象相应的响应对象,HTTP协议设计是请求-应答模型,一次请求对应一次应答。

以下是常用的属性或方法:

  1. res.writeHead 输出响应状态码状态码说明以及多个HTTP响应头
  2. res.end 输出数据并结束本次响应
  3. res.write 输出部分内容(chunk)
  4. res.setHeader 输出单个响应头

请求路由

NodeJs自带的HTTP服务器是没有路由功能的,也是就说,根据请求的URI来执行不同的逻辑需要开发者手动去做

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const http = require('http');

const server = http.createServer((req, res) => {
if (req.url === '/') {
res.end('index');
return;
}
if (req.url === '/user') {
res.end('user');
return;
}
})

server.listen(8080, () => console.log('listen on 8080'));
  1. 执行node index.js
  2. 浏览器访问 http://localhost:8080/ 会输出index
  3. 浏览器访问 http://localhost:8080/user 会输出user

读取请求参数

读取GET请求参数

1
2
3
4
5
6
7
8
9
10
11
const http = require('http');
const url = require('url');
const qs = require('querystring');

const server = http.createServer((req, res) => {
const parsed = url.parse(req.url);
const query = qs.parse(parsed.query);
res.end(JSON.stringify(query));
})

server.listen(8080, () => console.log('listen on 8080'));
  1. 执行node index.js
  2. 浏览器访问 http://localhost:8080/?a=x&b=2&c[]=1&c[]=2
  3. 显示

    1
    2
    3
    4
    5
    {
    "a": "x",
    "b": "2",
    "c[]": ["1", "2"]
    }

读取请求体参数

HTTP协议规范中POST/PUT/PATCH都可以携带请求体,NodeJs HTTP服务器接收请求体代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
const http = require('http');
const url = require('url');
const qs = require('querystring');

const server = http.createServer((req, res) => {
let data = Buffer.alloc(0);
req.on('data', (buffer) => {
data = Buffer.concat([data, buffer]);
})
req.on('end', () => {
res.end(data.toString())
})
})

server.listen(8080, () => console.log('listen on 8080'));
  1. 执行node index.js
  2. 使用 postman 发出POST请求http://localhost:8080,本例POST请求体为 a=1&b=2
  3. postman会返回 a=1&b=2

结语

一个简单的HTTP服务器就到此结束了,当然,实际生产中该方法用的比较少,几乎都是使用框架进行开发,提高开发效率。

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×