node写一个接口全过程

作者: 零星小雨_c84a | 来源:发表于2019-01-31 14:07 被阅读536次

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

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

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

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

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

    image

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

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

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

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

    键入以下代码:

    image

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

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

    image

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

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

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

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

    image

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

    image

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

    image

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

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

    image

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

    npm install -g hotnode

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

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

    接下来我们试试post方法

    image

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

    image

    依然符合我们的预期。

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

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

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

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

    image

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

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

    image

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

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

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

    image

    接下来我们请求一下

    image

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

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

    image

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

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

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

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

    image

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

    image

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

    image

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

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

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

    如果你在此处这样做:

    image

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

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

    image

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

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

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

    image

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

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

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

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

    image

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

    image

    然后在入口:

    image

    看看是不是简洁多了,要注意一点,引入的子模块要放到全局监听的下面,不然又会无法匹配到,app.use的第一个参数代表下发到那个目录,内部子模块的/相当于app.use的第一个参数,express()和express.Router()的区别是,router比较小,可以作为中间件。接下来请求一下/和/login试试吧。

    资源附上

    相关文章

      网友评论

        本文标题:node写一个接口全过程

        本文链接:https://www.haomeiwen.com/subject/ukiksqtx.html