nodejs结合apiblue实现MockServer

apiblue功能很强大，里面支持很多插件，这些插件能够为restfulAPI提供接口文档自动生成，甚至Mockserver的功能，当然，好多插件还是有很多坑的。下面用apiblue实现下面的业务需求：

1、用户上传.md文件，自动启动mock动作，生成一套api测试服务

2、根据.md文档自动生成html接口文档

3、当.md文档发生crud操作的时候，文档和mockServer自动更新

drakov将.md文档中的接口自动生成Mockserver,关键代码如下：

 var drakov = require('drakov');
 var aglio = require('./aglio');
 var path = require('path');
 var sourceFiles = path.resolve(__dirname, '../mfiles/**.md');
 var fs = require("fs");
 var argv = {
   sourceFiles: sourceFiles,//md文档存储地
   serverPort: 4007,
   disableCORS: false,//false允许跨域访问
   debugMode: true,
   discover: true,
   public: true,//true允许外围ip访问api,false只能本地访问
   watch: true,
   method: ['GET', 'PUT', 'POST', 'DELETE', 'OPTIONS']
 };
 module.exports = function (mdFileUrl) {
   try {
     if ((mdFileUrl && typeof (mdFileUrl) === "string" && mdFileUrl.indexOf(".md") > -1) || mdFileUrl == '') {
       drakov.stop(function () {
         // stopped Drakov
         console.log('drakov Finished');
       });

       drakov.run(argv, function () {
         console.log('drakov start');
       });
       if (mdFileUrl) {
         aglio(mdFileUrl);
       }
     }

   } catch (e) { } finally { }
 }

https://github.com/Aconex/drakov 这是drakov  git地址,上面介绍了使用中间件的方式实现drakov与express结合，当时有问题，drakov的watch功能失效，md文档发生改变，无法更新apiServer。

aglio实现将md文档生成HTML接口文档，关键代码如下：

 var aglio = require('aglio');
 var path = require('path');
 var fs = require('fs');
 var aglio_options = {
   themeTemplate: 'default',//aglio样式
   locals: {
     myVariable: 125
   }
 };
 module.exports = function(mdFileUrl) {
   if (mdFileUrl) {
     var targetUrl = mdFileUrl.replace("/mfiles/", "/mock-ui/").replace(".md", ".html");
     aglio.renderFile(mdFileUrl, targetUrl, aglio_options, function(err, warnings) {
       if (err)
         return console.log(err);
       }
     );
   }

 }

watch监控存放md文件的文件夹，实时通知drakov和aligo，关键代码如下：

 var watch = require('watch');
 var drakov = require('./drakov');

 module.exports = function (watchDir) {
   try {
     var filepath;
     watch.watchTree(watchDir, function (f, curr, prev) {
       if (typeof f == "object" && prev === null && curr === null) {
         // Finished walking the tree
         drakov('')
       } else if (prev === null) {
         // f is a new file
         if (filepath != f) {
           drakov(f, 'new');
           filepath = f;
         }
       } else if (curr.nlink === 0) {
         if (filepath != f) {
           // f was removed
           drakov(f)
         }
       } else {
         // f was changed
         drakov(f)
       }
     })
     console.log("watching file...");

   } catch (e) {
     console.log(e.message);
   } finally { }

 }

ok 根据这三个js，你就可以建一个MockServer,就像 easymock（www.easy-mock.com）一样，试试吧。。对于需求工程师很有帮助

欢迎关注我的订阅号