Node.js 系列 - 搭建 "Hello World" HTTP 服务器

做为还在漫漫前端学习路上的一位自学者。我以学习分享的方式来整理本身对于知识的理解，同时也但愿可以给你们做为一份参考。但愿可以和你们共同进步，若有任何纰漏的话，但愿你们多多指正。感谢万分！

---

在这一节, 我会先介绍 "客户端" 和 "服务器" 的概念.

而后我会简单介绍一下 "HTTP 协议".

最后, 咱们要试着搭建一个最简易的 HTTP 服务器. 当浏览器去向这个服务器发送请求的时候, 服务器会返回 "Hello World" 文本.

客户端 & 服务器

先思考, 平时咱们在浏览器地址栏中, 输入网址按下回车以后, 网页是如何呈如今咱们面前的?

很显然, 咱们想要访问的网页不是本来就保存在咱们的电脑里的. 咱们在浏览器中输入网址, 去网页文件所在的网络设备中去请求网页. 拥有网页的网络设别赞成了咱们的请求, 把网页返回给了浏览器. 以后浏览器再解析渲染网页文件, 使网页最终能呈如今咱们面前.

像浏览器这样, 请求访问文本或图像等资源的一端称为客户端，而提供资源响应的一端称为服务端。

什么是 HTTP 协议

MDN HTTP 文档

客户端和服务器之间是怎么交流信息, 传递数据的呢? 

网络之间的各类网络设备, 就像 "学校里说不一样方言的同窗", 你们想要交流就必须使用 "普通话". 各类网络设别之间想要通讯也须要一套你们都承认的通讯标准.

