zoukankan      html  css  js  c++  java

  • Fitnesse+RestFixture：Web服务回归测试利器

    RestFixture是Fitness的一个测试REST服务的插件，用于调用标准的http 
    GET/POST等请求方法，并可以用XPath语法和Javascript语法检验http响应。本文介绍安装运行RestFixture的步骤，并给出测试用例示例。

    首先普及一下概念，什么是Fitnesse，听一听.NET版Cucumber的创始人Aslak Hellesøy谈Fitnesse与Cucumber对比：

    FIT/Fitnesse和Cucumber都执行高级语言编写的验收测试。FIT仅识别HTML，Fitnesse则通过提供Wiki语法来简化编写测试的过程。在FIT/Fitnesse当中，所有的测试都以表格的形式呈现。 
    FitNesse比Cucumber的优势在于Wiki支持。

    原文链接：http://www.infoq.com/cn/news/2009/11/interview-cucumber-for-dotnet

    1.几句题外话

    对于http请求的测试，有几种方式：

    1. 浏览器中输入http url，只适用于GET方法
    2. curl命令手工测试
    3. junit中直接用java network api调用GET/POST方法
    4. 在自动化测试框架中封装指令，如cucumber, fitnesse, robotframework

    上述1、2手工测试，不能用于回归测试；3、4能用于回归测试，但要开发测试脚本代码，维护非常麻烦。

    今日回想起两年前浅尝辄止的fitnesse，想碰运气看看有没有好的测试插件，结果真找到了用于Restful API测试的插件：RestFixture

    2.Fitnesse 20111026+RestFixture 3.0 ——最佳拍档

    2.1 http响应格式是xml的示例

    废话少说，先上图： 
    用Xpath语法检查GET响应内容

    上面的测试用例的目的是：

    并且 tag内容是

    ?
    1
    Don't forget the meeting!

    note.xml的内容：

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    <?xml version="1.0" encoding="ISO-8859-1"?>
    <!--  Copyright w3school.com.cn -->
    <note>
        <to>George</to>
        <from>John</from>
        <heading>Reminder</heading>
        <body>Don't forget the meeting!</body>
    </note>

    fitnesse 测试用例wiki文本：

    ?
    1
    2
    3
    4
    5
    6
    !define TEST_SYSTEM {slim}
     
    !path D:fitnessefitnesse-20111026smartrics-RestFixture-3.0lib*
     
    | Table:smartrics.rest.fitnesse.fixture.RestFixture | http://www.w3school.com.cn |
    | GET | /example/xmle/note.xml | 200 | Content-Type: text/xml | //body[text()="Don't forget the meeting!"]|

    2.2 http响应格式是json的示例

    用IP获取地址信息

    上面的测试用例的目的是：

    调用百度地图Web API，根据IP获取地图地址信息，检查服务响应内容中的status字段必须是0，下面判断语句是javascript表达式：

    ?
    1
    jsonbody.status==0

    GET访问的url：

    • http://api.map.baidu.com/location/ip?ip=202.198.16.3&coor=bd09ll&ak=60IFKTCwlIsSpDcGfkx36L8u

    url返回的内容：

    ?
    1
    {"address":"CN|u5409u6797|u957fu6625|None|CERNET|1|None","content":{"address":"u5409u6797u7701u957fu6625u5e02","address_detail":{"city":"u957fu6625u5e02","city_code":53,"district":"","province":"u5409u6797u7701","street":"","street_number":""},"point":{"x":"125.31364243","y":"43.89833761"}},"status":0}

    被调用Web API文档：

    • http://developer.baidu.com/map/wiki/index.php?title=webapi/ip-api#.E6.8E.A5.E5.8F.A3.E7.A4.BA.E4.BE.8B

    fitnesse 测试用例wiki文本：

    ?
    1
    2
    3
    4
    5
    6
    !define TEST_SYSTEM {slim}
     
    !path D:fitnessefitnesse-20111026smartrics-RestFixture-3.0lib*
     
    | Table:smartrics.rest.fitnesse.fixture.RestFixture | http://api.map.baidu.com |
    | GET | /location/ip?ip=202.198.16.3&coor=bd09ll&ak=60IFKTCwlIsSpDcGfkx36L8u | 200 | Content-Type: application/json | jsonbody.status==0 |

    2.3 用javascript处理json对象

    我们再来看上面的GET响应文本：

    ?
    1
    {"address":"CN|u5409u6797|u957fu6625|None|CERNET|1|None","content":{"address":"u5409u6797u7701u957fu6625u5e02","address_detail":{"city":"u957fu6625u5e02","city_code":53,"district":"","province":"u5409u6797u7701","street":"","street_number":""},"point":{"x":"125.31364243","y":"43.89833761"}},"status":0}

    u5409u6797|u957fu6625是什么？

    按照百度API文档，应该返回这样的：

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    { 
        address: "CN|吉林|长春|None|CERNET|1|None", 
        content: { 
        address: "吉林省长春市", 
        address_detail: { 
        city: "长春市", 
        city_code: 53, 
        district: "", 
        province: "吉林省", 
        street: "", 
        street_number: "" 
        }, 
        point: {      
        x: "125.31364243",     
        y: "43.89833761" 
        } 
        }, 
        status: 0 
    }

    原来u5409u6797|u957fu6625是 吉林|长春 encodeURI的结果

    可以在 Chrome浏览器 > 菜单 > 工具 > JavaScript控制台（Firefox/IE/Opera都有对应的控制台） 中使用 String.replace函数来把u5409变成"吉”：

    替换字符串

    下一步在Fitnesse中要见证奇迹了，RestFixture居然支持Javascript语法和全局函数，也可以调用String.replace函数：

    ?
    1
    2
    3
    4
    5
    6
    7
    !define TEST_SYSTEM {slim}
     
    !path D:fitnessefitnesse-20111026smartrics-RestFixture-3.0lib*
     
    | Table:smartrics.rest.fitnesse.fixture.RestFixture | http://api.map.baidu.com |
    | GET | /location/ip?ip=202.198.16.3&coor=bd09ll&ak=60IFKTCwlIsSpDcGfkx36L8u | 200 | Content-Type: application/json | jsonbody.status==0 |
    | let | bodyDecoded | js | response.body.replace(/\u[dabcdef]{4}/g, function(word){return String.fromCharCode(parseInt(word.substr(2),16))}) | |

    body替换后测试结果

    RestFixture变量bodyDecoded的内容是中文化后的json：

    ?
    1
    {"address":"CN|吉林|长春|None|CERNET|1|None","content":{"address":"吉林省长春市","address_detail":{"city":"长春市","city_code":53,"district":"","province":"吉林省","street":"","street_number":""},"point":{"x":"125.31364243","y":"43.89833761"}},"status":0}

    下面，还可以把bodyDecoded作为表达式文本计算，生成一个js对象：

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    | let | printJsonMembers | js | !-
    var jsonObject = eval('a=%bodyDecoded%');
    var str1="";
    function printObject(obj, indent){
      for(var i in obj){
        if(typeof obj[i] == "object"){
          str1+= indent + i+":"+" ";
          printObject(obj[i], indent+" ");
        } else
          str1+= indent + i +":"+obj[i] + " ";
      }
    }
    printObject(jsonObject, "");
    str1-! | |

    这里要演示的第二个let行使用了第一个let行定义的变量：%bodyDecoded%，显然借鉴了Windows Bat文件的语法。

    测试结果：

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    address:CN|吉林|长春|None|CERNET|1|None
    content:
            address:吉林省长春市
            address_detail:
                    city:长春市
                    city_code:53
                    district:
                    province:吉林省
                    street:
                    street_number:
            point:
                    x:125.31364243
                    y:43.89833761
    status:0

    3.RestFixture参考资料

    3.1 RestFixture使用文档

    RestFixture使用文档链接

    https://cloud.github.com/downloads/smartrics/RestFixture/RestFixture-3.0.pdf

    RestFixture使用文档片段

    3.2 运行环境

    fitnesse运行环境文件目录：

    fitnesse文件目录 
    restfixture文件目录

    注意：其中的slf4j-simple-1.6.6.jar需要额外下载

    启动fitnesse命令： 
    启动fitnesse

    D:fitnessefitnesse-20111026>java -jar fitnesse.jar -p 11026

    -p 11026 是让fitnesse网站使用11026端口，因为我要在后面的例子中使用多个fitnesse版本，所以用版本号作为端口。

    3.3 相关安装包下载地址

    RestFixture安装包下载地址：

    slf4j-simple-1.6.6.jar下载地址：

    Fitnesse安装包下载地址：

    3.4 相关网址

    • Fitnesse 首页：
    • http://www.fitnesse.org/
    • Fitnesse安装包下载： Fitnesse首页 > Download > release 20111026 > fitnesse.jar
    • Fitnesse插件列表： Fitnesse首页 > Plug-ins
    • RestFixture首页： Fitnesse首页 > Plug-ins > SLiM Fixtures > RestFixture =>
    • https://github.com/smartrics/RestFixture
    • RestFixture安装包下载： RestFixture首页 > Wiki > Live documentation > download > smartrics-RestFixture-3.0-bin.zip
    • RestFixture使用文档： RestFixture首页 > Wiki > Live documentation > download > RestFixture-3.0.pdf

    4.Fitnesse 20140630+RestFixture 3.0 ——水土不服

    RestFixture在最新版Fitnesse 20140630 的运行结果： 
    最新版Fitnesse的运行结果

    其中的GET行，只有第2、3列正确显示，4、5列显示为HTML文本，看上去十分杂乱，

    旧版的Fitnesse是这样显示的：

    用Xpath语法检查GET响应内容

    后续的博客中，我会介绍如何让RestFixture 3.0在Fitnesse 20140630中也能打印出漂亮的测试结果。

    为Fitnesse-20140630定制RestFixture代码
  • 相关阅读:
    c++中关于用stringstream进行的类型转化
    c++中字符串的反转
    搬家
    初次见面，请多关照。
    CCPC2019吉林省赛&&东北地区赛游记
    VS Code下搭建简单的Haskell开发环境
    从零开始的KMP&&AC自动机
    从零开始的LCA（最近公共祖先）
    LuoguP2123 皇后游戏
    LuoguP1080 国王游戏
  • 原文地址：https://www.cnblogs.com/fitnessefan/p/3895652.html
Copyright © 2011-2022 走看看