微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

ScaffoldUnit

程序名称:ScaffoldUnit

授权协议: Apache

操作系统: 跨平台

开发语言: Java

ScaffoldUnit 介绍


你是否有这样的经历。当你遇到需要测试数据库相关操作的时候,在每次测试之前,反复的通过ui来改变数据库的数据。这件事情可以交给 ScaffoldUnit来做。

当前只通过了 MysqL 的测试

Maven 依赖

<dependency>  
  <groupId>org.crazycake</groupId>  
  <artifactId>ScaffoldUnit</artifactId>  
  <version>1.0.0-RELEASE</version>  
</dependency>

快速开始

在项目的classpath 根目录下 创建 ScaffoldUnit.properties , 比如 src/main/resources

ScaffoldUnit.jdbc.url=jdbc:MysqL://localhost:3306/sunit_test?useUnicode=true&characterEncoding=UTF-8  
ScaffoldUnit.jdbc.username=root  
ScaffoldUnit.jdbc.password=123456

创建一个测试数据库 sunit_test 建立一个表 student

CREATE TABLE `student` (  
  `id` int(11) NOT NULL,  
  `name` varchar(32) default NULL,  
  PRIMARY KEY  (`id`)  
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

创建类 HelloScaffoldUnitTest.java ,有一个测试方法 testBuild.

package org.crazycake.ScaffoldUnit;  
  
import java.io.IOException;  
import java.sql.Connection;  
import java.sql.DriverManager;  
import java.sql.sqlException;  
import java.sql.Statement;  
import static org.hamcrest.CoreMatchers.*;  
import org.junit.Test;  
  
public class HelloScaffoldUnitTest {  
  
    @Test  
    public void testBuild() throws IOException, sqlException, ClassNotFoundException{  
  
        //1 build the scaffold data  
        ScaffoldUnit.build();  
  
        //2 test your code  
        Class.forName(com.MysqL.jdbc.Driver);  
        Connection conn = null;  
        conn = DriverManager.getConnection(jdbc:MysqL://localhost:3306/sunit_test?useUnicode=true&characterEncoding=UTF-8,root, 123456);  
        Statement stat = conn.createStatement();  
        stat.execute(update student set name='ted' where name='jack');  
        stat.close();  
        conn.close();  
  
        //3 assert your result  
        ScaffoldUnit.dbassertthat(select name from student where id=1, is(ted));  
  
    }  
}

ScaffoldUnit 需要一个json文件作为告诉ScaffoldUnit如何初始化数据库,在 test/resources
下建立跟你的java类一样的文件路径结构,比如你的测试类全名是 org.crazycake.ScaffoldUnit么你建立的 json文件路径是这样的
test/resources/org/crazycake/ScaffoldUnit/ScaffoldUnitTest.json.

{  
    ms:[  
        {  
            n:testBuild,  
            ts:[  
                {  
                    t:student,  
                    rs:[  
                        [  
                            {  
                                c:id,  
                                v:1  
                            },  
                            {  
                                c:name,  
                                v:'jack'  
                            }  
                        ]  
                    ]  
                }  
            ]  
        }  
    ]  
}

这个json文件告诉ScaffoldUnit 在做 testBuild 测试之前做两件事情

1. truncate sunit_hello .
2. 插入一条数据 id=3, name= ‘jack’.

运行测试用例,看日志

2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:47 - ScaffoldUnit.jdbc.url=jdbc:MysqL://localhost:3306/sunit_test?useUnicode=true&characterEncoding=UTF-8
2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:50 - ScaffoldUnit.jdbc.username=root
2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:53 - ScaffoldUnit.jdbc.password=qwer1234
2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:73 - truncate table student
2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:73 - insert into student (id,name) values (1,'jack')
2014-09-21 17:55:37 DEBUG ScaffoldUnitDao:104 - select name from student where id=1

介绍

不需要在测试后恢复数据,只需要在测试前初始化他们即可

ScaffoldUnit won’t recover the test data. Instead, it clean all data of the
tables which test case will use and initialize the data.

xxxx.json

介绍那个json文件

属性介绍

  • ms: 方法的集合

  • n: 方法

  • ts: 表的集合

  • t: 表名

  • rs:需要插入的行集合

  • c: 需要插入的行的列

  • v: 值

如果你只想清理数据

如果你只想清理这个表的数据但是不插入数据,可以不写rs属性:

{ t:nemo_clean }

属性的书写

ScaffoldUnit 只是进行单纯的字段拼接而已,所以如果是字符串的属性加上单引号

{ c:name, v:'jack' }

更复杂一点的例子

{
    ms: [{
        n: testComeAndBiteMe,
        ts: [{
            t: nemo_hello,
            rs: [[{
                c: id,
                v: 1
            },
            {
                c: name,
                v: 'foo'
            }], [{
                c: id,
                v: 2
            },
            {
                c: name,
                v: 'bar'
            }]]
        }]
    },
    {
        n: testBuild,
        ts: [{
            t: nemo_hello,
            rs: [[{
                c: id,
                v: 3
            },
            {
                c: name,
                v: 'mike'
            }], [{
                c: id,
                v: 4
            },
            {
                c: name,
                v: 'kitty'
            }]]
        },
        {
            t: nemo_clean
        }]
    }]
}

构建的方法

在测试方法的第一行调用 ScaffoldUnit.build() 你还可以调用这些方法: comeAndBiteMe iHateWorkOvertime
screwU myBossIsAMuggle and wtf. 效果跟 build(), 一样。

数据库版本的 assertthat

为了断言的方便 ScaffoldUnit 提供了 dbassertthat . 这个方法会把你传入的sql查询结果的第一行的第一个列的值拿出来比较。例子

import static org.hamcrest.CoreMatchers.*;

...

ScaffoldUnit.dbassertthat(select name from student where id=1, is(ted));

自动初始化数据结构

ScaffoldUnit 提供了一个方式可以自动初始化数据结构. 创建一个 sql fileScaffoldUnit.sql 在classpath根目录下.
当ScaffoldUnit 构建测试数据的时候如果遇到表不存在的异常,会试着用这个文件创建数据结构

ScaffoldUnit.sql一个例子. 我是用sqlyog导出的这个sql文件

/* sqlyog Ultimate v8.71  MysqL - 5.0.51b-community-nt : Database - nemo_test 
********************************************************************* */ 
/*!40101 SET NAMES utf8 */; /*!40101 SET sql_mode=''*/;
 /*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */;
 /*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */;
 /*!40101 SET @OLD_sql_mode=@@sql_modesql_mode='NO_AUTO_VALUE_ON_ZERO' */;
 /*!40111 SET @OLD_sql_NOTES=@@sql_NOTES, sql_NOTES=0 */;
 
/*Table structure for table `nemo_clean` */
 DROP TABLE IF EXISTS `nemo_clean`;
 CREATE TABLE `nemo_clean` ( `id` int(11) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
 
/*Table structure for table `nemo_hello` */
 DROP TABLE IF EXISTS `nemo_hello`;
 CREATE TABLE `nemo_hello` ( `id` int(11) NOT NULL, `name` varchar(32) default NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
 
/*Table structure for table `student` */
 DROP TABLE IF EXISTS `student`;
 CREATE TABLE `student` ( `id` int(11) NOT NULL, `name` varchar(300) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;
 
 /*!40101 SET sql_mode=@OLD_sql_mode */;
 /*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */;
 /*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */;
 /*!40111 SET sql_NOTES=@OLD_sql_NOTES */;

ScaffoldUnit 官网

https://github.com/alexxiyang/ScaffoldUnit

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。

相关推荐