[Messenger] add handler description as array key to HandlerFailedException::getWrappedExceptions()

kbond · kbond · commit dcc788d7485d · 2023-10-23T12:57:23.000-04:00
diff --git a/src/Symfony/Component/Messenger/CHANGELOG.md b/src/Symfony/Component/Messenger/CHANGELOG.md
@@ -12,6 +12,7 @@ CHANGELOG
  * Add `WrappedExceptionsInterface` interface for exceptions that hold multiple individual exceptions
  * Deprecate `HandlerFailedException::getNestedExceptions()`, `HandlerFailedException::getNestedExceptionsOfClass()`
    and `DelayedMessageHandlingException::getExceptions()` which are replaced by a new `getWrappedExceptions()` method
+ * Add handler description as array key to `HandlerFailedException::getWrappedExceptions()`
 
 6.3
 ---
diff --git a/src/Symfony/Component/Messenger/Exception/HandlerFailedException.php b/src/Symfony/Component/Messenger/Exception/HandlerFailedException.php
@@ -20,7 +20,7 @@ class HandlerFailedException extends RuntimeException implements WrappedExceptio
     private Envelope $envelope;
 
     /**
-     * @param \Throwable[] $exceptions
+     * @param array<string, \Throwable> $exceptions The name of the handler should be given as key
      */
     public function __construct(Envelope $envelope, array $exceptions)
     {
@@ -55,7 +55,7 @@ public function getNestedExceptions(): array
     {
         trigger_deprecation('symfony/messenger', '6.4', 'The "%s()" method is deprecated, use "%s::getWrappedExceptions()" instead.', __METHOD__, self::class);
 
-        return $this->exceptions;
+        return array_values($this->exceptions);
     }
 
     /**
diff --git a/src/Symfony/Component/Messenger/Middleware/HandleMessageMiddleware.php b/src/Symfony/Component/Messenger/Middleware/HandleMessageMiddleware.php
@@ -66,7 +66,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope
                 if ($batchHandler && $ackStamp = $envelope->last(AckStamp::class)) {
                     $ack = new Acknowledger(get_debug_type($batchHandler), static function (\Throwable $e = null, $result = null) use ($envelope, $ackStamp, $handlerDescriptor) {
                         if (null !== $e) {
-                            $e = new HandlerFailedException($envelope, [$e]);
+                            $e = new HandlerFailedException($envelope, [$handlerDescriptor->getName() => $e]);
                         } else {
                             $envelope = $envelope->with(HandledStamp::fromDescriptor($handlerDescriptor, $result));
                         }
@@ -95,7 +95,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope
                 $envelope = $envelope->with($handledStamp);
                 $this->logger?->info('Message {class} handled by {handler}', $context + ['handler' => $handledStamp->getHandlerName()]);
             } catch (\Throwable $e) {
-                $exceptions[] = $e;
+                $exceptions[$handlerDescriptor->getName()] = $e;
             }
         }
 
@@ -107,7 +107,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope
                     $handler = $stamp->getHandlerDescriptor()->getBatchHandler();
                     $handler->flush($flushStamp->force());
                 } catch (\Throwable $e) {
-                    $exceptions[] = $e;
+                    $exceptions[$stamp->getHandlerDescriptor()->getName()] = $e;
                 }
             }
         }
diff --git a/src/Symfony/Component/Messenger/Tests/Middleware/HandleMessageMiddlewareTest.php b/src/Symfony/Component/Messenger/Tests/Middleware/HandleMessageMiddlewareTest.php
@@ -47,6 +47,31 @@ public function testItCallsTheHandlerAndNextMiddleware()
         $middleware->handle($envelope, $this->getStackMock());
     }
 
+    public function testItKeysTheHandlerFailedNestedExceptionsByHandlerDescription()
+    {
+        $message = new DummyMessage('Hey');
+        $envelope = new Envelope($message);
+        $handler = new FailingHandleMessageMiddlewareTestCallable();
+
+        $middleware = new HandleMessageMiddleware(new HandlersLocator([
+            DummyMessage::class => [$handler],
+        ]));
+
+        try {
+            $middleware->handle($envelope, $this->getStackMock(false));
+        } catch (HandlerFailedException $e) {
+            $key = (new HandlerDescriptor($handler))->getName();
+
+            $this->assertCount(1, $e->getWrappedExceptions());
+            $this->assertArrayHasKey($key, $e->getWrappedExceptions());
+            $this->assertSame('failed', $e->getWrappedExceptions()[$key]->getMessage());
+
+            return;
+        }
+
+        $this->fail('Exception not thrown.');
+    }
+
     /**
      * @dataProvider itAddsHandledStampsProvider
      */
@@ -335,6 +360,14 @@ public function __invoke()
     }
 }
 
