五分钟教你用NodeJS手写一个Mock数据服务器

开发 前端
我将介绍如何使用nodeJS来搭建一个mock服务器,方便前端自定义mock数据请求,提高前端开发的主观能动性和对项目健壮性的探索。

对于前端开发者而言,javascript正扮演着越来越重要的地位,它不仅能为浏览器端赋能,在web服务器方面也有很大的价值(我们可以用nodeJS来写服务端代码,启动web服务器),因此本文所要描述的,便是javascript在服务端的应用。我将介绍如何使用nodeJS来搭建一个mock服务器,方便前端自定义mock数据请求,提高前端开发的主观能动性和对项目健壮性的探索。

我们将学到

  • koa基本使用
  • koa-router的基本用法
  • koa-logger的使用
  • glob支持文件遍历查寻
  • node几个核心api的使用
  • 使用nodemon做自动重启

mock服务器基本设计思路

通过目录路径和服务端api的映射关系来实现我们的api访问,比如我们访问接口/api/article/122,我们只需要在mock服务器目录的api的article目录下,创建122.json文件即可,json文件的数据可以自定义,方便前端调试。

具体实现

1.搭建一个node服务

  1. const Koa = require('koa'); 
  2. const app = new Koa(); 
  3. app.listen(3000) 

2.注册路由 我们使用koa-router来实现后台服务的路由功能,并通过koa提供的上下文ctx将读取到的数据返回给前端:

  1. const Koa = require('koa'); 
  2. const Router = require('koa-router'); 
  3.   
  4. const app = new Koa(); 
  5. const router = new Router({prefix: '/api'}); 
  6.  
  7. router.get('/name', (ctx, next) => { 
  8.     ctx.body = { 
  9.         name'xuxiaoxi' 
  10.     } 
  11.   }); 
  12.  
  13. app 
  14.   .use(router.routes()) 
  15.   .use(router.allowedMethods()); 
  16.    
  17. app.listen(3000) 

这样我们就能实现一个勉强能用的基本的后台api服务器了,当我们请求/api/name时,会返回相应的数据给前台,这一步是我们实现mock服务的关键一步,接下来我们具体来实现目录的遍历和api的自动注册。

3.自动注册api接口并返回数据 我们将在这个阶段实现api服务的自动注册,这里我们使用glob这个第三方模块来遍历目录,并通过node的fs模块读取api文件的数据并返回给前台。glob的使用很简单,感兴趣的朋友可以自行学习,这里就不做过多介绍了。具体实现如下:

  1. const Koa = require('koa'); 
  2. const Router = require('koa-router'); 
  3. const glob = require("glob"); 
  4. const { resolve } = require('path'); 
  5. const fs = require('fs'); 
  6.   
  7. const app = new Koa(); 
  8. const router = new Router({prefix: '/api'}); 
  9.  
  10. // 注册路由 
  11. glob.sync(resolve('./api'"**/*.json")).forEach((item, i) => { 
  12.     let apiJsonPath = item && item.split('/api')[1]; 
  13.     let apiPath = apiJsonPath.replace('.json'''); 
  14.      
  15.     router.get(apiPath, (ctx, next) => { 
  16.         try { 
  17.             let jsonStr = fs.readFileSync(item).toString(); 
  18.             ctx.body = { 
  19.                 data: JSON.parse(jsonStr), 
  20.                 state: 200, 
  21.                 type: 'success' // 自定义响应体 
  22.             } 
  23.         }catch(err) { 
  24.             ctx.throw('服务器错误', 500); 
  25.         } 
  26.       }); 
  27. }); 
  28.   
  29. app 
  30.   .use(router.routes()) 
  31.   .use(router.allowedMethods()); 
  32.  
  33. app.listen(3000); 

添加控制台日志 我们使用koa-logger实现在终端打印node日志,方便调试,虽然这不是该文章的重点,但是对于想做node开发的前端从业者,还是很有必要了解的。

  1. const logger = require('koa-logger'
  2. app.use(logger()); 

这样,我们每个请求都会在终端打印出来。

路由映射文件的生成 该功能也不是本文的重点,但是会极大的方便前端开发者调试请求,因为如果api路径很长,我们需要一个个查找,但是有了这个map文件,我们只需要拷贝自动生成的路径即可。具体实现如下:

  1. //... 
  2. const routerMap = {};  // 存放路由映射 
  3.  
  4. // 注册路由 
  5. glob.sync(resolve('./api'"**/*.json")).forEach((item, i) => { 
  6.     // ... 
  7.      
  8.     // 记录路由 
  9.     routerMap[apiJsonPath] = apiPath; 
  10. }); 
  11.  
  12. fs.writeFile('./routerMap.json', JSON.stringify(routerMap, null , 4), err => { 
  13.     if(!err) { 
  14.         console.log('路由地图生成成功!'
  15.     } 
  16. }); 

基本目录结构

本文转载自微信公众号「趣谈前端」

 

责任编辑:姜华 来源: 趣谈前端
相关推荐

2021-09-12 22:22:45

Mock数据服务

2022-06-28 12:35:21

DockerPython

2022-01-06 18:20:20

Scarlet AndroidWebSocket

2021-07-29 23:29:55

web服务器开发

2018-08-30 09:01:28

Web服务器Windows 10

2023-05-27 21:13:34

FlaskURL装饰器

2009-10-28 11:44:34

VB.NET资源文件

2022-06-05 13:52:32

Node.jsDNS 的原理DNS 服务器

2012-03-02 13:10:08

笔记本常见问题

2013-11-29 13:55:37

2013-11-04 11:02:57

2009-11-26 11:19:52

NIS服务器

2011-01-21 10:30:46

2022-10-12 23:02:49

Calcite异构数据框架

2019-01-16 18:34:37

Python 开发数据

2009-11-04 16:13:18

ADO.NET数据表

2009-10-10 15:50:25

2022-06-02 08:46:04

网卡网络服务器

2009-11-11 16:08:21

ADO.NET数据服务

2009-11-16 13:11:21

点赞
收藏

51CTO技术栈公众号