HTTP 协议 (Hyper Text Transfer Protocol 超文本传输协议）就是 服务器 和 客户端 之间的通讯规则.

在应用 HTTP 协议时，一定是一端担任客户端角色，另外一端担任服务器端角色

使用 HTTP 协议传输的信息叫作 HTTP 报文. 请求端（客户端）的 HTTP 报文叫作请求报文，响应端（服务器端）的叫作响应报文。 HTTP 报文可分为 报文首部 和 报文主体 两块, 中间由一个空行分开.

请求报文 & 响应报文

『 请求报文组成 』: 请求方法 + 请求 URI + HTTP 协议版本 + (可选的请求首部字段 和 内容实体)

『 响应报文组成 』: HTTP 协议版本 + 状态码（表示请求成功或失败的数字代码）+ 用以解释状态码的缘由短语 + (可选的响应首部字段 以及 实体主体)

『 请求方法 』:

MDN - HTTP 请求方法 文档

HTTP 定义了一组请求方法, 以代表要对给定资源执行的操做。

经常使用的有:

• GET: 用来请求服务器端指定的资源。使用 GET 的请求应该只用于获取数据。
• POST: 用来发送数据给服务器. 虽然用 GET 方法也能够传输主体. 但通常不用 GET 方法进行传输，而是用 POST 方法。
• PUT: 用于新增资源. PUT 与 POST 方法的区别在于，PUT 方法调用一次与连续调用屡次是等价的，而连续调用屡次 POST 方法可能会有反作用，好比将一个订单重复提交屡次。
• DELETE: 用于删除指定的资源。

除上面这些以外, 还有其余请求方法, 想了解能够自行查阅文档.

『 URI 』:

HTTP 协议使用 URI 定位互联网上的资源。也就是咱们常说的 "网址". 多数状况下 URL 和 URI 说的是一回事. 这里不作过多论述.

下图是 URI 的各个组成部分

『 状态码 』:

MDN - HTTP 状态码 - 文档

状态码的职责是当客户端向服务器端发送请求时，描述服务器返回的请求结果。

借助状态码，用户能够知道服务器端是正常处理了请求，仍是出现了错误。

状态码由 3 位数字 和 缘由短语 组成。

数字中的第一位指定了响应类别，后两位无分类。响应类别有如下 5 种:

最多见的两个就是:

• 200 OK: 表示从客户端发来的请求在服务器端被正常处理了。
• 404 Not Found: 该状态码代表服务器上没法找到请求的资源。除此以外，也能够在服务器端拒绝请求且不想说明理由时使用。

其他的状态码, 你们能够查阅文档, 这里就不介绍了.

『 首部字段 』:

MDN - HTTP 首部字段 - 文档

首部字段, 为客户端和服务器, 处理请求和响应, 提供了所须要的信息。

HTTP 首部字段是由 首部字段名 和 字段值 构成的，中间用 : 分隔。

例如:

在 HTTP 首部中以 Content-Type 这个字段来表示报文主体的类型。 Content-Type: text/html 就是说, 报文主体的类型为 HTML.

更多首部字段我就再也不这里介绍了, 你们能够根据须要查阅文档.

使用 HTTP 模块 实现一个 "Hello World" 服务器

HTTP 模块 - 文档

Node.js 自身提供的 http 模块, 提供了 HTTP 服务器和客户端接口, 能够很便捷地应用 HTTP 协议.

下面我就介绍如何用 http 模块实现一个响应 "Hello World" 给客户端的 Web 服务器:

首先, 新建一个 JavaScript 文件, 取名 myServer.js , 固然你能够叫别的.

在文件开头先引用 http 模块.

var http = require('http');
复制代码

而后调用 http.createServer 函数建立并返回一个 HTTP 服务器. 这个函数接收一个回调函数做为参数. 服务器每次收到客户端发过来的 HTTP 请求会交给这个回调函数处理. 回调函数会受到两个参数, "请求对象" 和 "响应对象", 通常简写为 req 和 res.

var server = http.createServer(function(req, res) {
    // 处理请求, 送出响应
});
复制代码

服务器每次收到新的请求, 都会建立新的请求对象和响应对象. 从客户端发过来的请求报文会被解析, 而后做为请求对象的一部分. 在回调函数的内部, 你须要根据业务逻辑处理请求, 而后送出响应给客户端, 结束这次请求.

在本练习中, 咱们要返回给客户端一个写有 "Hello World" 的纯文本. 在回调函数中咱们须要用到三个响应对象上的函数:

• res.writeHead(statusCode[, statusMessage][, headers]): 该方法会发送一个响应头给客户端. 第一个参数做为状态码, 最后一个参数 headers 是响应头对象。 第二个参数 statusMessage 是可选的状态描述。
• res.write(chunk[, encoding][, callback]): 该方法会发送一块响应主体。 它可被屡次调用，以便提供连续的响应主体片断。第一个参数是一个字符串或一个 Buffer 字节流, 若是是字符串的话, 第二个参数指定如何将它编码成一个字节流 (默认为 utf-8). 最后一个参数这里先不考虑.
• res.end([data][, encoding][, callback]): 该方法会通知服务器，全部响应头和响应主体都已被发送，即服务器将其视为已完成。每次响应都必须调用这个方法来结束请求, 不然请求会被一直挂起. 若是传入 data 参数, 至关于调用 res.write(data, encoding).

那么根据需求咱们知道:

• 响应成功, 状态码为 200.
• 响应回去的为纯文本, 须要设定响应头 Content-Type 的值为 text/plain.
• 响应回去的主体是一个字符串 "Hello World".

根据这两个信息, 咱们就能够很轻松的写出请求处理函数内的代码:

var server = http.createServer(function(req, res) {
    res.writeHead(200, {'Content-Type':'text/plain'});
    res.write("Hello World");
    res.end();
});
复制代码

最后, 咱们须要给 Web 服务器绑定一个端口. 为了让服务器能够提供多种服务, 不一样请求会被发送到不一样的端口. 只有发送到咱们指定端口的 HTTP 请求会被上面的代码所处理.

咱们使用 server.listen 函数, 第一个参数为端口号, 最后一个参数是一个回调函数, 监听成功后调用.

在这里我用 3000 做为端口号, 固然你也能够改为你喜欢的.

server.listen(3000, function() {
    console.log("服务器启动成功!");
    console.log("正在监听 3000 端口:");
});
复制代码

所有写完后代码为:

var http = require('http');

var server = http.createServer(function(req, res) {
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    res.write("Hello World");
    res.end();
});

server.listen(3000, function() {
    console.log("服务器启动成功!");
    console.log("正在监听 3000 端口:");
});
复制代码

在命令行中输入 node myServer.js ( 注意你的路径和文件名 )

服务器运行后, 能够在命令行看见

而后在浏览器中登陆 localhost:3000, 你就能够看见服务器响应给你的 "Hello World" 了.

如今你成功的返回了一条纯文本内容给客户端. 接下来, 你能够试着返回一个 HTML 文本吗?

Tip: Content-Type 的值应改为什么?

---

😆 好啦，今天的分享就告一段落啦。下一篇中，我会介绍如何实现一个 "HTTP 静态文件服务器"。

传送门 - Node.js 系列 - 搭建静态资源服务器

若是喜欢的话就点个关注吧！O(∩_∩)O 谢谢各位的支持❗️