Node后端模板代码(附源码)

1,051 阅读9分钟

前言

之前也写过简单的node服务器代码,但不算做事一个工程,这一次因为也需求,就写了这套后端模板。

从git上找的一些node模板,功能是可以实现,但工作流程理解起来有点困难,可能是小弟我水平有限,故搜罗了很多源码,按照自己的理解写了这套模板。基本通道都已经打通,没有做前端页面,只用了一个输入框和一个按钮来请求后端的数据,在控制台打印显示。纯粹是做一个后端开发的代码。

源码放在gitee上面,需要的伙伴可以自行下载一下。里面每行代码都有详细的注释,这里主要是讲解一下代码的工作流程和主要模块的分布。

下载运行

在gitee下载源码到本地,首先确保本地安装了node环境。测试方法为在命令行中输入node -v,如果出现版本号,就代表安装了node环境。

在当前目录下打开cmd命令行,然后输入npm install安装这套项目所需要的依赖库,安装完成后可以发现项目中多了一个node_modules文件夹。

以上及把项目部署完成了,接下来就是运行了,还是在当前目录下面的命令行运行npm start,出现一下带领代码就代表运行成功,然后就不用关闭命令行,让他运行着,就相当于一台服务器一直在本地跑着一样,后面我们就可以开始请求数据了。

> basestationserver@0.0.0 start D:\.project\myself\BaseStationServer
> node ./bin/www

新建项目

如果不想用我的代码,也可以直接新建一个node工程,还是需要你的环境,在指定文件夹目录下面打开cmd命令窗口。

首先全局安装express框架npm install -g express,安装完成好这个框架后,还不能生成项目,得再安装一个express项目生成器(express-generator),运行命令npm install -g express-generator,这一步也是全局安装,之后之后就不需要再次安装这两个东东了。

然后我们在当前指定的目录命令行中运行express projectName,projectName是你自己想要创建的工程名。运行完成后就可以看见一个项目生成了,然后进入到刚刚新建的工程目录下面。打开cmd窗口命令行,输入npm install来安装依赖。至此项目及创建完了。

下面就来运行这个项目,在浏览器中输入localhost:3000,就可以访问到这个node服务器啦。

大功告成!但是你以为完了吗?不,重点在后面。

模块讲解

上面自己生成了自己的项目,但我这里分析的还是以我那套模板代码来进行分析。

|--api   这个文件夹是直接手动生成了,所有的接口代码处理都放在这里面
|--bin   项目的执行文件
	|--www    里面有一个参数,可以手动修改自己想要的端口号,直接更改里面的port后面的3000,因为项目默认是3000端口
|--config  这个文件也是手动创建的,项目写的是数据库的配置信息
|--node_modules   依赖库
|--public    静态的文件都放在这里面,比如一些第三方库啥的
|--routes    路由文件,规定每个URI调用的接口函数
|--utils	手动创建的,封装了一些常用的工具类函数,方便使用
|--views	这里面是视图代码,我没有用到
|--app.js	项目运行的主入口文件
|--package.json	工程的一些配置信息

首先先配置好config项目的数据库配置信息文件,然后utils文件夹下面的一些文件可以直接考过去,都是封装好的,没什么多讲的。views和public文件夹我们暂时用不掉,因为不做网页开发,就只是纯粹搭一个后台。

主要修改的代码在app.js,api文件夹,routes文件夹。

1、API核心代码

首先对api文件夹进行分析讲解。这个文件夹下面创建了hello/test文件夹和baseApi.js。这个js文件主要是对数据库操作的代码进行了封装,可以先不要看,等看完那两个文件夹下面的所有代码后就会发现,这和那些代码都非常的相似,只不过我把他封装了。

在hello文件夹下面,有一个js文件,写了两个函数hello1,hello2,主要功能就是查询数据库里面的数据,然后返回给前端。在最开始需要导入要写库,然后导入自己的数据库配置文件,可以发现,DBConfig前面有一个@符号,这个符号代表的是项目的根目录,从根目录获取到这个文件的信息。这个和Vue有点一样,但这个需要我们自己配置,可以看这篇文章《Node项目使用@代替根目录》来看怎么配置的。

完成这两个函数后,一定要写上下面的代码,把这两个函数导出出去,然后这一部分就完成了。

module.exports = {
    hello1,
    hello2
};

test文件夹下面的testAPI.js文件也是一样的道理,功能主要是进行插入和修改数据库。就不再一一分析了。

然后test文件夹下面还有一个testAPI_2.js文件,这个文件功能和helloAPI.js一样,只不过由几行代码就完成了这些功能,这主要是调用baseAPI.js里面封装好的函数,之后我们开发就省事多了。

后端的函数写好了,下面就来讲解一下怎么给前端请求。

2、路由配置

前端请求后端的数据是通过URL地址来请求的,我们上面写好的函数就是给前端来请求的,只有前端发出了请求,那么后端才会调用某一块代码去执行他。

