# 实体事件
Testing Is Documentation
实体在新增和更新时,预植了事件监听器,可以定义一些事件。
Uses
<?php
use Leevel\Database\Ddd\Entity;
use Leevel\Di\Container;
use Leevel\Event\Dispatch;
use Tests\Database\DatabaseTestCase as TestCase;
use Tests\Database\Ddd\Entity\DemoEventEntity;
# 事件基本使用方法
public function testBaseUse(): void
{
$dispatch = new Dispatch(new Container());
$this->assertNull(Entity::eventDispatch());
Entity::withEventDispatch($dispatch);
$this->assertInstanceof(Dispatch::class, Entity::eventDispatch());
$test = new DemoEventEntity(['name' => 'foo']);
DemoEventEntity::event(Entity::BEFORE_CREATING_EVENT, function () {
$_SERVER['ENTITY.BEFORE_CREATING_EVENT'] = 'BEFORE_CREATING_EVENT';
});
DemoEventEntity::event(Entity::AFTER_CREATED_EVENT, function () {
$_SERVER['ENTITY.AFTER_CREATED_EVENT'] = 'AFTER_CREATED_EVENT';
});
$this->assertFalse(isset($_SERVER['ENTITY.BEFORE_CREATING_EVENT']));
$this->assertFalse(isset($_SERVER['ENTITY.AFTER_CREATED_EVENT']));
$test->create()->flush();
$this->assertTrue(isset($_SERVER['ENTITY.BEFORE_CREATING_EVENT']));
$this->assertTrue(isset($_SERVER['ENTITY.AFTER_CREATED_EVENT']));
$this->assertSame('BEFORE_CREATING_EVENT', $_SERVER['ENTITY.BEFORE_CREATING_EVENT']);
$this->assertSame('AFTER_CREATED_EVENT', $_SERVER['ENTITY.AFTER_CREATED_EVENT']);
unset($_SERVER['ENTITY.BEFORE_CREATING_EVENT'], $_SERVER['ENTITY.AFTER_CREATED_EVENT']);
}
# 实体支持的事件
# Tests\Database\Ddd\EntityEventTest::getSupportedEvent
public function getSupportedEvent()
{
return [
[Entity::BEFORE_SAVEING_EVENT],
[Entity::AFTER_SAVED_EVENT],
[Entity::BEFORE_CREATING_EVENT],
[Entity::AFTER_CREATED_EVENT],
[Entity::BEFORE_UPDATING_EVENT],
[Entity::AFTER_UPDATED_EVENT],
[Entity::BEFORE_DELETING_EVENT],
[Entity::AFTER_DELETED_EVENT],
[Entity::BEFORE_SOFT_DELETING_EVENT],
[Entity::AFTER_SOFT_DELETED_EVENT],
[Entity::BEFORE_SOFT_RESTORING_EVENT],
[Entity::AFTER_SOFT_RESTORED_EVENT],
];
}
public function testSupportEvent($event): void
{
$dispatch = new Dispatch(new Container());
$this->assertNull(Entity::eventDispatch());
Entity::withEventDispatch($dispatch);
$this->assertInstanceof(Dispatch::class, Entity::eventDispatch());
$supportEvent = DemoEventEntity::supportEvent();
$this->assertTrue(in_array($event, $supportEvent, true));
}
# 不受支持的事件
public function testEventWasNotSupport(): void
{
$this->expectException(\InvalidArgumentException::class);
$this->expectExceptionMessage('Event `not_support` do not support.');
$dispatch = new Dispatch(new Container());
$this->assertNull(Entity::eventDispatch());
Entity::withEventDispatch($dispatch);
$this->assertInstanceof(Dispatch::class, Entity::eventDispatch());
DemoEventEntity::event('not_support', function () {
});
}