3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.3 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
38 * Generic function to compare expected values after an api call to retrieved
41 * @daoName string DAO Name of object we're evaluating.
42 * @id int Id of object
43 * @match array Associative array of field name => expected value. Empty if asserting
44 * that a DELETE occurred
45 * @delete boolean True if we're checking that a DELETE action occurred.
47 function assertDBState(&$testCase, $daoName, $id, $match, $delete = FALSE) {
49 // adding this here since developers forget to check for an id
50 // and hence we get the first value in the db
51 $testCase->fail('ID not populated. Please fix your assertDBState usage!!!');
54 require_once (str_replace('_', DIRECTORY_SEPARATOR
, $daoName) . ".php");
55 eval('$object = new ' . $daoName . '( );');
59 // If we're asserting successful record deletion, make sure object is NOT found.
61 if ($object->find(TRUE)) {
62 $testCase->fail("Object not deleted by delete operation: $daoName, $id");
67 // Otherwise check matches of DAO field values against expected values in $match.
68 if ($object->find(TRUE)) {
69 $fields = &$object->fields();
70 foreach ($fields as $name => $value) {
71 $dbName = $value['name'];
72 if (isset($match[$name])) {
74 $testCase->assertEquals($object->$dbName, $match[$name]);
76 elseif (isset($match[$dbName])) {
78 $testCase->assertEquals($object->$dbName, $match[$dbName]);
83 $testCase->fail("Could not retrieve object: $daoName, $id");
86 $matchSize = count($match);
87 if ($verifiedCount != $matchSize) {
88 $testCase->fail("Did not verify all fields in match array: $daoName, $id. Verified count = $verifiedCount. Match array size = $matchSize");
93 * Request a record from the DB by seachColumn+searchValue. Success if a record is found.
95 function assertDBNotNull(&$testCase, $daoName, $searchValue, $returnColumn, $searchColumn, $message) {
96 if (empty($searchValue)) {
97 $testCase->fail("empty value passed to assertDBNotNull");
99 $value = CRM_Core_DAO
::getFieldValue($daoName, $searchValue, $returnColumn, $searchColumn);
100 $testCase->assertNotNull($value, $message);
106 * Request a record from the DB by seachColumn+searchValue. Success if returnColumn value is NULL.
108 function assertDBNull(&$testCase, $daoName, $searchValue, $returnColumn, $searchColumn, $message) {
109 $value = CRM_Core_DAO
::getFieldValue($daoName, $searchValue, $returnColumn, $searchColumn);
110 $testCase->assertNull($value, $message);
114 * Request a record from the DB by id. Success if row not found.
116 function assertDBRowNotExist(&$testCase, $daoName, $id, $message) {
117 $value = CRM_Core_DAO
::getFieldValue($daoName, $id, 'id', 'id');
118 $testCase->assertNull($value, $message);
122 * Compare a single column value in a retrieved DB record to an expected value
124 function assertDBCompareValue(&$testCase, $daoName, $searchValue, $returnColumn, $searchColumn,
125 $expectedValue, $message
127 $value = CRM_Core_DAO
::getFieldValue($daoName, $searchValue, $returnColumn, $searchColumn);
128 $testCase->assertEquals($value, $expectedValue, $message);
132 * Compare all values in a single retrieved DB record to an array of expected values
134 function assertDBCompareValues(&$testCase, $daoName, $searchParams, $expectedValues) {
135 //get the values from db
137 CRM_Core_DAO
::commonRetrieve($daoName, $searchParams, $dbValues);
140 // compare db values with expected values
141 self
::assertAttributesEquals($testCase, $expectedValues, $dbValues);
144 function assertAttributesEquals(&$testCase, &$expectedValues, &$actualValues) {
145 foreach ($expectedValues as $paramName => $paramValue) {
146 if (isset($actualValues[$paramName])) {
147 $testCase->assertEquals($paramValue, $actualValues[$paramName]);
150 $testCase->fail("Attribute '$paramName' not present in actual array.");