Torna 1.1.0 发布,企业接口文档解决方案

来源: 投稿
2021-03-24

Torna 1.1.0 发布,本次更新内容如下:

  • [feat]支持Mock
  • [fix]文档分类无法删除问题 #I3CPJ5
  • [fix]smart-doc推送无法删除旧文档问题 #I3CPJL

本次更新主要内容是新增了Mock请求,在后端没有提供接口数据的情况下,前端开发人员可以配置Mock,模拟返回数据。

开发人员可以编写Mock脚本(基于mockjs)生成数据。

例子1

可点击运行调试是否可行,没有问题后,点击保存,然后使用postman请求结果如下:

例子2:编写多个函数

function getItems() {
    return Mock.mock({
      "items|4-10": [
        { "id": 2, "label": "手机" }
      ]
    })
}

function getName() {
    return "分类";
}

var data = {
    "id": 1,
    "name": getName()
}
var items = getItems()
Object.assign(data, items)
// 最后一行返回
return data;

运行结果:

{
    "id": 1,
    "name": "分类",
    "items": [
        {
            "id": 2,
            "label": "手机"
        },
        {
            "id": 2,
            "label": "手机"
        },
        {
            "id": 2,
            "label": "手机"
        },
        {
            "id": 2,
            "label": "手机"
        }
    ]
}

例子3:扩展

var random = Mock.Random;

//扩展数据模板
random.extend({
  type: function(index) {
    const types = ['products', 'industryApp', 'solution', 'experts'];
    return this.pick(types[index])
  }
});

// 定义数据类型
const menuSource = [];
menuSource[0] = Mock.mock({
  "type": "@type(0)",
   'data|3-4':[{
     'id|+1': 1,
     name: "@ctitle( 4,6)",
     "childs|5-10": [{
       'id|+1': 1,
       name: "@ctitle(4,6)",
     }]
   }]
});

return menuSource;

运行结果:

[
    {
        "type": "products",
        "data": [
            {
                "id": 1,
                "name": "心没积战",
                "childs": [
                    {
                        "id": 1,
                        "name": "决料听国立"
                    }
                ]
            },
            {
                "id": 2,
                "name": "属化政却外",
                "childs": [
                    {
                        "id": 2,
                        "name": "众他易族"
                    },
                    {
                        "id": 3,
                        "name": "结值自别难"
                    }
                ]
            }
        ]
    }
]

关于Torna

企业接口文档解决方案,目标是让文档管理变得更加方便、快捷。Torna采用团队协作的方式管理和维护项目API文档,将不同形式的文档纳入进来,形成一个统一的维护方式。

展开阅读全文
19 收藏
分享
加载中
精彩评论
未来肯定是torna更好,而且和smart-doc打通了,smart-doc比yapi的插件解析强太多了
2021-03-24 15:49
1
举报
和yapi比哪个更好?
2021-03-24 14:01
1
举报
前排支持
2021-03-24 10:39
1
举报
最新评论 (5)
接口较多的时候http推送会报超时
2021-03-26 21:00
0
回复
举报
什么版本,最新版已经改为异步处理了
2021-03-27 18:10
0
回复
举报
和yapi比哪个更好?
2021-03-24 14:01
1
回复
举报
未来肯定是torna更好,而且和smart-doc打通了,smart-doc比yapi的插件解析强太多了
2021-03-24 15:49
1
回复
举报
前排支持
2021-03-24 10:39
1
回复
举报
更多评论
5 评论
19 收藏
分享
返回顶部
顶部