如何使用nodejs写一个接口

写前端的朋友不知道如何拓展自己在后端的能力,那么nodejs是你的不二选择,废话不多说,直接进入正题。

    这里我演示的是nodejs+mysql,别的数据库也类似。

    首先我们需要做两件事,下载nodejs和mysql安装,这些基本知识略过。

    接着新建一个文件夹,在此文件夹下打开cms,或者vscode的终端,输入node init初始化一个项目,输入一些基本信息。

    然后我们我们还需要安装以下包到–save下

《如何使用nodejs写一个接口》

express和mysql这两个包是最主要的,稍后再讲其他包的作用。

在这里我要阐明一个事实,这里的mysql是操作mysql数据库的一个js插件,并不是数据库软件,npm下载的包都是一些js的插件包。

好了,接下来和我一步步向下操作就可以了。

在文件夹下新建一个index.js文件,当然别的名字也可以,这个文件是你整个程序的入口。

键入以下代码:

《如何使用nodejs写一个接口》

80代表的是你的端口号,然后在终端或者cms输入node index.js,在浏览器里打开localhost就可以看到了,或者127.0.0.1也行,如果是别的端口号需要加上端口号,当然现在是什么也没有,因为我们还没有写接口。

接下来我们写一个get接口,返回一个‘hello world’字符串

《如何使用nodejs写一个接口》

res.json这个方法是以json对象的形式返回去,还有以下方法

res.send以页面的方式返回去

res.download以文件的方式返回去,前端请求会下载此文件

别的方法这里就不在一一阐明了,可以打出res.然后使用vscode的语法提醒查看下面的方法即可,或者查看文档看解释。

《如何使用nodejs写一个接口》

接下来我们返回一个页面:

《如何使用nodejs写一个接口》

可以看到localhost页面上出现了我们预期的结果

《如何使用nodejs写一个接口》

到了这里想必你们已经发现问题了,我每次改动一下都要重新跑程序,这不符合人体工程学,说的一点没错,我无法容忍,你萌呢?

想必你们在前面也发现了pageage.json里有这么一句话

《如何使用nodejs写一个接口》

scripts的作用就是自己定义脚本命令,在这下面定义的所有命令都可以使用npm run xxx来运行,可以省略run。里面运行的应该是node index.js才对,但是这里我们使用了一个插件,hotnode,这个插件可以让你的node程序热更新,要全局安装这个插件,不然找不到命令。

npm install -g hotnode

然后我们就可以npm start运行我们的程序了,所有基于node的程序跑起来都是两步,npm install,安装所有插件,npm start运行程序,如果跑不起来,那么这个项目一定不是一个好项目,我通常如此告诫我的弟子,我们一定要站在巨人的肩上。

做到这里,我们接下来就可以愉快的开发了。

接下来我们试试post方法

《如何使用nodejs写一个接口》

post不支持浏览器直接访问,这个时候要用postman软件

《如何使用nodejs写一个接口》

依然符合我们的预期。

可以把路径改为/login,/test进行尝试,这里就不再演示了。

也可以试试app.all方法,这个方法支持所有请求方式,不必每个请求都写好几遍了。

想必大家已经想到了,我要做登录拦截难道每个接口里都要写一遍吗。

答案是当然不用的,接口的第一个参数可以用正则表达,我们这么写:

《如何使用nodejs写一个接口》

我们使用*来匹配所有路径,这个时候请求test,会先经过*,被*拦截返回了***,

我们可以在内部判断来进行操作:

《如何使用nodejs写一个接口》

如果未登录,返回未登录,否则,继续向下匹配,回调函数接收三个参数,最后一个是next,继续向下执行,*路径一定要写在最上面,不然会先被test捕捉到,test没有执行next,*就会捕捉不到请求。

这时候就可以设置login的值来看路径localhost/test下的返回值了。

那么有参数的情况呢,我们先引入一下中间件,如果没有安装可以先npm安装

《如何使用nodejs写一个接口》

接下来我们请求一下

《如何使用nodejs写一个接口》

?后面的表单参数会放到req.query里,路径上的参数会放到req.params里,json参数会放到req.body里,可以任意选择一种参数传递即可,路径以:开头表示此路径作为参数的意思。

前后端联调的时候经常碰到跨域的问题,我们可以使用cors插件解决,

《如何使用nodejs写一个接口》

以上提到的跨域和参数都可以自己进行处理,利用路径自己提取参数,在*路径的请求的请求体req里自己加上跨域允许的header,但我希望你们可以使用插件,保证代码的简洁性,同时

我经常告诉我的弟子,我们一定要站在巨人的肩上。

好了,接下来我们开始连接数据库,从数据库里拿一条数据出来返回给前端。

引入mysql插件,我们先在mysql里新建一个表students,存入以下数据:

《如何使用nodejs写一个接口》

然后使用mysql插件连接数据库

《如何使用nodejs写一个接口》

option里都是连接数据库的基本配置,更多参数可以查看文档,我们请求一下localhost/login看看

《如何使用nodejs写一个接口》

真的返回了我们存在数据库的数据,我好激动啊,大业终于完成了。

是的,conn.query就是执行一条sql语句,在回调函数里返回结果。

结果可以用构造函数封装,这样就不用每次都写一推没用的字段了。

如果你在此处这样做:

《如何使用nodejs写一个接口》

那么这个不妥的,第一次没有问题,第二次不行了,说是关闭了数据库无法继续查询,因为connect()并不能重连数据库,你需要重新建立一条新连接,所以不建议使用conn.end()断开数据库。

如果莫名其妙断了呢,我们就需要就重连机制,断了数据库会触发error事件,我们这样处理:

《如何使用nodejs写一个接口》

监听error事件,如果err.code返回了以上字符,那么我们就重新发起连接,直到连接成功。

做到这里,想必大家已经想到了,这是单线程的,并发量高的时候会不会顶不住,会的,所以我们要上连接池。

连接池与连接相似,做以下处理:

《如何使用nodejs写一个接口》

建立连接池比连接多了几个参数,这里罗列了常用的三个,其它参数可以查看文档。这个时候我们使用连接池处理请求。conn.release()的意思是释放连接池的意思,用完就要释放给别的请求使用,也可以直接使用连接池,具体区别我还不知道,我猜应该是直接使用连接池就是这个线程专门为这个请求服务,不用别的也不释放,可以用于常用接口,可以减少取连接池的操作。

做到这里我们大部分工作已经做完了,想必大家一定又想到了什么,我如果有一千个接口,难道要在一个文件里写一千个吗。

这当然是不妥的,比较难维护,所以我们要拆分模块,使用express.Router()这个api。

我们将连接数据库的文件单独抽离

《如何使用nodejs写一个接口》

导出常用的pool,Result,router,app模块,然后在子模块:

《如何使用nodejs写一个接口》

然后在入口:

《如何使用nodejs写一个接口》

看看是不是简洁多了,要注意一点,引入的子模块要放到全局监听*的下面,不然又会无法匹配到*,app.use的第一个参数代表下发到那个目录,内部子模块的/相当于app.use的第一个参数,接下来请求一下/和/login试试吧。

资源附上

我完事儿了,你萌呢?

    原文作者:大帅瓜
    原文地址: https://www.jianshu.com/p/5f5050257f2e
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