Tests invocation of hooks when performing an action.
Tested hooks are:
As well as all type-specific hooks, like hook_node_insert(), hook_comment_update(), etc.
Expanded class hierarchy of EntityCrudHookTest
class EntityCrudHookTest extends EntityUnitTestBase {
/**
* Modules to enable.
*
* @var array
*/
public static $modules = array(
'block',
'block_test',
'entity_crud_hook_test',
'file',
'taxonomy',
'node',
'comment',
);
protected $ids = array();
public static function getInfo() {
return array(
'name' => 'Entity CRUD hooks',
'description' => 'Tests the invocation of hooks when creating, inserting, loading, updating or deleting an entity.',
'group' => 'Entity API',
);
}
public function setUp() {
parent::setUp();
$this
->installSchema('user', array(
'users_roles',
'users_data',
));
$this
->installSchema('node', array(
'node',
'node_field_data',
'node_field_revision',
'node_type',
'node_access',
));
$this
->installSchema('comment', array(
'comment',
'node_comment_statistics',
));
}
/**
* Checks the order of CRUD hook execution messages.
*
* entity_crud_hook_test.module implements all core entity CRUD hooks and
* stores a message for each in $_SESSION['entity_crud_hook_test'].
*
* @param $messages
* An array of plain-text messages in the order they should appear.
*/
protected function assertHookMessageOrder($messages) {
$positions = array();
foreach ($messages as $message) {
// Verify that each message is found and record its position.
$position = array_search($message, $_SESSION['entity_crud_hook_test']);
if ($this
->assertTrue($position !== FALSE, $message)) {
$positions[] = $position;
}
}
// Sort the positions and ensure they remain in the same order.
$sorted = $positions;
sort($sorted);
$this
->assertTrue($sorted == $positions, 'The hook messages appear in the correct order.');
}
/**
* Tests hook invocations for CRUD operations on blocks.
*/
public function testBlockHooks() {
$entity = entity_create('block', array(
'id' => 'stark.test_html_id',
'plugin' => 'test_html_id',
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_block_create called',
'entity_crud_hook_test_entity_create called for type block',
));
$_SESSION['entity_crud_hook_test'] = array();
$entity
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_block_presave called',
'entity_crud_hook_test_entity_presave called for type block',
'entity_crud_hook_test_block_insert called',
'entity_crud_hook_test_entity_insert called for type block',
));
$_SESSION['entity_crud_hook_test'] = array();
$entity = entity_load('block', $entity
->id());
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type block',
'entity_crud_hook_test_block_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$entity->label = 'New label';
$entity
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_block_presave called',
'entity_crud_hook_test_entity_presave called for type block',
'entity_crud_hook_test_block_update called',
'entity_crud_hook_test_entity_update called for type block',
));
$_SESSION['entity_crud_hook_test'] = array();
$entity
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_block_predelete called',
'entity_crud_hook_test_entity_predelete called for type block',
'entity_crud_hook_test_block_delete called',
'entity_crud_hook_test_entity_delete called for type block',
));
}
/**
* Tests hook invocations for CRUD operations on comments.
*/
public function testCommentHooks() {
$account = $this
->createUser();
$node = entity_create('node', array(
'uid' => $account->uid,
'type' => 'article',
'title' => 'Test node',
'status' => 1,
'comment' => 2,
'promote' => 0,
'sticky' => 0,
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
'created' => REQUEST_TIME,
'changed' => REQUEST_TIME,
));
$node
->save();
$nid = $node->nid;
$_SESSION['entity_crud_hook_test'] = array();
$comment = entity_create('comment', array(
'node_type' => 'node_type_' . $node
->bundle(),
'cid' => NULL,
'pid' => 0,
'nid' => $nid,
'uid' => $account->uid,
'subject' => 'Test comment',
'created' => REQUEST_TIME,
'changed' => REQUEST_TIME,
'status' => 1,
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_comment_create called',
'entity_crud_hook_test_entity_create called for type comment',
));
$_SESSION['entity_crud_hook_test'] = array();
$comment
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_comment_presave called',
'entity_crud_hook_test_entity_presave called for type comment',
'entity_crud_hook_test_comment_insert called',
'entity_crud_hook_test_entity_insert called for type comment',
));
$_SESSION['entity_crud_hook_test'] = array();
$comment = comment_load($comment
->id());
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type comment',
'entity_crud_hook_test_comment_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$comment->subject->value = 'New subject';
$comment
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_comment_presave called',
'entity_crud_hook_test_entity_presave called for type comment',
'entity_crud_hook_test_comment_update called',
'entity_crud_hook_test_entity_update called for type comment',
));
$_SESSION['entity_crud_hook_test'] = array();
$comment
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_comment_predelete called',
'entity_crud_hook_test_entity_predelete called for type comment',
'entity_crud_hook_test_comment_delete called',
'entity_crud_hook_test_entity_delete called for type comment',
));
}
/**
* Tests hook invocations for CRUD operations on files.
*/
public function testFileHooks() {
$this
->installSchema('file', array(
'file_managed',
'file_usage',
));
$url = 'public://entity_crud_hook_test.file';
file_put_contents($url, 'Test test test');
$file = entity_create('file', array(
'fid' => NULL,
'uid' => 1,
'filename' => 'entity_crud_hook_test.file',
'uri' => $url,
'filemime' => 'text/plain',
'filesize' => filesize($url),
'status' => 1,
'timestamp' => REQUEST_TIME,
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_file_create called',
'entity_crud_hook_test_entity_create called for type file',
));
$_SESSION['entity_crud_hook_test'] = array();
$file
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_file_presave called',
'entity_crud_hook_test_entity_presave called for type file',
'entity_crud_hook_test_file_insert called',
'entity_crud_hook_test_entity_insert called for type file',
));
$_SESSION['entity_crud_hook_test'] = array();
$file = file_load($file->fid);
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type file',
'entity_crud_hook_test_file_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$file->filename = 'new.entity_crud_hook_test.file';
$file
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_file_presave called',
'entity_crud_hook_test_entity_presave called for type file',
'entity_crud_hook_test_file_update called',
'entity_crud_hook_test_entity_update called for type file',
));
$_SESSION['entity_crud_hook_test'] = array();
$file
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_file_predelete called',
'entity_crud_hook_test_entity_predelete called for type file',
'entity_crud_hook_test_file_delete called',
'entity_crud_hook_test_entity_delete called for type file',
));
}
/**
* Tests hook invocations for CRUD operations on nodes.
*/
public function testNodeHooks() {
$account = $this
->createUser();
$node = entity_create('node', array(
'uid' => $account
->id(),
'type' => 'article',
'title' => 'Test node',
'status' => 1,
'comment' => 2,
'promote' => 0,
'sticky' => 0,
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
'created' => REQUEST_TIME,
'changed' => REQUEST_TIME,
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_node_create called',
'entity_crud_hook_test_entity_create called for type node',
));
$_SESSION['entity_crud_hook_test'] = array();
$node
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_node_presave called',
'entity_crud_hook_test_entity_presave called for type node',
'entity_crud_hook_test_node_insert called',
'entity_crud_hook_test_entity_insert called for type node',
));
$_SESSION['entity_crud_hook_test'] = array();
$node = node_load($node->nid);
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type node',
'entity_crud_hook_test_node_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$node->title = 'New title';
$node
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_node_presave called',
'entity_crud_hook_test_entity_presave called for type node',
'entity_crud_hook_test_node_update called',
'entity_crud_hook_test_entity_update called for type node',
));
$_SESSION['entity_crud_hook_test'] = array();
$node
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_node_predelete called',
'entity_crud_hook_test_entity_predelete called for type node',
'entity_crud_hook_test_node_delete called',
'entity_crud_hook_test_entity_delete called for type node',
));
}
/**
* Tests hook invocations for CRUD operations on taxonomy terms.
*/
public function testTaxonomyTermHooks() {
$this
->installSchema('taxonomy', array(
'taxonomy_term_data',
'taxonomy_term_hierarchy',
));
$vocabulary = entity_create('taxonomy_vocabulary', array(
'name' => 'Test vocabulary',
'vid' => 'test',
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
'description' => NULL,
'module' => 'entity_crud_hook_test',
));
$vocabulary
->save();
$_SESSION['entity_crud_hook_test'] = array();
$term = entity_create('taxonomy_term', array(
'vid' => $vocabulary
->id(),
'name' => 'Test term',
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
'description' => NULL,
'format' => 1,
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_term_create called',
'entity_crud_hook_test_entity_create called for type taxonomy_term',
));
$_SESSION['entity_crud_hook_test'] = array();
$term
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_term_presave called',
'entity_crud_hook_test_entity_presave called for type taxonomy_term',
'entity_crud_hook_test_taxonomy_term_insert called',
'entity_crud_hook_test_entity_insert called for type taxonomy_term',
));
$_SESSION['entity_crud_hook_test'] = array();
$term = taxonomy_term_load($term
->id());
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type taxonomy_term',
'entity_crud_hook_test_taxonomy_term_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$term->name = 'New name';
$term
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_term_presave called',
'entity_crud_hook_test_entity_presave called for type taxonomy_term',
'entity_crud_hook_test_taxonomy_term_update called',
'entity_crud_hook_test_entity_update called for type taxonomy_term',
));
$_SESSION['entity_crud_hook_test'] = array();
$term
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_term_predelete called',
'entity_crud_hook_test_entity_predelete called for type taxonomy_term',
'entity_crud_hook_test_taxonomy_term_delete called',
'entity_crud_hook_test_entity_delete called for type taxonomy_term',
));
}
/**
* Tests hook invocations for CRUD operations on taxonomy vocabularies.
*/
public function testTaxonomyVocabularyHooks() {
$this
->installSchema('taxonomy', array(
'taxonomy_term_data',
'taxonomy_term_hierarchy',
));
$vocabulary = entity_create('taxonomy_vocabulary', array(
'name' => 'Test vocabulary',
'vid' => 'test',
'langcode' => Language::LANGCODE_NOT_SPECIFIED,
'description' => NULL,
'module' => 'entity_crud_hook_test',
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_vocabulary_create called',
'entity_crud_hook_test_entity_create called for type taxonomy_vocabulary',
));
$_SESSION['entity_crud_hook_test'] = array();
$vocabulary
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_vocabulary_presave called',
'entity_crud_hook_test_entity_presave called for type taxonomy_vocabulary',
'entity_crud_hook_test_taxonomy_vocabulary_insert called',
'entity_crud_hook_test_entity_insert called for type taxonomy_vocabulary',
));
$_SESSION['entity_crud_hook_test'] = array();
$vocabulary = taxonomy_vocabulary_load($vocabulary
->id());
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type taxonomy_vocabulary',
'entity_crud_hook_test_taxonomy_vocabulary_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$vocabulary->name = 'New name';
$vocabulary
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_vocabulary_presave called',
'entity_crud_hook_test_entity_presave called for type taxonomy_vocabulary',
'entity_crud_hook_test_taxonomy_vocabulary_update called',
'entity_crud_hook_test_entity_update called for type taxonomy_vocabulary',
));
$_SESSION['entity_crud_hook_test'] = array();
$vocabulary
->delete();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_taxonomy_vocabulary_predelete called',
'entity_crud_hook_test_entity_predelete called for type taxonomy_vocabulary',
'entity_crud_hook_test_taxonomy_vocabulary_delete called',
'entity_crud_hook_test_entity_delete called for type taxonomy_vocabulary',
));
}
/**
* Tests hook invocations for CRUD operations on users.
*/
public function testUserHooks() {
$account = entity_create('user', array(
'name' => 'Test user',
'mail' => 'test@example.com',
'created' => REQUEST_TIME,
'status' => 1,
'language' => 'en',
));
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_user_create called',
'entity_crud_hook_test_entity_create called for type user',
));
$_SESSION['entity_crud_hook_test'] = array();
$account
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_user_presave called',
'entity_crud_hook_test_entity_presave called for type user',
'entity_crud_hook_test_user_insert called',
'entity_crud_hook_test_entity_insert called for type user',
));
$_SESSION['entity_crud_hook_test'] = array();
user_load($account->uid);
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_entity_load called for type user',
'entity_crud_hook_test_user_load called',
));
$_SESSION['entity_crud_hook_test'] = array();
$account->name = 'New name';
$account
->save();
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_user_presave called',
'entity_crud_hook_test_entity_presave called for type user',
'entity_crud_hook_test_user_update called',
'entity_crud_hook_test_entity_update called for type user',
));
$_SESSION['entity_crud_hook_test'] = array();
user_delete($account->uid);
$this
->assertHookMessageOrder(array(
'entity_crud_hook_test_user_predelete called',
'entity_crud_hook_test_entity_predelete called for type user',
'entity_crud_hook_test_user_delete called',
'entity_crud_hook_test_entity_delete called for type user',
));
}
/**
* Tests rollback from failed insert in EntityNG.
*/
function testEntityNGRollback() {
// Create a block.
try {
$entity = entity_create('entity_test', array(
'name' => 'fail_insert',
))
->save();
$this
->fail('Expected exception has not been thrown.');
} catch (\Exception $e) {
$this
->pass('Expected exception has been thrown.');
}
if (Database::getConnection()
->supportsTransactions()) {
// Check that the block does not exist in the database.
$ids = \Drupal::entityQuery('entity_test')
->condition('name', 'fail_insert')
->execute();
$this
->assertTrue(empty($ids), 'Transactions supported, and entity not found in database.');
}
else {
// Check that the block exists in the database.
$ids = \Drupal::entityQuery('entity_test')
->condition('name', 'fail_insert')
->execute();
$this
->assertFalse(empty($ids), 'Transactions not supported, and entity found in database.');
}
}
}
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
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:: |
||
EntityCrudHookTest:: |
protected | property | ||
EntityCrudHookTest:: |
public static | property |
Modules to enable. Overrides EntityUnitTestBase:: |
|
EntityCrudHookTest:: |
protected | function | Checks the order of CRUD hook execution messages. | |
EntityCrudHookTest:: |
public static | function | ||
EntityCrudHookTest:: |
public | function |
Sets up Drupal unit test environment. Overrides EntityUnitTestBase:: |
|
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on blocks. | |
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on comments. | |
EntityCrudHookTest:: |
function | Tests rollback from failed insert in EntityNG. | ||
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on files. | |
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on nodes. | |
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on taxonomy terms. | |
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on taxonomy vocabularies. | |
EntityCrudHookTest:: |
public | function | Tests hook invocations for CRUD operations on users. | |
EntityUnitTestBase:: |
protected | function | Creates a user. | |
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 |