+class FailingHandleMessageMiddlewareTestCallable
+{
+    public function __invoke()
+    {
+        throw new \Exception('failed');
+    }
+}
+
 class HandleMessageMiddlewareNamedArgumentTestCallable
 {
     public function __invoke(object $message, $namedArgument)

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@ class HandlerFailedException extends RuntimeException implements WrappedExceptio`
`20`	`20`	`private Envelope $envelope;`
`21`	`21`
`22`	`22`	`/**`
`23`		`- * @param \Throwable[] $exceptions`
	`23`	`+ * @param array<string, \Throwable> $exceptions The name of the handler should be given as key`
`24`	`24`	`*/`
`25`	`25`	`public function __construct(Envelope $envelope, array $exceptions)`
`26`	`26`	`{`
`@@ -55,7 +55,7 @@ public function getNestedExceptions(): array`
`55`	`55`	`{`
`56`	`56`	`trigger_deprecation('symfony/messenger', '6.4', 'The "%s()" method is deprecated, use "%s::getWrappedExceptions()" instead.', __METHOD__, self::class);`
`57`	`57`
`58`		`- return $this->exceptions;`
	`58`	`+ return array_values($this->exceptions);`
`59`	`59`	`}`
`60`	`60`
`61`	`61`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -66,7 +66,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope`
`66`	`66`	`if ($batchHandler && $ackStamp = $envelope->last(AckStamp::class)) {`
`67`	`67`	`$ack = new Acknowledger(get_debug_type($batchHandler), static function (\Throwable $e = null, $result = null) use ($envelope, $ackStamp, $handlerDescriptor) {`
`68`	`68`	`if (null !== $e) {`
`69`		`- $e = new HandlerFailedException($envelope, [$e]);`
	`69`	`+ $e = new HandlerFailedException($envelope, [$handlerDescriptor->getName() => $e]);`
`70`	`70`	`} else {`
`71`	`71`	`$envelope = $envelope->with(HandledStamp::fromDescriptor($handlerDescriptor, $result));`
`72`	`72`	`}`
`@@ -95,7 +95,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope`
`95`	`95`	`$envelope = $envelope->with($handledStamp);`
`96`	`96`	`$this->logger?->info('Message {class} handled by {handler}', $context + ['handler' => $handledStamp->getHandlerName()]);`
`97`	`97`	`} catch (\Throwable $e) {`
`98`		`- $exceptions[] = $e;`
	`98`	`+ $exceptions[$handlerDescriptor->getName()] = $e;`
`99`	`99`	`}`
`100`	`100`	`}`
`101`	`101`
`@@ -107,7 +107,7 @@ public function handle(Envelope $envelope, StackInterface $stack): Envelope`
`107`	`107`	`$handler = $stamp->getHandlerDescriptor()->getBatchHandler();`
`108`	`108`	`$handler->flush($flushStamp->force());`
`109`	`109`	`} catch (\Throwable $e) {`
`110`		`- $exceptions[] = $e;`
	`110`	`+ $exceptions[$stamp->getHandlerDescriptor()->getName()] = $e;`
`111`	`111`	`}`
`112`	`112`	`}`
`113`	`113`	`}`