From 7166c499c36344a36a18bfb17dcdeee79868b76b Mon Sep 17 00:00:00 2001
From: Zoilo Mora <zoilo.mora@hotmail.com>
Date: Thu, 28 May 2020 15:47:00 +0200
Subject: [PATCH] Usage examples

---
 README.md                                     | 44 +++++++++++++++++--
 .../Component/Messenger/ApmMiddleware.php     |  2 +-
 .../Component/Messenger/NameExtractor.php     |  2 +-
 3 files changed, 42 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 7fbbfd1..73bf4a2 100644
--- a/README.md
+++ b/README.md
@@ -14,15 +14,51 @@ This library supports Span traces of [Symfony Messenger](https://github.com/symf
 
 In all cases, an already created instance of [ElasticApmTracer](https://github.com/zoilomora/elastic-apm-agent-php) is assumed.
 
+### Native PHP
+
+```php
+<?php
+declare(strict_types=1);
+
+class TextNameExtractor implements PcComponentes\ElasticAPM\Symfony\Component\Messenger\NameExtractor
+{
+    public function execute($message): string
+    {
+        if (false === is_string($message)) {
+            throw new InvalidArgumentException('The parameter must be of type string');
+        }
+
+        return $message;
+    }
+}
+
+$apmMiddleware = new PcComponentes\ElasticAPM\Symfony\Component\Messenger\ApmMiddleware(
+    $apmTracer, /** \ZoiloMora\ElasticAPM\ElasticApmTracer instance. */
+    new TextNameExtractor(),
+);
+
+$bus = new Symfony\Component\Messenger\MessageBus([
+    $apmMiddleware
+]);
+```
+
 ### Service Container (Symfony)
 
 ```yaml
-PcComponentes\ElasticAPM\Symfony\Component\HttpKernel\EventSubscriber:
-  class: PcComponentes\ElasticAPM\Symfony\Component\HttpKernel\EventSubscriber
-  autoconfigure: true
+app.bus:
+  class: Symfony\Component\Messenger\MessageBus
+  arguments:
+    $middlewareHandlers:
+      - '@app.bus.middleware.apm'
+
+app.bus.middleware.apm:
+  class: PcComponentes\ElasticAPM\Symfony\Component\Messenger\ApmMiddleware
   arguments:
-    $router: '@router'
     $elasticApmTracer: '@apm.tracer' # \ZoiloMora\ElasticAPM\ElasticApmTracer instance.
+    $nameExtractor: '@app.bus.middleware.apm.name_extractor'
+
+app.bus.middleware.apm.name_extractor:
+  class: ExampleTextNameExtractor
 ```
 
 ## License
diff --git a/src/Symfony/Component/Messenger/ApmMiddleware.php b/src/Symfony/Component/Messenger/ApmMiddleware.php
index 5c20f9c..475e96c 100644
--- a/src/Symfony/Component/Messenger/ApmMiddleware.php
+++ b/src/Symfony/Component/Messenger/ApmMiddleware.php
@@ -1,7 +1,7 @@
 <?php
 declare(strict_types=1);
 
-namespace Pcc\ApiLegacyBridge\Util\ElasticAPM\Messenger;
+namespace PcComponentes\ElasticAPM\Symfony\Component\Messenger;
 
 use Symfony\Component\Messenger\Envelope;
 use Symfony\Component\Messenger\Middleware\MiddlewareInterface;
diff --git a/src/Symfony/Component/Messenger/NameExtractor.php b/src/Symfony/Component/Messenger/NameExtractor.php
index 3308992..d2da939 100644
--- a/src/Symfony/Component/Messenger/NameExtractor.php
+++ b/src/Symfony/Component/Messenger/NameExtractor.php
@@ -1,7 +1,7 @@
 <?php
 declare(strict_types=1);
 
-namespace Pcc\ApiLegacyBridge\Util\ElasticAPM\Messenger;
+namespace PcComponentes\ElasticAPM\Symfony\Component\Messenger;
 
 interface NameExtractor
 {