document ServiceSubscriberTrait

kbond · kbond · commit 2b9e556dbe2a · 2018-05-31T09:12:40.000-04:00
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
@@ -368,3 +368,46 @@ Now you can use the service locator by injecting it in any other service:
     better to create and inject it as an anonymous service.
 
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern
+
+Service Subscriber Trait
+------------------------
+
+.. versionadded:: 4.2
+    The :class:`Symfony\\Component\\DependencyInjection\\ServiceSubscriberTrait`
+    was introduced in Symfony 4.2.
+
+The :class:`Symfony\\Component\\DependencyInjection\\ServiceSubscriberTrait`
+provides an implementation for
+:class:`Symfony\\Component\\DependencyInjection\\ServiceSubscriberInterface`
+that looks through all methods in your class that have no arguments and a return
+type. It provides a ``ServiceLocator`` for the services of those return types.
+The service id is ``__METHOD__``::
+
+    // src/Service/MyService.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\ServiceSubscriberInterface;
+    use Symfony\Component\DependencyInjection\ServiceSubscriberTrait;
+    use Symfony\Component\Routing\RouterInterface;
+
+    class MyService implements ServiceSubscriberInterface
+    {
+        use ServiceSubscriberTrait;
+
+        public function doSomething()
+        {
+            // $this->router() ...
+            // $this->logger() ...
+        }
+
+        private function router(): RouterInterface
+        {
+            return $this->container->get(__METHOD__);
+        }
+
+        private function logger(): LoggerInterface
+        {
+            return $this->container->get(__METHOD__);
+        }
+    }
