SQLUnit quick start guide

 

       SQLUnit是一个用于对存储过程进行单元测试的工具,其实也可以用于做针对数据库数据、性能的测试等,延续了xUnit家族的一贯特性和风格,只不过它的测试是以xml的方式来编写,但原则仍然和xUnit家族其他产品一样,强调的是输出和预期的比较,SQLUnit的文档比较的少,由于官方站上并没有提供类似其他开源工具的quick start guide,就写了这篇quick start guide以便大家快速的使用sqlunit,至于SQLUnit的高级用法还是得去多看看sqlunit.sf.net官方站上的文档。

       为了让大家能快速的开始入门使用SQLUnit,将介绍SQLUnit环境的搭建、如何编写一个单元测试、如何运行。

1          SQLUnit环境的搭建

SQLUnit依赖jdkant,因此首先需要搭好jdkant的环境,jdk建议使用1.5以上的版本,ant使用1.6.5以上的版本即可。

搭建好jdkant的环境后,从sqlunit.sf.net上下载最新版本的SQLUnit,下载完毕后解压至目录即可,这样就完成了SQLUnit环境的搭建。

2          编写第一个单元测试

开始来编写我们的第一个单元测试,基于SQLUnit的单元测试以编写xml的方式来实现,在目录下创建一个demo.xml文件。

这个单元测试用来测试一个名为DEMO_SP的存储过程,这个存储过程需要输入一个字符串参数,输出的为一个记录集和一个字符串。

当输入bluedavy时,期待输出的记录集中为一条记录,内容为:

ID     USERNAME

2      bluedavy

输出的字符串为:”Hello:bluedavy”

在确定了输入和期待的输出后,可以开始动手来编写demo.xml了,编写完毕后整个demo.xml文件的内容如下:

<?xml version="1.0" encoding="GBK"?>

<!DOCTYPE sqlunit SYSTEM "file:docs/sqlunit.dtd">

<sqlunit>

 

  <!--数据库连接信息-->

  <connection connection-id="1">

    <driver>oracle.jdbc.driver.OracleDriver</driver>

    <url>jdbc:oracle:thin:@数据库IP:1521:数据库实例</url>

    <user>用户名</user>

    <password>密码</password>

  </connection>

 

  <test name="用户名为bluedavy时的测试" failure-message="根据用户名执行存储过程错误">

         <call connection-id="1">

              <stmt>{call DEMO_SP(?,?,?)}</stmt>

              <param id="1" type="VARCHAR" inout="in">bluedavy</param>

              <param id="2" type="CURSOR" inout="out">${p_cursor}</param>

              <param id="3" type="VARCHAR" inout="out">${p_message}</param>

         </call>

         <result>

              <outparam id="2" type="CURSOR">

                <resultset id="1">

                     <row id="1">

                       <col id="1" type="INTEGER">2</col>

                       <col id="2" type="VARCHAR">bluedavy</col>

                     </row>

                </resultset>

              </outparam>

              <outparam id="3" type="VARCHAR">Hello:bluedavy</outparam>

         </result>

</test>

由上可知,基于SQLUnit编写一个存储过程的单元测试还是非常容易的,如果是对于函数的测试,只需要将上面的<stmt>改成这样的格式即可:<stmt>{?=call 函数名(?,?)}</stmt>

对于熟悉xUnit家族工具的同学们而言,一个sqlunit单元测试的xml文件就相当于一个单元测试类,而其中的<test></test>就相当于测试一种输入情况的方法。

3          运行单元测试及生成报表

上面的单元测试是对oracle的存储过程进行测试的,因此在运行前需要将oracle驱动的jar文件放入sqlunitlib目录下,或安装oracle客户端。

一切准备妥当后,首先将sqlunit目录下的build.xml中的

<sqlunit testfile="${testfile}" haltOnFailure="true" debug="${debug}"

        logfile="${output.file}" logformat="${log.format}" />

修改为:

<sqlunit testfile="${testfile}" haltOnFailure="false" debug="${debug}"

        logfile="${output.file}" logformat="${log.format}" />

避免由于测试的失败造成报表也无法生成。

修改完毕后可进入命令行,进入sqlunit的目录,运行如下命令:

ant -Dlog.format=canoo -Doutput.file=demotest.xml -Dtestfile=demo.xml sqlunit-flat canoo2html

运行完毕后,就可在sqlunit下的output目录中找到demotest.html,打开就可看到此次单元测试运行的报告了,如发现报告中未生成单元测试失败的详细信息,则需要把lib目录下的sqlunit-5.0.jar删除或移至其他目录。

 

       作为一个quick start guide,就只介绍到这了,其他的像sqlunitxmltestoutparam这些标签的具体含义和示例、如何Mock Database等可以到sqlunit官方网站(http://sqlunit.sf.net)上查看。

posted on 2007-11-08 16:59 BlueDavy 阅读(3137) 评论(0)  编辑  收藏 所属分类: Java


只有注册用户登录后才能发表评论。


网站导航:
 

公告

 









feedsky
抓虾
google reader
鲜果

导航

<2007年11月>
28293031123
45678910
11121314151617
18192021222324
2526272829301
2345678

统计

随笔分类

随笔档案

文章档案

Blogger's

搜索

最新评论

阅读排行榜

评论排行榜