Panda-api test_data匹配说明

Panda api中， test_data是一个非常非常重要的设计，可以方便前端进行各种情况的测试。

test_data中，有这么几个字段可以进行数据匹配

{
    method: "GET", // 请求方法匹配
    url:"/post/10/", // 网址匹配
    query: {}, // query/GET 参数匹配
    body: {}, // post中body参数匹配
    form_data: {}, // post中请求数据在form_data中的参数匹配
    response:{} // 匹配成功后返回的结果
    delay:0 // 请求后需要延迟多少时间返回数据，用于模拟网络慢或者超时
}

method, url、query、body 或 form_data 是请求时的相关数据，这四者是可以同时存在或者只有其中一个存在，或者都不存在， 匹配成功后返回response中的结果

定义test_data某个字段的mock

在写用户登录的test_data数据匹配的时候，我们是这么写的：

...
body:{
    username:{name:"用户名"},
    password:{name:"用户登录密码"}
},
response:{
    code:{name:"返回结果的代码", type:"int", desc:"登录成功只返回1"},
    msg:{name:"登录成功返回消息", type:"string", desc:"通常返回都是空"},
    token:{name:"登录成功返回的用户token", type:"string", required:false}
},
test_data:[
    {
        body:{username:"edison", password:"123"},
        response:{code:-1, msg:"密码输入不正确"}
    },
    {
        body:{username:"lily", password:"123"},
        response:{code:-2, msg:"用户名不存在"}
    },
    {
        body:{username:"root", password:"123"},
        response:{code:1, msg:"登录成功", token:"5lCadRru(ADn2IE!$LV%x%JF3JNmz*Nf5nFieUG!r((&esi2CLI$jb!227Lh"}
    },
    {
        body:{username:"lily"},
        response:{code:-1, msg:"密码是必填的"}
    },
    {
        body:{password:"123"},
        response:{code:-1, msg:"用户名是必填的"}
    }
]
...

这个是一个登陆成功的测试数据，他已经可以满足满足我们前端开发的需求，但是稍微有一点不完美，就是正常情况下，我们每次登陆返回的token应该是动态随机生成的，而不应该是固定的，我们需要对token字段使用mock，所以我们改一下这一组数据：

{
test_data:[
    ...
    {
        body:{username:"root", password:"123"},
        response:{code:1, msg:"登录成功", token:{$mock:true, required:true}}
    }
    ...
]
},

保存文档，然后请求接口/login/，请求body数据为{username:"root", password:"123"}，你就会得到动态的符合要求的token。

这里修改中，我们把token原设置的字符串给为了一个对象{$mock:true}，表示这个字段开启mock数据生成，这要求token字段必须在接口response文档中中有对应的定义，否则这个字段就会被忽略。然后在接口response中token字段是可有可无的required:false，生成的mock有时候回有，有时候没有，但是在我们指定了用户名密码是登录成功的状态下，token是必须有的，所以我们重写了token字段的required:true，这样就每次请求，一定有token返回。

在token:{$mock:true, required:true}这里，你可以重写你想要的任何token字段的属性。

使用url匹配的test_data

{
    name:"Article view",
    method:"GET",
    url:"/post/{id:\\d+}/", // the url support regex match
    response:{
        code:{name:"response result code", type:"int", desc:"success is 1"},
        msg:{name:"response result message", type:"string", desc:""},
        data: {
            $name:"data field name",
            $desc:"data field description",
            $required:false,
            id:{name:"article id", type:"number"},
            title:{name:"article title"},
            summary:{name:"article summary"},
            content:{name:"article content"},
            category_name:{name:"article category name"},
            author_name:{name:"article author name"},
            source:{name:"article source"},
            tag:{name:"article tag"},
            read_count:{name:"article read count", type:"number"},
            created:{name:"article created time", type:"number"},
            }
    },
    test_data:[
        {
            url:"/post/1/", // use url match
            response:{
                code:1,
                msg:"",
                data: {
                    id:1,
                    title:"Hello World",
                    summary:"This is the first post",
                    content:"This is the first post, and it is a test case data",
                    category_name:"Other Category",
                    author_name:"Edison",
                    source:"Panda api",
                    tag:"test",
                    read_count:1,
                    created:1580048711
                }
            },
        },
        {
            url:"/post/3000/",
            response:{
                code:-1,
                msg:"article not found"
            },
        }
    ]
},

首先，我们的url是一个正则匹配/post/{id:\\d+}/，/post/(数字)/的都满足匹配条件，

test_data中的第一个元素，url:"/post/1/"， 必须请求url是/post/1/, 才会返回其对应的 response；

test_data中的第二个元素，url:"/post/3000/", 必须请求url是 /post/3000/，才会返回其对应的response；

test_data中url的匹配有一点特殊，如果设置test_data中的url，表示忽略url匹配，也就是默认url是匹配的。

其它字段不一样，就是没有设置，也会拿着空去匹配

使用query 进行匹配

