BC: Update HandlerInterface and implementations to include the method name in the handle signature

Author: pioniro

README.md

@@ -2,7 +2,7 @@ WrapperBundle
 =====
 This is a wrapper bundle for the [Symfony](https://symfony.com) framework.
 
-Main goal of this bundle is to provide a simple way to create a wrappers for the services.
+The main goal of this bundle is to provide a simple way to create a wrappers for the services.
 
 Under the hood, this bundle performs code generation similar to how Doctrine does for entity proxying.
 
@@ -34,7 +34,7 @@ class LogExceptionHandler implements \Pioniro\WrapperBundle\HandlerInterface
 {
     public function __construct(private \Psr\Log\LoggerInterface $logger) {}
 
-    public function handle(callable $next, array $args, AnnotationInterface $annotation): callable
+    public function handle(callable $next, string $method, array $args, AnnotationInterface $annotation): callable
     {
         return function ($input) use ($next) {
             try{
@@ -102,4 +102,4 @@ You can create as many handlers as you want and use them in your services.
 - Handlers are not called for methods of the final classes.
 - Handlers are not called for methods of the classes that are not in the container.
 - May occur strange errors if you use `static` keyword (for example in the Command) in the annotated hierarchy.
-- Using other annotations in the same class may lead to unexpected behavior (e.g. if you use `@Route` or `@Template` annotations in the same class, these annotation may not work as expected)
+- Using other annotations in the same class may lead to unexpected behavior (e.g., if you use `@Route` or `@Template` annotations in the same class, these annotations may not work as expected)

examples/simple/src/SomeAnnotationHandler.php

@@ -9,10 +9,11 @@
 
 class SomeAnnotationHandler implements HandlerInterface
 {
-    public function handle(callable $next, array $args, AnnotationInterface $annotation): callable
+    public function handle(callable $next, string $method, array $args, AnnotationInterface $annotation): callable
     {
         \assert($annotation instanceof SomeAnnotation);
         dump(__CLASS__ . ':: BEFORE');
+        dump($method . ':: METHOD');
         dump(__CLASS__ . ':: passed value:' . $annotation->value);
 
         return function () use ($next) {

src/HandlerInterface.php

@@ -6,7 +6,7 @@
 
 interface HandlerInterface
 {
-    public function handle(callable $next, array $args, AnnotationInterface $annotation): callable;
+    public function handle(callable $next, string $method, array $args, AnnotationInterface $annotation): callable;
 
     public static function handledClass(): string;
 }

src/Service/WrapperFactory.php

@@ -45,7 +45,7 @@ public function __addHandler(string $method, \Pioniro\WrapperBundle\HandlerInter
                 $annotation = unserialize($annotation);
                 $h[1] = $annotation;
             }
-            $f = $handler->handle($f, $args, $annotation);
+            $f = $handler->handle($f, __METHOD__, $args, $annotation);
         }
         return $f();
     }
@@ -58,7 +58,7 @@ public function <methodName>(<methodParameters>) <methodReturnType>
         $args = func_get_args();
 
         foreach ($this->__handlers['<methodName>'] ?? [] as [$handler, $annotation]) {
-            $f = $handler->handle($f, $args, $annotation);
+            $f = $handler->handle($f, __METHOD__, $args, $annotation);
         }
         $f();
     }

tests/Service/WrapperFactoryTest.php

@@ -51,7 +51,7 @@ public function __construct(\Closure $f)
         $this->f = $f;
     }
 
-    public function handle(callable $next, array $args, AnnotationInterface $annotation): callable
+    public function handle(callable $next, string $method, array $args, AnnotationInterface $annotation): callable
     {
         return fn () => ($this->f)($next(), $annotation);
     }