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）一样，试试吧。。对于需求工程师很有帮助
欢迎关注我的订阅号