单元测试

Mon, 01 Jan 0001 00:00:00 +0000

在 PHP SDK 中，单元测试和集成测试是非常重要的组成部分。通过使用依赖注入容器、模拟、存根以及提供的 \Dapr\Mocks\TestClient，可以实现非常精细的测试。

测试 Actor

在测试 Actor 时，我们主要关注两个方面：

基于初始状态的返回结果
基于初始状态的结果状态

以下是一个简单的 Actor 测试示例，该 Actor 会更新其状态并返回特定值：

<?php

// TestState.php

class TestState extends \Dapr\Actors\ActorState
{
 public int $number;
}

// TestActor.php

#[\Dapr\Actors\Attributes\DaprType('TestActor')]
class TestActor extends \Dapr\Actors\Actor
{
 public function __construct(string $id, private TestState $state)
 {
 parent::__construct($id);
 }

 public function oddIncrement(): bool
 {
 if ($this->state->number % 2 === 0) {
 return false;
 }
 $this->state->number += 1;

 return true;
 }
}

// TheTest.php

class TheTest extends \PHPUnit\Framework\TestCase
{
 private \DI\Container $container;

 public function setUp(): void
 {
 parent::setUp();
 // 创建一个默认应用并从中获取 DI 容器
 $app = \Dapr\App::create(
 configure: fn(\DI\ContainerBuilder $builder) => $builder->addDefinitions(
 ['dapr.actors' => [TestActor::class]],
 [\Dapr\DaprClient::class => \DI\autowire(\Dapr\Mocks\TestClient::class)]
 ));
 $app->run(fn(\DI\Container $container) => $this->container = $container);
 }

 public function testIncrementsWhenOdd()
 {
 $id = uniqid();
 $runtime = $this->container->get(\Dapr\Actors\ActorRuntime::class);
 $client = $this->getClient();

 // 模拟从 http://localhost:1313/reference/api/actors_api/ 获取当前状态
 $client->register_get("/actors/TestActor/$id/state/number", code: 200, data: 3);

 // 模拟从 http://localhost:1313/reference/api/actors_api/ 进行状态递增
 $client->register_post(
 "/actors/TestActor/$id/state",
 code: 204,
 response_data: null,
 expected_request: [
 [
 'operation' => 'upsert',
 'request' => [
 'key' => 'number',
 'value' => 4,
 ],
 ],
 ]
 );

 $result = $runtime->resolve_actor(
 'TestActor',
 $id,
 fn($actor) => $runtime->do_method($actor, 'oddIncrement', null)
 );
 $this->assertTrue($result);
 }

 private function getClient(): \Dapr\Mocks\TestClient
 {
 return $this->container->get(\Dapr\DaprClient::class);
 }
}

<?php

// TestState.php

class TestState extends \Dapr\Actors\ActorState
{
 public int $number;
}

// TestActor.php

#[\Dapr\Actors\Attributes\DaprType('TestActor')]
class TestActor extends \Dapr\Actors\Actor
{
 public function __construct(string $id, private TestState $state)
 {
 parent::__construct($id);
 }

 public function oddIncrement(): bool
 {
 if ($this->state->number % 2 === 0) {
 return false;
 }
 $this->state->number += 1;

 return true;
 }
}

// TheTest.php

class TheTest extends \PHPUnit\Framework\TestCase
{
 public function testNotIncrementsWhenEven() {
 $container = new \DI\Container();
 $state = new TestState($container, $container);
 $state->number = 4;
 $id = uniqid();
 $actor = new TestActor($id, $state);
 $this->assertFalse($actor->oddIncrement());
 $this->assertSame(4, $state->number);
 }
}

测试事务

在构建事务时，您可能需要测试如何处理失败的事务。为此，您需要注入故障并确保事务按预期进行。

应用程序 on Dapr 文档库

单元测试

测试 Actor

测试事务