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字符串数据。

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

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

相关推荐
小陈工1 小时前
Python安全编程实践:常见漏洞与防护措施
运维·开发语言·人工智能·python·安全·django·开源
刚入门的大一新生4 小时前
Linux-Linux的基础指令4
linux·运维·服务器
majingming1236 小时前
FUNCTION
java·前端·javascript
zopple6 小时前
常见的 Spring 项目目录结构
java·后端·spring
腾讯蓝鲸智云7 小时前
嘉为蓝鲸可观测系列产品入选Gartner《中国智能IT监控与日志分析工具市场指南》
运维·人工智能·信息可视化·自动化
A_nanda7 小时前
Vue项目升级
前端·vue3·vue2
SuperEugene7 小时前
Axios 接口请求规范实战:请求参数 / 响应处理 / 异常兜底,避坑中后台 API 调用混乱|API 与异步请求规范篇
开发语言·前端·javascript·vue.js·前端框架·axios
abigale038 小时前
【浏览器 API / 网络请求 / 文件处理】前端文件上传全流程:从基础上传到断点续传
前端·typescript·文件上传·vue cli
子兮曰8 小时前
Bun v1.3.11 官方更新全整理:新增功能、关键修复与升级验证
javascript·node.js·bun
Setsuna_F_Seiei8 小时前
AI 对话应用之页面滚动交互的实现
前端·javascript·ai编程