{
    name:"user logout",
    method:"GET",
    url:"/logout/",
    query:{
        id:{name:"user id", type:"int"},
        username:{}
    },
    response:{
        code:{name:"response result code", type:"int", desc:"success is 1"},
        msg:{name:"response result message", type:"string", desc:""}
    },
    test_data:[
        {
            query:{id:1, username:"root"},
            response:{code:1, msg:"logout success"}
        },
        {
            response:{code:-1, msg:"error"}
        },
        {
            query:{id:3, username:"lily"},
            response:{code:-1, msg:"username and id not match"}
        }
    ]
}

注意，这里接口中定义域query的id为id:{name:"user id", type:"int"}，id是一个整数，那么test_data中query里id的值也必须是整数，否则不会匹配。也就是

// 接口中query定义
query:{
    id:{name:"user id", type:"int"}
    ....
}
// 请求 /logout/?id=1&username=root
query:{id:1, username:"root"}, // 会匹配
query:{id:"1", username:"root"}, // 不会匹配

如果我们把接口query的定义改为：id:{name:"user id", type:"string"}，id是一个字符串，那么test_data中query里id的值也必须为整数，否则不会匹配。也就是

// 接口中query定义
query:{
    id:{name:"user id", type:"string"}
    ....
}
// 请求 /logout/?id=1&username=root
query:{id:1, username:"root"}, // 不会匹配
query:{id:"1", username:"root"}, // 会匹配

如果没有定义接口的response或者query，那么请求的所有query中的整数都是当做字符串处理，写在test_data中也必须全部写为字符串

使用body进行匹配

{
    name:"user login",
    desc:"if user login success, will get a token",
    method: "POST",
    url:"/login/",
    body_mode:"json", // form-data, text, json, html, xml, javascript, binary
    body:{
        username:{name: "username"},
        password:{name: "password"}
    },
    response:{
        code:{name:"response result code", type:"int", desc:"success is 1"},
        msg:{name:"response result message", type:"string", desc:""},
        token:{name:"login success, get a user token; login failed, no token", type:"string", required:false}
    },
    test_data:[
        {
            body:{username:"edison", password:"123"},
            response:{code:-1, msg:"password incorrect"}
        },
        {
            body:{username:"lily", password:"123"},
            response:{code:-2, msg:"username not exist"}
        },
        {
            body:{username:"root", password:"123"},
            response:{code:1, msg:"login success", token:"fjdlkfjlafjdlaj3jk2l4j"}
        },
        {
            body:{username:"lily"},
            response:{code:-1, msg:"password is required"}
        },
        {
            body:{password:"123"},
            response:{code:-1, msg:"username is required"}
        }
    ]
},

form_data匹配

把上个例子中body字段名改为form_data即可。

使用method进行匹配

method可以直接写字符串method:"GET"，单个方法匹配，也可以写数组，一次匹配多种方法，method:["GET", "POST"]，也可以匹配全部方法：method:"*"

如果不在test_data中设置method，表示method请求方法默认都是匹配的。

{
    // 假设在这个接口中，编辑获取数据和提交保存是一个接口，真实开发中，不建议这么做
    name:"Article add",
    desc:"Article add or edit",
    method:["GET", "POST"],
    url:"/post/add/",
    body_mode:"json", // form-data, text, json, html, xml, javascript, binary
    body:{
        id:{name: "article id"},
        title:{name: "article title", required:false},
        content:{name: "article content", required:false}
    },
    response:{
        id: {name: "Article id", type:"PosInt"},
        title:{name: "article title"},
        content:{name: "article content"}
    },
    test_data:[
        {
            method:"GET",
            body:{
                id:1
            },
            response: {
                id:1,
                title:"Hello World",
                content:"Article Content"
            }
        },
        {
            method:"POST",
            body:{
                id:1,
                title:"Hello World",
                content:"Article Content"
            },
            response: {
                id:1,
                title:"Hello World",
                content:"Article Content"
            }
        },
    ]
}

如果请求的method不匹配，那么将会返回错误

{
  "code": -1,
  "msg": "this api address /logout/ not defined method POST"
}

增加test_data数据的描述说明

可以在test_data的数据列表的元素中，增加name字段和desc字段，进行测试用例数据的描述，name字段和desc字段与method、body这些字段是同级的。增加了name和desc不会影响test_data的匹配，两个字段都是可选的。

test_data:[
    {
        name:"编辑文章时获取文章内容",
        method:"GET",
        body:{
            id:1
        },
        response: {
            id:1,
            title:"Hello World",
            content:"Article Content"
        }
    },
    {
        name:"提交文章编辑内容",
        desc:"提价文章编辑内容后，数据立即更新内容",
        method:"POST",
        body:{
            id:1,
            title:"Hello World",
            content:"Article Content"
        },
        response: {
            id:1,
            title:"Hello World",
            content:"Article Content"
        }
    },
]

如果请求的url不匹配，那么将会返回错误

{
  "code": -1,
  "msg": "this api address /logout/aaa/ not defined method POST"
}

其它

虽然不推荐，但是其实你可以这么做，就是不定义response，直接写test_data里面的数据就开始前端访问。

这么做可以快速的提供接口服务，不好的是，没有了response文档，同时也不会自动生成mock数据。

2020-02-24 09:04