NodeJs简明教程(3)

2019年7月19日 · 304 字 · 2 分钟

本文是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服务器示例:

新建index.js

编码

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'))

打开终端或者控制台，执行 node index.js，终端或控制台会输出listen on 8080，此时HTTP服务器已经启动，如果启动失败，可以在下方留言

打开浏览器访问 http://localhost:8080，笔者输出如下：

{
    "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",
}

代码说明

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

req对象

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

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

res对象

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

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

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

请求路由

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

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'));

执行node index.js
浏览器访问 http://localhost:8080/ 会输出index
浏览器访问 http://localhost:8080/user 会输出user

读取请求参数

读取GET请求参数

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'));

执行node index.js
浏览器访问 http://localhost:8080/?a=x&b=2&c[]=1&c[]=2

显示

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

读取请求体参数

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

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'));

执行node index.js
使用 postman 发出POST请求http://localhost:8080，本例POST请求体为 a=1&b=2
postman会返回 a=1&b=2

结语

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

NodeJs简明教程(4) NodeJs简明教程(2)