Node.js全栈指南:接口服务器

上一篇文章静态资源服务器,我们通过mime-types,将原本繁琐的文件类型判断和MIME值对应处理地更为健壮,扩展性更强。已经基本解决了各种静态资源的请求和读取问题。

那么这一章呢,我们来实现一个:接口服务器。

回想一下,前后端功能对接,是不是后端提供接口地址,然后前端带上参数请求该地址,拿到返回的数据,并把数据渲染到页面上的呢。

要实现接口的话,其实也非常简单,可以说简单地不像话。请求接口和请求静态资源文件没有什么太大的区别。一个是读取并返回文件,一个则是返回JSON数据。

为了将资源请求和接口请求进行区分,便于我们判断。

我们规定,所有的接口请求都必须以/api/为前缀。

凡是请求地址的前缀为/api/的,则进入接口相关的处理逻辑,否则就是资源相关的处理逻辑。

那么,我们也设计一个接口,完整路径是/api/getUserScore,功能是获取用户分数。

当我们的服务器匹配到这个请求路径的时候,就返回对应的JSON数据。

服务器启动后,我们在浏览器发起请求。

但是,不光浏览器没拿到数据,连我们的后端程序都崩了。

js 复制代码
TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received an instance of Object

报错内容是这样的,我们分成几段来看。

什么错误呢?TypeError。

Type=类型,Error=错误,对了,是类型错误。

什么样的类型错误呢?ERR_INVALID_ARG_TYPE

ERR=错误

INVALID=无效的

ARG=参数

TYPE=类型

连起来就是,无效的参数类型。

哪个地方出的错呢?D:/codes/nodeFullStack/api/index.js:11:17

index.js文件的第11行,这里有个什么函数?res.send()。

哦,我明白了,res.send()的参数类型错了。

可我们明明给的是JSON对象啊,这个JSON对象又没错。

咱们继续往后看。

js 复制代码
The "chunk" argument must be of type string or an instance of Buffer or Uint8Array.

The "chunk"就是我们要给res.send提供的参数,它的中文含义叫做"块",就是一块一块的,一份一份的意思。

也就是说,我们提供给res.send()函数的参数,要一块一块的,一份一份的。

那么什么样的类型,是一块块,一份份的呢?

继续看后面的文字,翻译过来就是"参数必须是字符串类型,或者是Buffer,Uint8Array的实例"。

Buffer和Unit8Array看不懂不要紧,一两句话也说不清,购买了本小册的话,可以私聊加我微信chensuiyime到问答群交流提问。

那么这个字符串类型,肯定明白吧,问题找到了:JSON结构不是字符串类型。

那么如何将JSON结构变成字符串呢,很简单:JSON.stringify来帮忙。

这么一操作,我们就能拿到接口的返回数据了。

但,问题又来了,怎么乱码了?

很简单,还记得前面章节,如何解决乱码问题的吗?

如果忘记了,请看第二章从一个简单的例子开始。

那么我们的解决方法如下:

设置返回头的Content-Type属性的值为application/json; charset=utf-8。

这就等于告诉浏览器:嘿,听好了,我要返回的数据是JSON结构,用UTF-8编码显示,可别整乱码了。

这么一来,数据显示就正常了。

也可以看到,我们设置的头部Content-Type属性也生效了。不管在浏览器页面中还是开发面板中,都用更容易查看的JSON缩进格式来显示了。

那么到了这一步,我们的接口服务器,就算完成了。

what?这就完成了?

没错,完成了。

如果需要增加新的接口,那么增加不同的接口判断就行了。

后续章节,我们会逐步完成接口的功能,比如读取数据库,实现登录注册等等。

但是,这些都是对接口功能的完善,本质上来说,所谓的后端接口,就是判断不同的接口请求,返回不同的数据而已。我们所想象的全栈开发,接口开发好难好难啊,其实远远没有想象中那么难。

那么我们再回过头思考前面的一个问题,为什么接口不能返回JSON结构?三秒中思考一下。

OK,这是因为,结构是一个抽象的东西。

你不仅不能返回JSON结构,也不能返回Array数组。

浏览器和服务器之间的数据交换,交换的是数据,而不是结构。

我们的上一章静态资源服务器,读取各种文件并进行返回,也不是返回结构,而是不同文件的具体数据。

图片有图片的数据,文件有文件的数据,这是实实在在的数据,而不是抽象的结构。

所以呢,我们才需要用到JSON.stringify方法,来把JSON结构变成JSON字符串数据。

本章非常重要,理解清楚,可以有效地解决对于全栈开发,接口开发的未知和恐惧,其实也就那样。

那么后续呢,我们进一步完善我们的接口服务器,让其更健壮,更方便,为我们即将到来的实战:个人博客全栈项目开发,打下基础。

相关推荐
Carlos_sam42 分钟前
OpenLayers:封装一个自定义罗盘控件
前端·javascript
前端南玖1 小时前
深入Vue3响应式:手写实现reactive与ref
前端·javascript·vue.js
wordbaby1 小时前
React Router 双重加载器机制:服务端 loader 与客户端 clientLoader 完整解析
前端·react.js
itslife1 小时前
Fiber 架构
前端·react.js
郑道1 小时前
Docker 在 macOS 下的安装与 Gitea 部署经验总结
后端
3Katrina1 小时前
妈妈再也不用担心我的课设了---Vibe Coding帮你实现期末课设!
前端·后端·设计
hubber1 小时前
一次 SPA 架构下的性能优化实践
前端
汪子熙1 小时前
HSQLDB 数据库锁获取失败深度解析
数据库·后端
高松燈2 小时前
若伊项目学习 后端分页源码分析
后端·架构
可乐只喝可乐2 小时前
从0到1构建一个Agent智能体
前端·typescript·agent