那么如何设置这个URL呢。首先简单说一下这个URL的组成,像这个项目中的一个接口地址为http://localhost:8000/api/hello/hello1,一般在浏览器了可以不需要输入http://,因为浏览器会自动补全。localhost就是本地的IP地址,当然了也可以换成127.0.0.1,或者查看本机的局域网IP地址,都可以进行访问。端口号我之前把那个3000换成了8000,这是自己配置的,如果是直接生成的项目,就默认3000。然后后面的/api/hello/hello1就是我们自己设置的接口地址了。

这里以routes/hello.js为例,test.js和这个一样,就不讲解了。首先开头引入路由需要的模块。然后把上面写好的函数给他导入进来,这里直接导入文件的路径就可以了。然后设置是get请求还是post请求,以及请求的路径是什么,且这个路径对应哪个函数。最后把这个模块进行导出去,因为我们只是设置了最后一个路径,后面还需要用到这个模块。

//引入模块
var express = require('express');
var hello = express.Router();
//导入写好的函数
var helloApi = require('@/api/hello/helloAPI')
//设置接口路径,这里的post表示的是前端发送的请求必须是post请求,如果是get,那么久不会调用这个函数。当然我们也可以根据需要吧这里的post换成get。然后第一次参数代表的是请求的地址,这个地址是上面http://localhost:8000/api/hello/hello1的最后一个路径hello1,然后对应的函数是hello1这个函数,也就是说,前端如果请求的是hello1这个路径,那么后台调用的就是hello1这个函数。
hello.post('/hello1', helloApi.hello1);
hello.post('/hello2', helloApi.hello2);
//把这个模块导出
module.exports = hello;

3、主入口文件(app.js)

上面讲了如何去设置接口,然后哪个接口调用哪个函数,这倒是我们自己规定好的。我们只需要告诉前端,这个接口是什么,他直接去请求就行了,不用知道后台是如何实现的。

在app.js里面,找到设置路由这一块代码,这个模块就是暴露给前端请求的接口地址了。里面其他详细的代码我就不一样讲解了,我都写了注释,可以一个一个去查看。

//---------------------------设置路由---------------------------
app.use('/api/test', require('./routes/test'));
app.use('/api/hello', require('./routes/hello'));

这里的第一个参数和上面那个意思一样,人为规定好路径,因为代码写的地方都在api文件夹下面,然后每个文件夹给他设置不同的接口地址,都是以文件夹的名字来命名接口的地址的,这样方便我们管理,一看就知道调用那个函数了,到时候报错了也好进行维护。

第二个参数就是导入刚刚的路由文件了,我们在路由文件里面也定义了一个接口地址hello1,在那里面我们设置的是调用那个函数名而在app.js里面设置的是调用那个文件夹,这样一级一级规范方便后期的维护和团队的合作。也就是因为我们在路由文件设置了hello1,所以整个接口的路径地址就为二者的相加啦!/api/hello/hello1,前端只要请求这个地址就可以获得数据了。

4、跨越问题的解决

我们在请求数据的时候,可以回遇到跨域问题,控制台一般会这样的报错误。

Access to XMLHttpRequest at 'http://localhost:8000/api/hello/hello1' from origin 'http://localhost:8000

出现这种问题就说明出现了跨域的问题。跨域,顾名思义就是跨了两个不同的域名,浏览器认为只要ip、端口、协议三个有一个不同就是不同的域,所以就得解决这个问题。在app.js里面新增如下代码,就可以完美解决可以问题了。

//---------------------------设置跨域请求---------------------------
app.all('*', function (req, res, next) {
  res.header("Access-Control-Allow-Origin", "*");
  res.header('Access-Control-Allow-Headers', 'Content-Type, Content-Length, Authorization, Accept, X-Requested-With , yourHeaderFeild');
  res.header("Access-Control-Allow-Methods", "PUT,POST,GET,DELETE,OPTIONS");
  res.header("X-Powered-By", ' 3.2.1')
  res.header("Content-Type", "application/json;charset=utf-8");
  next();
});

请求数据

上面把后端部署好了之后,完美就可以在前端随便写个网页来请求数据了。我在views项目写了一个简单的网页,一个输入框和一个按钮,就可以后端发送请求了。

    $(".btn").on("click",function(){
        //这里输入的是接口的地址,因为其他一样的完美都写了,
        //调用hello1接口,可以在输入框里面写上/hello/hello1
        //调用hello2接口,可以在输入框里面写上/hello/hello2?emp_sex=1,这里带了一个参数,因为后端设置了参数去查询数据库
        var inputText = $('#in').val();
        $.post({
            url: "http://localhost:8000/api"+inputText,
            success: function(res){
                //成功后会返回数据,并在控制台打印
                console.log(res)
            },
            error: function(res){
                console.error("错误",res)
            }
        })
    })

到此,这套模板就分析完了,如果有不懂的伙伴可以下方留言。