Update to new version of the class

Author: alexander-schranz

components/http_foundation.rst

@@ -636,39 +636,59 @@ Streaming a JSON Response
 
 .. versionadded:: 6.2
 
-The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class allows
-an API to return a lot of data as JSON and keep the used resources low by make usage
-of Generators.
+The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
+introduced in Symfony 6.2. It allows an API to return a lot of data as JSON and keep
+the used resources low by make usage of Generators.
 
-It expects a JSON structure with one or multiple replacers identifiers, as example
-the `'__articles__'`. As a second argument it requires one or multiple Generators
-which items can be converted to a JSON via ``json_encode`` method. The key of the
-Generators requires to be the used replacer identifiers::
+It expects an array which represents the JSON structure and the list which should be
+streamed are represented in the array as ``\Generator``. The response will stream this
+JSON with generators in to most efficient way and keep resources as low as possible::
 
     use Symfony\Component\HttpFoundation\StreamedJsonResponse;
 
+    function loadArticles(): \Generator { // any method or function returning a Generator
+         yield ['title' => 'Article 1'];
+         yield ['title' => 'Article 2'];
+         yield ['title' => 'Article 3'];
+    });
+
     $response = new StreamedJsonResponse(
-        // json structure with replace identifiers
+        // json structure with generators in which will be streamed as a list
         [
             '_embedded' => [
-                'articles' => '__articles__',
+                'articles' => loadArticles(), // any \Generator can be used which will be streamed as list of data
             ],
         ],
-        // array of generators with replace identifier used as key
-        [
-            '__articles__' => (function (): \Generator { // any method or function returning a Generator
-                 yield ['title' => 'Article 1'];
-                 yield ['title' => 'Article 2'];
-                 yield ['title' => 'Article 3'];
-            })(),
-        ]
     );
 
 .. tip::
 
     If loading data via doctrine the ``toIterable`` method of ``Doctrine`` can be
     used to keep also the resources low and fetch only one row one by one.
-    See the `Doctrine Batch processing`_ documentation for more.
+    See the `Doctrine Batch processing`_ documentation for more::
+
+        public function __invoke(): Response
+        {
+            return new StreamedJsonResponse(
+                [
+                    '_embedded' => [
+                        'articles' => $this->loadArticles(),
+                    ],
+                ],
+            );
+        }
+
+        public function loadArticles(): \Generator
+        {
+            $queryBuilder = $entityManager->createQueryBuilder();
+            $queryBuilder->from(Article::class, 'article');
+            $queryBuilder->select('article.id')
+                ->addSelect('article.title')
+                ->addSelect('article.description');
+
+            return $queryBuilder->getQuery()->toIterable();
+        }
+
 
 Serving Files
 ~~~~~~~~~~~~~