Tests the MERGE query builder.
Expanded class hierarchy of MergeTest
class MergeTest extends DatabaseTestBase {
public static function getInfo() {
return array(
'name' => 'Merge tests',
'description' => 'Test the Merge query builder.',
'group' => 'Database',
);
}
/**
* Confirms that we can merge-insert a record successfully.
*/
function testMergeInsert() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$result = db_merge('test_people')
->key(array(
'job' => 'Presenter',
))
->fields(array(
'age' => 31,
'name' => 'Tiffany',
))
->execute();
$this
->assertEqual($result, Merge::STATUS_INSERT, 'Insert status returned.');
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before + 1, $num_records_after, 'Merge inserted properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Presenter',
))
->fetch();
$this
->assertEqual($person->name, 'Tiffany', 'Name set correctly.');
$this
->assertEqual($person->age, 31, 'Age set correctly.');
$this
->assertEqual($person->job, 'Presenter', 'Job set correctly.');
}
/**
* Confirms that we can merge-update a record successfully.
*/
function testMergeUpdate() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$result = db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->fields(array(
'age' => 31,
'name' => 'Tiffany',
))
->execute();
$this
->assertEqual($result, Merge::STATUS_UPDATE, 'Update status returned.');
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge updated properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Tiffany', 'Name set correctly.');
$this
->assertEqual($person->age, 31, 'Age set correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job set correctly.');
}
/**
* Confirms that we can merge-update a record successfully.
*
* This test varies from the previous test because it manually defines which
* fields are inserted, and which fields are updated.
*/
function testMergeUpdateExcept() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->insertFields(array(
'age' => 31,
))
->updateFields(array(
'name' => 'Tiffany',
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge updated properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Tiffany', 'Name set correctly.');
$this
->assertEqual($person->age, 30, 'Age skipped correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job set correctly.');
}
/**
* Confirms that we can merge-update a record, with alternate replacement.
*/
function testMergeUpdateExplicit() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->insertFields(array(
'age' => 31,
'name' => 'Tiffany',
))
->updateFields(array(
'name' => 'Joe',
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge updated properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Joe', 'Name set correctly.');
$this
->assertEqual($person->age, 30, 'Age skipped correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job set correctly.');
}
/**
* Confirms that we can merge-update a record successfully, with expressions.
*/
function testMergeUpdateExpression() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$age_before = db_query('SELECT age FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetchField();
// This is a very contrived example, as I have no idea why you'd want to
// change age this way, but that's beside the point.
// Note that we are also double-setting age here, once as a literal and
// once as an expression. This test will only pass if the expression wins,
// which is what is supposed to happen.
db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->fields(array(
'name' => 'Tiffany',
))
->insertFields(array(
'age' => 31,
))
->expression('age', 'age + :age', array(
':age' => 4,
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge updated properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Tiffany', 'Name set correctly.');
$this
->assertEqual($person->age, $age_before + 4, 'Age updated correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job set correctly.');
}
/**
* Tests that we can merge-insert without any update fields.
*/
function testMergeInsertWithoutUpdate() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
db_merge('test_people')
->key(array(
'job' => 'Presenter',
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before + 1, $num_records_after, 'Merge inserted properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Presenter',
))
->fetch();
$this
->assertEqual($person->name, '', 'Name set correctly.');
$this
->assertEqual($person->age, 0, 'Age set correctly.');
$this
->assertEqual($person->job, 'Presenter', 'Job set correctly.');
}
/**
* Confirms that we can merge-update without any update fields.
*/
function testMergeUpdateWithoutUpdate() {
$num_records_before = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge skipped properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Meredith', 'Name skipped correctly.');
$this
->assertEqual($person->age, 30, 'Age skipped correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job skipped correctly.');
db_merge('test_people')
->key(array(
'job' => 'Speaker',
))
->insertFields(array(
'age' => 31,
))
->execute();
$num_records_after = db_query('SELECT COUNT(*) FROM {test_people}')
->fetchField();
$this
->assertEqual($num_records_before, $num_records_after, 'Merge skipped properly.');
$person = db_query('SELECT * FROM {test_people} WHERE job = :job', array(
':job' => 'Speaker',
))
->fetch();
$this
->assertEqual($person->name, 'Meredith', 'Name skipped correctly.');
$this
->assertEqual($person->age, 30, 'Age skipped correctly.');
$this
->assertEqual($person->job, 'Speaker', 'Job skipped correctly.');
}
/**
* Tests that an invalid merge query throws an exception.
*/
function testInvalidMerge() {
try {
// This query will fail because there is no key field specified.
// Normally it would throw an exception but we are supressing it with
// the throw_exception option.
$options['throw_exception'] = FALSE;
db_merge('test_people', $options)
->fields(array(
'age' => 31,
'name' => 'Tiffany',
))
->execute();
$this
->pass('$options[\'throw_exception\'] is FALSE, no InvalidMergeQueryException thrown.');
} catch (InvalidMergeQueryException $e) {
$this
->fail('$options[\'throw_exception\'] is FALSE, but InvalidMergeQueryException thrown for invalid query.');
return;
}
try {
// This query will fail because there is no key field specified.
db_merge('test_people')
->fields(array(
'age' => 31,
'name' => 'Tiffany',
))
->execute();
} catch (InvalidMergeQueryException $e) {
$this
->pass('InvalidMergeQueryException thrown for invalid query.');
return;
}
$this
->fail('No InvalidMergeQueryException thrown');
}
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DatabaseTestBase:: |
public static | property |
Modules to enable. Overrides DrupalUnitTestBase:: |
3 |
DatabaseTestBase:: |
static | function | Sets up our sample data. | |
DatabaseTestBase:: |
function | Sets up tables for NULL handling. | ||
DatabaseTestBase:: |
function |
Sets up Drupal unit test environment. Overrides DrupalUnitTestBase:: |
||
DrupalUnitTestBase:: |
protected | property | A KeyValueMemoryFactory instance to use when building the container. | |
DrupalUnitTestBase:: |
private | property | ||
DrupalUnitTestBase:: |
private | property | ||
DrupalUnitTestBase:: |
private | property | ||
DrupalUnitTestBase:: |
public | function | Sets up the base service container for this test. | 1 |
DrupalUnitTestBase:: |
protected | function | Disables modules for this test. | |
DrupalUnitTestBase:: |
protected | function | Enables modules for this test. | |
DrupalUnitTestBase:: |
protected | function | Installs default configuration for a given list of modules. | |
DrupalUnitTestBase:: |
protected | function | Installs a specific table from a module schema definition. | |
DrupalUnitTestBase:: |
protected | function |
Deletes created files, database tables, and reverts all environment changes. Overrides TestBase:: |
2 |
DrupalUnitTestBase:: |
function |
Overrides \Drupal\simpletest\UnitTestBase::__construct(). Overrides UnitTestBase:: |
||
MergeTest:: |
public static | function | ||
MergeTest:: |
function | Tests that an invalid merge query throws an exception. | ||
MergeTest:: |
function | Confirms that we can merge-insert a record successfully. | ||
MergeTest:: |
function | Tests that we can merge-insert without any update fields. | ||
MergeTest:: |
function | Confirms that we can merge-update a record successfully. | ||
MergeTest:: |
function | Confirms that we can merge-update a record successfully. | ||
MergeTest:: |
function | Confirms that we can merge-update a record, with alternate replacement. | ||
MergeTest:: |
function | Confirms that we can merge-update a record successfully, with expressions. | ||
MergeTest:: |
function | Confirms that we can merge-update without any update fields. | ||
TestBase:: |
protected | property | Assertions thrown in that test case. | |
TestBase:: |
protected | property | The config importer that can used in a test. | 1 |
TestBase:: |
protected | property | The dependency injection container used in the test. | 1 |
TestBase:: |
protected | property | The database prefix of this test run. | |
TestBase:: |
public | property | Whether to die in case any test assertion fails. | |
TestBase:: |
protected | property | The original file directory, before it was changed for testing purposes. | |
TestBase:: |
protected | property | The original database prefix when running inside Simpletest. | |
TestBase:: |
protected | property | The settings array. | |
TestBase:: |
protected | property | The public file directory for the test environment. | |
TestBase:: |
public | property | Current results of this test case. | |
TestBase:: |
protected | property | Flag to indicate whether the test has been set up. | |
TestBase:: |
protected | property | ||
TestBase:: |
protected | property | ||
TestBase:: |
protected | property | This class is skipped when looking for the source of an assertion. | |
TestBase:: |
protected | property | The test run ID. | |
TestBase:: |
protected | property | Time limit for the test. | |
TestBase:: |
protected | property | TRUE if verbose debugging is enabled. | |
TestBase:: |
protected | property | Safe class name for use in verbose output filenames. | |
TestBase:: |
protected | property | Directory where verbose output files are put. | |
TestBase:: |
protected | property | URL to the verbose output file directory. | |
TestBase:: |
protected | property | Incrementing identifier for verbose output filenames. | |
TestBase:: |
protected | function | Internal helper: stores the assert. | |
TestBase:: |
protected | function | Check to see if two values are equal. | |
TestBase:: |
protected | function | Check to see if a value is false (an empty string, 0, NULL, or FALSE). | |
TestBase:: |
protected | function | Check to see if two values are identical. | |
TestBase:: |
protected | function | Checks to see if two objects are identical. | |
TestBase:: |
protected | function | Check to see if two values are not equal. | |
TestBase:: |
protected | function | Check to see if two values are not identical. | |
TestBase:: |
protected | function | Check to see if a value is not NULL. | |
TestBase:: |
protected | function | Check to see if a value is NULL. | |
TestBase:: |
protected | function | Check to see if a value is not false (not an empty string, 0, NULL, or FALSE). | |
TestBase:: |
protected | function | Changes the database connection to the prefixed one. | |
TestBase:: |
protected | function | Checks the matching requirements for Test. | 4 |
TestBase:: |
public | function | Returns a ConfigImporter object to import test importing of configuration. | 1 |
TestBase:: |
public | function | Copies configuration objects from source storage to target storage. | |
TestBase:: |
public static | function | Delete an assertion record by message ID. | |
TestBase:: |
protected | function | Fire an error assertion. | 1 |
TestBase:: |
public | function | Handle errors during test runs. | |
TestBase:: |
protected | function | Handle exceptions. | |
TestBase:: |
protected | function | Fire an assertion that is always negative. | |
TestBase:: |
public static | function | Ensures test files are deletable within file_unmanaged_delete_recursive(). | |
TestBase:: |
public static | function | Converts a list of possible parameters into a stack of permutations. | |
TestBase:: |
protected | function | Cycles through backtrace until the first non-assertion method is found. | |
TestBase:: |
public static | function | Returns the database connection to the site running Simpletest. | |
TestBase:: |
public static | function | Store an assertion from outside the testing context. | |
TestBase:: |
protected | function | Fire an assertion that is always positive. | |
TestBase:: |
protected | function | Create and set new configuration directories. | 1 |
TestBase:: |
protected | function | Generates a database prefix for running tests. | |
TestBase:: |
protected | function | Prepares the current environment for running the test. | |
TestBase:: |
public static | function | Generates a random string containing letters and numbers. | |
TestBase:: |
public static | function | Generates a random PHP object. | |
TestBase:: |
public static | function | Generates a random string of ASCII characters of codes 32 to 126. | |
TestBase:: |
protected | function | Rebuild drupal_container(). | 1 |
TestBase:: |
public | function | Run all tests in this class. | |
TestBase:: |
protected | function | Changes in memory settings. | |
TestBase:: |
protected | function | Logs verbose message in a text file. | |
UnitTestBase:: |
protected | property |