php接口断言,数据库断言 API

数据库断言 API

作为测试工具，数据库扩展模块理所当然会提供一些断言，可以用来验证数据库的当前状态、表的当前状态、表中数据行的数量。本节将详细描述这部分功能：

对表中数据行的数量作出断言

很多时候，确认表中是否包含特定数量的数据行是非常有帮助的。可以轻松做到这一点，不需要任何额外的使用连接 API 的粘合剂代码。比如说，在往留言本中插入一个新行之后，想要确认在表中除了之前的例子中一直都有的两行之外还有第三行：

class GuestbookTest extends PHPUnit_Extensions_Database_TestCase

{

public function testAddEntry()

{

$this->assertEquals(2, $this->getConnection()->getRowCount('guestbook'), "Pre-Condition");

$guestbook = new Guestbook();

$guestbook->addEntry("suzy", "Hello world!");

$this->assertEquals(3, $this->getConnection()->getRowCount('guestbook'), "Inserting failed");

}

}

?>

对表的状态作出断言

前面的这个断言很有帮助，但是肯定还想要检验表的实际内容，好核实是否所有值都写到了正确的列中。可以通过表断言来做到这一点。

为此，先定义一个 QueryTable 实例，从表名称和 SQL 查询派生出其内容，随后将其与一个基于文件/数组的数据集进行比较：

class GuestbookTest extends PHPUnit_Extensions_Database_TestCase

{

public function testAddEntry()

{

$guestbook = new Guestbook();

$guestbook->addEntry("suzy", "Hello world!");

$queryTable = $this->getConnection()->createQueryTable(

'guestbook', 'SELECT * FROM guestbook'

);

$expectedTable = $this->createFlatXmlDataSet("expectedBook.xml")

->getTable("guestbook");

$this->assertTablesEqual($expectedTable, $queryTable);

}

}

?>

现在需要为这个断言编写Flat XML 文件 expectedBook.xml：

在整个时间长河中，只有特定的一秒钟内这个断言可以通过评定，在 2010–05–01 21:47:08。在数据库测试中，日期构成了一个特殊的问题。可以从这个断言中省略 “created” 列来规避失败。

为了让断言能得以通过， Flat XML 文件 expectedBook.xml 需要调整成大致类似这样：

还得修正一下 QueryTable 的调用：

$queryTable = $this->getConnection()->createQueryTable(

'guestbook', 'SELECT id, content, user FROM guestbook'

);

?>

对查询的结果作出断言

利用 QueryTable，也可以对复杂查询的结果作出断言，只需要指定查询以及结果名称，并随后将其与某个数据集进行比较：

class ComplexQueryTest extends PHPUnit_Extensions_Database_TestCase

{

public function testComplexQuery()

{

$queryTable = $this->getConnection()->createQueryTable(

'myComplexQuery', 'SELECT complexQuery...'

);

$expectedTable = $this->createFlatXmlDataSet("complexQueryAssertion.xml")

->getTable("myComplexQuery");

$this->assertTablesEqual($expectedTable, $queryTable);

}

}

?>

对多个表的状态作出断言

当然可以一次性对多个表的状态作出断言，并将查询数据集与基于文件的数据集进行比较。有两种不同的方式来进行数据集断言。

可以从自数据库连接建立数据库数据集，并将其与基于文件的数据集进行比较。<?php

class DataSetAssertionsTest extends PHPUnit_Extensions_Database_TestCase

{

public function testCreateDataSetAssertion()

{

$dataSet = $this->getConnection()->createDataSet(array('guestbook'));

$expectedDataSet = $this->createFlatXmlDataSet('guestbook.xml');

$this->assertDataSetsEqual($expectedDataSet, $dataSet);

}

}

?>

也可以自行构造数据集：<?php

class DataSetAssertionsTest extends PHPUnit_Extensions_Database_TestCase

{

public function testManualDataSetAssertion()

{

$dataSet = new PHPUnit_Extensions_Database_DataSet_QueryDataSet();

$dataSet->addTable('guestbook', 'SELECT id, content, user FROM guestbook'); // additional tables

$expectedDataSet = $this->createFlatXmlDataSet('guestbook.xml');

$this->assertDataSetsEqual($expectedDataSet, $dataSet);

}

}

?>